Operator guideEN

Auto Tags Manager / Create

Full rule-builder for a new automatic tagging rule, including priority, tag actions, coupon actions, KPI field selection, and draft impact estimation.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this form does

Use this form to create a new automatic tagging rule. Operators define the rule identity, priority, active and valid flags, choose how tags or coupon codes should change, and select the KPI fields that decide whether a user belongs to the rule target.

Main sections

  • rule identity and status flags
  • priority
  • tag add or remove actions
  • include and exclude filter tags
  • coupon code changes
  • selected KPI fields
  • dynamic KPI filter controls generated from source config
  • draft impact estimate result

What operators should watch closely

  • The form does not show every KPI field by default. Operators first choose KPI fields, then the screen renders the relevant controls.
  • Dynamic KPI filters can be numeric ranges, date ranges, booleans, or text arrays.
  • Estimate Impact on this form uses the current unsaved payload and does not require the rule to exist yet.
  • Priority must be an integer from 0 to 100. Higher-priority rules sort before lower-priority rules in the manager list.
  • Saving priority can also update queued jobs that are still pending, paused, or retrying. Active force-run jobs can preserve a higher forced priority.
  • Include Tags narrow the audience first. Exclude Tags then remove users from that narrowed audience.
  • Tag and coupon array fields add one value at a time. The input strips commas and does not add duplicates.
  • A successful save shows a success toast and uses browser back navigation. The Back to List button explicitly returns to the manager list without saving.

Known caveats

  • The source-generated KPI config is the source of truth for which filter fields are available.
  • Played Game Categories is still present in the form code, but the section is hidden on the verified create surface.
  • Saving a new rule still uses the same save flow as editing; the difference is that the create payload keeps autoTagRuleId at 0.
  • The create page shows a plain Loading... state while KPI config is loading. Config-load failure is logged in the browser console; the verified page does not render a dedicated operator-facing config error.
  • The form does not define a page-side validation schema. Source validation is the final guard for required Rule Name and priority range.
  • The Save Rule button has a saving label tied to form submit state, but the verified submit wrapper does not return the async save promise. Treat source response and toast result as the reliable confirmation, not the transient button label.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Calculations12 topicsOpen details

Create initial values

A new rule starts active and valid by default, but it has no targeting or action values until the operator enters them.

Inputs
no existing rule data, source KPI config
Formula
The create form initializes autoTagRuleId to 0, ruleName to an empty string, active and isValid to true, priority to 0, arrays to empty lists, and selected KPI fields to an empty list.

KPI config generation

The fields available in Select KPI Fields come from source KPI summary metadata, not a hardcoded page list.

Inputs
UserKpiSummary raw attributes, source excluded field list
Formula
The source excludes identity and metadata fields, then maps KPI column data types to range, dateRange, text, boolean, or unknown control types.

Selected KPI field order

The filter controls move as operators select fields; this is a page ordering rule, not source priority.

Inputs
available KPI field list, selected KPI field list
Formula
The selector sorts all available KPI fields alphabetically. In the dynamic filter area, selected fields are shown before unselected fields, and later-selected fields are placed earlier among selected controls.

Dynamic config payload

The saved config object contains only the source-style keys produced by the currently selected KPI filters.

Inputs
selected KPI fields, source field type config, visible dynamic filter values
Formula
Range fields write min_ and max_ keys; dateRange fields write mode plus either exact from/to dates or relative-minute period keys; text fields write string arrays; boolean fields write true, false, or an empty Any value; selector fields write selected values.

Save Rule payload

Save Rule persists the full draft as a new auto-tag rule.

Inputs
rule information fields, tag and coupon arrays, hidden played-game categories value, selected KPI fields, dynamic config payload
Formula
The page sends autoTagRuleId 0, ruleName, active, isValid, priority, tag arrays, coupon arrays, playedGameCategories, selectedKpiFields, and config to the shared save flow.

Repeatable array inputs

Add tag, remove tag, include tag, exclude tag, coupon code, and text KPI arrays must be entered one value at a time.

Inputs
typed tag or coupon value, existing field array values
Formula
The repeatable field component strips commas from typed input, trims the value when adding, ignores empty values, and does not add a value that is already present in the current array.

