Skip to content
Last updated: 2026-04-06
Reference

Tags Management

Tags are the top-level containers in Dxtra Tag Manager. Each tag holds rule groups, which contain the rules that control when and how scripts execute on your pages.

Tag Types

Head Tags

Head tags load in the <head> section of the page. Use these for:

  • Analytics scripts (Google Analytics, Facebook Pixel)
  • Tracking pixels
  • Global JavaScript that needs to run on every page
  • Scripts that should load before page content renders

Placement Tags

Placement tags load at a specific location on the page. Use these for:

  • Promotional banners or content blocks
  • A/B test content variations
  • Dynamic content injection
  • Location-specific tracking

Add the placement element in your HTML:

HTML
<div data-dxtra="true" data-code="YOUR_TAG_CODE"></div>

Replace YOUR_TAG_CODE with the code shown in your tag's configuration.

Tag Settings

Setting Description
Name Descriptive name for the tag
Type Head or Placement
Tag Code Auto-generated identifier (placement tags)
Auto Load Whether the tag loads automatically (default: enabled)
Priority Load order (lower numbers load first)

Auto Load

When enabled (default), the tag loads automatically when the page loads. Disable auto load for tags that should only load programmatically or when triggered by specific conditions.

Priority

Priority controls the order tags load within the same type. Tags with lower priority values load first. Use this when one tag depends on another (e.g., a consent script should load before analytics tags).

Tag Structure

Each tag contains one or more rule groups:

Text Only
Tag
├── Rule Group 1
│   ├── Rule A
│   │   ├── Events
│   │   ├── Conditions
│   │   ├── Exceptions
│   │   └── Action Groups
│   │       ├── Action Group 1 (actions)
│   │       └── Action Group 2 (actions)
│   └── Rule B
│       └── ...
└── Rule Group 2
    └── ...

Creating a Tag

  1. Navigate to your application's Tags section
  2. Click Create Tag
  3. Select the tag type (Head or Placement)
  4. Enter a descriptive name
  5. Configure priority and auto load settings
  6. Save the tag
  7. Add rule groups and rules to define the tag's behavior

Managing Tags

Naming Conventions

Use descriptive names that indicate purpose:

  • GA4 - Page View Tracking
  • Facebook Pixel - Conversion Events
  • Banner - Homepage Promotion
  • A/B Test - Checkout Flow

Testing Tags

  1. Deploy your revision to a development environment
  2. Add #dxtra-debug to the page URL
  3. Check the debug overlay:
    • Green status = tag is active and loaded
    • Red status = tag failed to load or had errors
    • Grey status = tag conditions not met (not loaded)

Tag Checklist

  • Descriptive name identifying the tag's purpose
  • Correct tag type selected (Head or Placement)
  • Priority set appropriately relative to other tags
  • At least one rule group with configured rules
  • Events, conditions, and actions configured in rules
  • Tested in development environment with debug mode
  • Consent requirements configured if needed (CMP Check event)
  • Overview -- Tag Manager concepts
  • Rules -- Configure rule logic
  • Events -- Event types and configuration
  • Actions -- Action types and configuration
  • Debugging -- Debug mode and troubleshooting