Operator guideENauto-tagscreateform

Auto Tags Manager / Create

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

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this form does

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

Main sections

  • rule identity and status flags
  • tag add or remove actions
  • include and exclude filter tags
  • coupon code changes
  • selected KPI fields
  • dynamic KPI filter controls generated from backend config

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.

Known caveats

  • The backend-generated KPI config is the source of truth for which filter fields are available.
  • Played Game Categories is still present in the FE form code but hidden from normal operator use on this surface.
  • Saving a new rule still uses the same backend endpoint as editing; the difference is that the create payload keeps autoTagRuleId at 0.
Field dictionary

Fields

field

Rule Name

Human-readable name used to identify the rule in the list and queue messages.

Group
rule-information
Data Type
string
field

Active

Controls whether the rule can be executed from the list.

Group
rule-information
Data Type
boolean
field

Is Valid

Marks whether the rule should be considered valid for execution.

Group
rule-information
Data Type
boolean
field

Add Tags

Tags that should be attached to matched users after the rule runs.

Group
tag-actions
Data Type
string-list
field

Remove Tags

Tags that should be removed from matched users after the rule runs.

Group
tag-actions
Data Type
string-list
field

Include Tags

The rule only considers users who already have at least one of these tags.

Group
filter-tags
Data Type
string-list
field

Exclude Tags

The rule skips users who have any of these tags.

Group
filter-tags
Data Type
string-list
field

Add Coupon Codes

Coupon codes granted when a user matches the rule.

Group
coupon-actions
Data Type
string-list
field

Remove Coupon Codes

Coupon codes removed when a user matches the rule.

Group
coupon-actions
Data Type
string-list
field

Select KPI Fields

Chooses which KPI fields should appear as active filters on the form.

Group
kpi-selection
Data Type
string-list
field

User KPI Filters

Dynamic filter payload built from the selected KPI fields.

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

Country, Currency, Top Game, Top Provider, Language

Special selector controls shown only when those KPI fields were selected.

Group
kpi-selection
Data Type
selector-list
field

Date Range Filters

Date-based KPI filters that can use exact dates or relative-minute periods.

Group
kpi-selection
Data Type
structured-range
Operational notes

Notes

item

Create and edit share the same FE form component and backend save endpoint.

item

The backend config is generated from `UserKpiSummary` raw attributes and determines the dynamic form field types.

Related references

Related pages

pageAuto Tags Manager

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

pageAuto 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.

pageAuto Tags Manager / List

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

pageAuto Tags Manager / Order

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

pageActivity Tag Rules / Create

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

pageAffiliate Deals / Form

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