Operator guideENauto-tagsrulessegmentationjobs

Auto Tags Manager

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

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 module is for

Use Auto Tags Manager to define automatic segmentation rules for CRM users. Operators come here to create a rule, choose which KPI fields should be checked, decide which tags or coupon codes should be added or removed, and control the execution queue when a rule is already running.

Main surfaces

  • Auto Tags Manager / List is the operational inventory for existing rules and job status.
  • Auto Tags Manager / Create is the full rule-builder for a new rule.
  • Auto Tags Manager / Detail is the edit workspace for an existing rule.
  • Auto Tags Manager / Reorder changes the execution or display order of valid rules.

What operators need to know first

  • This module is action-heavy. A rule can be saved, estimated, executed, cancelled, restarted, and reordered.
  • The create and detail screens use the same backend save endpoint. The difference is whether autoTagRuleId is 0 for a new rule or a real rule ID for an update.
  • KPI filters are not hardcoded in FE. The backend generates the available field list from UserKpiSummary, and the form renders only the KPI fields the operator selected.
  • Job controls on the list screen act on the execution queue, not on the rule definition itself.

Key workflow rules

Create or edit a rule

  • Operators choose the rule name, active and valid flags, tag changes, coupon code changes, and the KPI fields that should be used as filters.
  • After selecting KPI fields, the screen renders matching controls such as numeric ranges, date ranges, booleans, and text arrays.
  • Country, currency, language, top game, and top provider filters use selector controls when those KPI fields are selected.

Estimate before run

  • Estimate impact can be executed from the list or directly from the create or detail form.
  • The estimate does not persist rule changes when the operator is still editing a draft payload.
  • Estimate results are intended for operator confidence checks before queuing a real run.

Run and control jobs

  • Run queues a real execution job for the selected rule.
  • Cancel job and Restart job target a specific job record, not the rule definition.
  • If another active job blocks the rule, the backend rejects the action and returns an explicit message.

Reorder

  • Reorder saves one full ordered list of valid rules.
  • The backend normalizes the submitted order and rewrites sort for every valid rule in the payload.

Backend verification summary

The current verified backend ownership is gs-admin-backend:

  • GET /api/admin/auto-tag-manager-list
  • GET /api/admin/auto-tag-manager-config
  • POST /api/admin/save-auto-tag-manager
  • POST /api/admin/run-tag-rule
  • POST /api/admin/run-tag-rule/estimate
  • POST /api/admin/run-tag-rule/estimate-preview
  • GET /api/admin/auto-tag-manager-jobs
  • POST /api/admin/auto-tag-manager-jobs/:jobId/cancel
  • POST /api/admin/auto-tag-manager-jobs/:jobId/restart
  • PUT /api/admin/order-auto-tag-manager

No separate gs-casino-backend ownership was verified for the current operator surfaces. Queue execution is still routed through gs-admin-backend casino services and app/utils/tagManager.js.

Related references

Related pages

pageAuto Tags Manager / Create

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

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

Operator documentation for activity-driven tag automation rules, including list, create, edit, detail inspection, and recent application history.

pageActivity Tag Rules / Create

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