Source create rule

Create mode is determined by the missing or zero rule id, even though create and edit share one save endpoint.

Inputs
create save payload, existing rule lookup by autoTagRuleId
Formula
The source creates a new AutoTagsManager record when autoTagRuleId does not resolve to an existing rule; otherwise the same service updates the existing rule. After save, the source can sync changed priority to queued jobs in pending, paused, or retrying states, except active force-run jobs that preserve a higher priority.

Priority validation

Use whole numbers from 0 to 100 only.

Inputs
priority value
Formula
The page constrains the input to min 0, max 100, step 1. The source rejects supplied priority values that are not integers from 0 to 100.

Draft impact estimate

The estimate is a confidence check for the current draft, not a stored rule run; it can preview an unsaved rule payload.

Inputs
current unsaved rule payload, source estimate-preview flow
Formula
Estimate Impact sends the current unsaved payload to estimate-preview; the source normalizes the draft as an override rule and returns an estimated affected-user count without saving the rule or requiring a persisted active and valid rule row.

Users Affected chip

The chip shows the latest estimate in the current browser session.

Inputs
estimate response count
Formula
The page reads count from response data, queue data, or root response count, converts it to a number, and shows Users Affected only after a successful estimate.

Create navigation

Leaving manually always goes to the list; successful save follows browser history.

Inputs
Back to List click, Save Rule success
Formula
Back to List routes directly to /auto-tags-manager. Save success calls browser back after the backend request succeeds.

Save button in-flight state

Treat toast result and navigation as the reliable save confirmation.

Inputs
form submit state, async save wrapper
Formula
The button label can switch to Saving through form submit state, but the verified submit wrapper does not return the async save promise as a durable in-flight lock.
Fields33 topicsOpen details

Loading...

Plain loading text shown until backend KPI config is available.

Group
page-state
Data Type
loading-state
Editable
false
Caveats
The verified page does not show a dedicated config-load error message.

Create Auto Tag Rule

Identifies that this form creates a new automatic tag rule.

Group
page-header
Data Type
text
Editable
false

Rule Information

Groups the rule identity, priority, and status flags.

Group
rule-information
Data Type
section
Editable
false

Rule Name

Human-readable rule name used in the manager list, queue messages, and audit descriptions.

Group
rule-information
Data Type
string
Editable
true

Priority

Numeric priority used to order rules ahead of lower-priority rules.

Group
rule-information
Data Type
integer
Editable
true
Allowed Range
Min: 0 | Max: 100 | Step: 1
Default Value
0

Active

Controls whether the saved rule is considered active for execution.

Group
rule-information
Data Type
boolean
Editable
true
Default Value
true

Is Valid

Controls whether the saved rule is considered valid in manager list and run workflows.

Group
rule-information
Data Type
boolean
Editable
true
Default Value
true

Tags

Groups tag changes applied when a user matches the rule.

Group
tag-actions
Data Type
section
Editable
false

Add Tags

Tags to add to matched users when the rule executes.

Group
tag-actions
Data Type
string-list
Editable
true
Caveats
Values are added one at a time; commas are stripped and duplicate values are ignored by the field component.

Remove Tags

Tags to remove from matched users when the rule executes.

Group
tag-actions
Data Type
string-list
Editable
true
Caveats
Values are added one at a time; commas are stripped and duplicate values are ignored by the field component.

Filter Tags

Groups tag-based audience filters used before rule actions are applied.

Group
filter-tags
Data Type
section
Editable
false

How Filter Tags Work

Explains that include tags narrow the audience first and exclude tags remove users from that audience.

Group
filter-tags
Data Type
helper-copy
Editable
false

Include Tags

Rule will only apply to users who have at least one listed include tag.

Group
filter-tags
Data Type
string-list
Editable
true
Caveats
Values are added one at a time; commas are stripped and duplicate values are ignored by the field component.

Exclude Tags

Users with any listed exclude tag are ignored by the rule.

Group
filter-tags
Data Type
string-list
Editable
true
Caveats
Values are added one at a time; commas are stripped and duplicate values are ignored by the field component.

Coupon Codes

