Tag Manager Integration Guide¶

Dxtra Tag Manager provides privacy-first analytics and tag management, enabling you to collect user behavior data while maintaining GDPR, CCPA, and PECR compliance.

Overview¶

The Dxtra Tag Manager is an event-driven, rule-based tag management system with built-in consent enforcement. It supports cookie-less tracking, server-side processing, and A/B testing through action group distributions.

Key Features¶

• Privacy-first analytics -- Cookie-less tracking that respects consent preferences
• Server-side processing -- Enhanced security through edge computing
• Consent integration -- Real-time consent enforcement across all tags
• A/B testing -- Action group distributions for experimentation
• Multi-environment support -- Separate development, staging, and production environments
• Revision control -- Full version history for all configurations
• Privacy signal detection -- GPC (Global Privacy Control) and DNT (Do Not Track) support

Getting Started¶

Step 1: Create an Application¶

1. Navigate to Processors > Tag Manager in the Dxtra dashboard
2. Click Create New Application
3. Configure application settings:
   • Name
   • Domain
   • Application type (Web)

Step 2: Install the Tag Manager¶

Add the Tag Manager script to your website. The installation code is provided in the Dxtra dashboard after creating your application.

Step 3: Configure Tags¶

Tags are containers for rule groups that define tracking and marketing logic.

Head Tags:

• No visible container on the page
• Auto-loaded with the Tag Manager
• Used for analytics and tracking scripts

Placement Tags:

• Visible container with specific dimensions (width/height)
• Positioned in designated areas of your page
• Used for ad units or embedded widgets

For placement tags, add a container element to your HTML:

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

Rule Groups and Actions¶

Rule Group Structure¶

Rule groups define the logic flow for tag execution. Each rule group contains:

• Conditions -- When the rule should fire (page URL, user properties, consent status)
• Actions -- What happens when conditions are met (fire tracking event, load script, etc.)
• Priority -- Execution order when multiple rule groups match

Action Types¶

• Analytics actions -- Page view tracking, event tracking, custom metrics
• Marketing actions -- Pixel firing, audience building, campaign tracking
• Custom actions -- JavaScript execution, API calls, data transformation

Action Group Distributions (A/B Testing)¶

Create distributed action groups to split traffic between variants:

1. Navigate to your tag's rule group
2. Create an action group with distribution percentages
3. Assign different actions to each variant
4. Monitor results in the Tag Manager analytics dashboard

Consent Integration¶

The Tag Manager automatically enforces consent preferences set through the Transparency Center widget or your consent management configuration.

Consent Categories¶

Tags are mapped to consent categories:

• Strictly Necessary -- Always active, cannot be disabled
• Analytics / Performance -- Requires analytics consent
• Marketing / Advertising -- Requires marketing consent
• Functional -- Requires functional consent

Privacy Signal Detection¶

The Tag Manager automatically detects and respects:

• Global Privacy Control (GPC) -- Browser-level opt-out signal
• Do Not Track (DNT) -- Legacy privacy signal

When privacy signals are detected, non-essential tags are automatically disabled.

See Tag Manager Consent Integration for detailed configuration.

Environments and Deployment¶

Environment Management¶

The Tag Manager supports separate environments:

• Development -- Testing new tags and rules with debug mode enabled
• Staging -- Pre-production testing with production-like configuration
• Production -- Live website tracking with optimized performance

Revision Control¶

All Tag Manager configurations are version-controlled:

1. Create a new revision
2. Make changes to tags, rules, or actions
3. Test in preview mode
4. Deploy to the target environment
5. Roll back to a previous revision if needed

Debugging¶

Debug and preview your Tag Manager configuration:

1. In the Dxtra dashboard, navigate to your Tag Manager application
2. Select the revision you want to test
3. Enable Preview Mode to test changes on your site before publishing
4. Use browser developer tools to inspect tag firing and event data

Troubleshooting¶

Tags Not Firing¶

1. Check that the user has given consent for the tag's consent category
2. Verify rule group conditions match the current page
3. Review the Tag Manager debug console in browser developer tools
4. Test in preview mode to isolate the issue

Performance Issues¶

1. Reduce the number of active tags
2. Optimize rule group conditions to avoid unnecessary evaluation
3. Use head tags with appropriate loading priority
4. Enable caching in production environments

Consent Conflicts¶

1. Verify consent integration with the Transparency Center widget
2. Check GPC and DNT signal handling
3. Review consent category mappings for each tag
4. Test the consent flow end-to-end

Related Documentation¶

• Tag Manager Overview -- Complete Tag Manager documentation
• Consent Integration -- Consent-controlled tracking
• Widget Embedding -- Transparency Center widget setup
• Integration Overview -- All platform integrations

For support, contact support@dxtra.ai with "Tag Manager" in the subject line.