Dxtra Tag Manager Platform¶
Dxtra Tag Manager is a tag management platform for deploying and managing tracking scripts, analytics, and marketing tags on your website. It includes built-in privacy-first analytics with cookie-free tracking.
Core Concepts¶
Tag Manager uses an event-driven rule engine. When something happens on a page (an event), rules evaluate conditions to determine which actions to execute.
Tags¶
Tags are containers for rules. Each tag can contain multiple rule groups and is either:
- Head Tag: Loads in the
<head>section of the page - Placement Tag: Loads at a specific location on the page using a
<div>element
Rule Groups and Rules¶
Rule groups organize rules within a tag. Each rule follows this logic:
IF (Events match)
AND (Conditions are true)
AND NOT (Exceptions are true)
THEN (Execute Actions)
Events¶
Events detect when something happens on the page. Built-in event types:
| Event | Description |
|---|---|
| Page Ready | DOM is ready |
| Page Loaded | Page fully loaded |
| Page In Focus | Tab gains focus |
| Page Blur | Tab loses focus |
| History Change | URL changes (SPA navigation) |
| Click Elements | Element is clicked (CSS selector) |
| Form Submit | Form is submitted (CSS selector) |
| Element In View | Element enters viewport |
| Tag In View | Placement tag becomes visible |
| Tag Click | Placement tag is clicked |
| Tag Timer | Timed trigger after tag loads |
| JS Error | JavaScript error occurs |
| CMP Check | Consent management platform check |
| Element Attribute Match | Element attribute matches value |
Actions¶
Actions execute when a rule's conditions are met. Built-in action types:
| Action | Description |
|---|---|
| Track Event | Send event to built-in analytics |
| Action Log | Log action for debugging |
| Set App State Variable | Set a value in app state |
| Increment App State Variable | Increment a counter in app state |
| Inject Script | Add a script to the page |
| Create Hidden Frame | Load content in a hidden iframe |
| Fire Pixel | Send a tracking pixel request |
| Load JS | Load an external JavaScript file |
| Load JS Direct | Execute inline JavaScript |
| Load HTML | Inject HTML into the page |
| Data Manager | Manage data container values |
Action Groups¶
Action groups organize actions within a rule and support distribution for A/B testing. Distribution types:
| Type | Behavior |
|---|---|
| None | All action groups execute |
| Session | One action group selected per session |
| Page Load | One action group selected per page load |
Conditions¶
Conditions evaluate data from data containers. Supported operators:
| Operator | Description |
|---|---|
| Equal | Exact match |
| Not Equal | Does not match |
| Contains | Contains substring |
| Begins With | Starts with string |
| Ends With | Ends with string |
| Regular Expression | Regex pattern match |
| Greater Than | Numeric comparison |
| Greater Than Equal | Numeric comparison |
| Less Than | Numeric comparison |
| Less Than Equal | Numeric comparison |
| Is Defined | Value exists |
| Is Not Defined | Value does not exist |
Data Containers¶
Data containers provide values for conditions and action variables:
| Container | Description |
|---|---|
| Environment | Environment-specific variables |
| App State | Runtime state variables |
| Custom | Custom key-value data |
| Local Storage | Browser local storage values |
| Query String | URL query parameters |
| Browser | Browser and device information |
| Element Click | Clicked element data |
| Browser Error | JavaScript error data |
Built-in Analytics¶
Tag Manager includes privacy-first analytics that work without cookies:
- Cookie-free tracking: No persistent cookies or cross-device tracking
- Session hashing: Privacy-preserving 24-hour session identification
- Real-time data: Live visitor tracking with 60-second aggregation delay
- Sub-5KB script: Lightweight analytics-only option
Install analytics only:
Install full Tag Manager (includes analytics):
Custom Domains¶
Configure a custom domain for your Tag Manager installation by creating a CNAME record pointing to tagmanager-edge.dxtra.ai. SSL certificates are provisioned automatically via Let's Encrypt.
Global Components¶
- Global Triggers: Reusable event and condition combinations shared across rules
- Global Actions: Reusable action groups shared across rules
Environments¶
Each application supports multiple environments (Development, Staging, Production) with separate configurations, variables, and deployment controls.
Revision Control¶
Changes are managed through revisions:
- Draft: Edit configuration freely
- Finalize: Lock the revision (immutable)
- Deploy: Push to an environment
Debug Mode¶
Enable debug mode by adding #dxtra-debug to any page URL. This requires a Dxtra account login and displays an overlay showing tag status, rule evaluation, events, data containers, and console output.
Related Documentation¶
- Installation -- Install Tag Manager on your site
- Creating an Application -- Set up your first application
- Tags -- Create and manage tags
- Events -- Configure event triggers
- Rules -- Build rule logic
- Actions -- Configure action execution