Groups coupon-code changes applied when a user matches the rule.

Group
coupon-actions
Data Type
section
Editable
false

Add Coupon Codes

Coupon codes to grant to matched users when the rule executes.

Group
coupon-actions
Data Type
string-list
Editable
true
Caveats
Values are added one at a time; commas are stripped and duplicate values are ignored by the field component.

Remove Coupon Codes

Coupon codes to remove from matched users when the rule executes.

Group
coupon-actions
Data Type
string-list
Editable
true
Caveats
Values are added one at a time; commas are stripped and duplicate values are ignored by the field component.

Played Game Categories

Hidden field retained in the form payload model but not visible to normal operators on the create surface.

Group
hidden-game-categories
Data Type
string-list
Editable
false
Caveats
The field is inside a hidden section in the verified create form.

Choose Which KPI Fields to Filter On

Explains that the operator must choose KPI fields before matching dynamic filters appear.

Group
kpi-selection
Data Type
section
Editable
false

Select KPI Fields

Chooses which backend-generated KPI fields should become active filters on the form.

Group
kpi-selection
Data Type
string-list
Editable
true
Caveats
Available options are generated from backend KPI summary fields and sorted alphabetically by the frontend.

User KPI Filters

Contains controls rendered only for the selected KPI fields.

Group
kpi-selection
Data Type
section
Editable
false

User KPI Filters

Dynamic filter payload built from selected KPI fields and their backend-generated field types.

Group
kpi-selection
Data Type
json-object
Editable
true
Caveats
Field types come from backend-generated config, not from a hardcoded frontend list.

Min / Max KPI filters

Numeric KPI filters where operators can set lower and upper bounds.

Group
kpi-selection
Data Type
numeric-range
Editable
true

Specific Dates / Relative Period

Date KPI filters that can use exact dates or relative minute windows.

Group
kpi-selection
Data Type
structured-date-range
Editable
true

Country, Currency, Top Game, Top Provider, Language

Special multi-select controls shown only when those KPI fields are selected.

Group
kpi-selection
Data Type
selector-list
Editable
true

Text KPI filters

Text KPI filters rendered as repeatable string arrays.

Group
kpi-selection
Data Type
string-list
Editable
true
Caveats
Values are added one at a time; commas are stripped and duplicate values are ignored by the field component.

Any / True / False

Boolean KPI filters where empty means Any, otherwise True or False.

Group
kpi-selection
Data Type
boolean-filter
Editable
true

Back to List

Leaves the create form and returns to the manager list without saving.

Group
action-bar
Data Type
action
Editable
true

Users Affected

Shows the latest successful estimate count for the current unsaved draft.

Group
action-bar
Data Type
estimate-result
Editable
false

Estimate Impact

Runs a backend estimate for the current unsaved draft without saving it.

Group
action-bar
Data Type
action
Editable
true

Estimating...

Button text shown while estimate-preview request is running.

Group
action-bar
Data Type
loading-state
Editable
false

Save Rule

Persists the new auto-tag rule.

Group
action-bar
Data Type
action
Editable
true

Saving...

Button text intended for the form submitting state.

Group
action-bar
Data Type
loading-state
Editable
false
Caveats
The verified submit wrapper does not return the async save promise, so operators should rely on toast result and navigation rather than this label as a durable in-flight lock.
More help

Related pages

Auto Tags Manager

Operator documentation for automatic tag rules, including list monitoring, create or edit, queued job control, and manual rule ordering.

Auto Tags Manager / Detail

Edit surface for one existing auto-tag rule, using the same dynamic rule builder as create but with a persisted rule payload and ID-backed updates.

Auto Tags Manager / List

Rule inventory with search, direct navigation to create or reorder, row-level run controls, and job history or recovery actions.

Auto Tags Manager / Order

Manual drag-and-drop ordering screen for valid auto-tag rules, with a single save action that rewrites sort positions.

Activity Tag Rules / Create

Create flow for a new activity tag rule, including optional clone-from-existing behavior, transaction condition testing, and one-or-two-rule save behavior.

Affiliate Deals / Form

Create and edit form for affiliate deals, including PID, date window, commercial terms, and responsible person.