Last updated: 2026-04-06

Reference

Creating Your First Application¶

An application in Dxtra Tag Manager represents a website or web application where you want to manage tags. Each application has its own tags, rules, environments, and analytics.

Create an Application¶

Log in to the Dxtra Tag Manager dashboard
Click Create Application
Enter the application name and primary domain
Save

After creation, the application includes a default environment ready for configuration.

Application Structure¶

Each application contains:

Text Only

Application
├── Tags
│   ├── Head Tags (load in <head>)
│   └── Placement Tags (load at specific page locations)
├── Global Triggers (reusable event/condition combinations)
├── Global Actions (reusable action groups)
├── Environments
│   ├── Development
│   ├── Staging
│   └── Production
└── Revisions (version-controlled configurations)

Set Up Your First Tag¶

Step 1: Create a Head Tag¶

Go to your application's Tags section
Click Create Tag
Choose Head as the tag type
Enter a name (e.g., "Analytics Setup")
Save

Step 2: Add a Rule Group¶

Open your new tag
Click Add Rule Group
Name it (e.g., "Page Tracking Rules")

Step 3: Create a Rule¶

Inside the rule group, click Add Rule
Name it (e.g., "Track All Page Views")

Step 4: Add an Event¶

In the rule, click Add Event
Select Page Loaded as the event type
This fires when the page finishes loading

Step 5: Add an Action¶

Click Add Action Group
Inside the action group, click Add Action
Select Track Event as the action type
Configure the event name (e.g., "page_view")

This sends a page view event to the built-in analytics on every page load.

Add a Placement Tag¶

Placement tags display content at specific locations on your page.

Step 1: Create the Tag¶

Click Create Tag
Choose Placement as the tag type
Enter a name and note the generated tag code

Step 2: Add the HTML Element¶

Add the placement element where you want the content to appear:

HTML

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

Step 3: Configure Rules¶

Add rules with events like Tag In View (fires when the placement is visible) or Tag Click (fires when the placement is clicked).

Configure Environments¶

Set Up Environment Variables¶

Go to Environments in your application
Select an environment (e.g., Production)
Add variables that can be referenced in actions using the template syntax:

Text Only

{{Environment.VARIABLE_NAME}}

Common environment variables:

Variable	Example Value	Purpose
`GA_TRACKING_ID`	`G-XXXXXXXXXX`	Google Analytics measurement ID
`FB_PIXEL_ID`	`123456789`	Facebook Pixel ID
`ANALYTICS_ENDPOINT`	Custom endpoint URL	Custom analytics destination

Deploy to an Environment¶

Go to your application's Revisions section
Click Finalize on the current draft revision
Click Deploy and select the target environment
The configuration is now live for that environment

Install the Script¶

Add the Tag Manager script to your website. See Installation for platform-specific instructions.