Pixel Manager Guide

Multi-Platform Advertising Pixel Management

Premium Feature | Plugin Version: 1.2+

What is Pixel Manager?

The Pixel Manager lets you fire advertising pixels from 6 different platforms directly from ADT, with automatic consent management and event mapping.

Supported Platforms

1. Meta (Facebook) – Facebook Ads, Instagram Ads
2. TikTok – TikTok Ads
3. Google Ads – Google advertising platform
4. LinkedIn – LinkedIn Ads with conversion tracking
5. X (Twitter) – X/Twitter Ads
6. Pinterest – Pinterest Ads

Why Use Pixel Manager?

Traditional Approach (GTM Only)

• ❌ Manual pixel setup in GTM for each platform
• ❌ Must create triggers for every event
• ❌ No automatic consent integration
• ❌ Complex event mapping
• ❌ Duplicate code management

With ADT Pixel Manager

• ✅ One-click pixel activation per platform
• ✅ Automatic consent integration – respects GDPR/CCPA
• ✅ Automatic event mapping – ADT events → Platform events
• ✅ Custom event mapping – control which events go where
• ✅ Dual dispatch mode – fire from GTM AND SDK simultaneously
• ✅ Single source of truth – all pixels managed in one place

Dispatch Modes

Pixel Manager has 3 dispatch modes:

Mode 1: Plugin Only (Recommended)

How it works:

• Pixels fire directly from ADT using platform SDKs
• No GTM involvement
• Fastest and most reliable

Best for:

• Maximum performance
• Direct pixel control
• Bypassing GTM complexity

Mode 2: GTM Only

How it works:

• Pixels only fire through your GTM container
• ADT pushes events to dataLayer
• GTM tags handle pixel firing

Best for:

• Non-technical users who prefer GTM UI
• Teams with existing GTM setups
• Centralized tag management

Mode 3: Dual Mode

How it works:

• Pixels fire from BOTH ADT and GTM
• Automatic deduplication
• Redundant tracking paths

Best for:

• Maximum reliability
• Transition periods
• Mission-critical tracking

Prerequisites

Before using Pixel Manager:

• ✅ ADT Premium License – Pixel Manager is premium only
• ✅ Pixel IDs – Have your pixel IDs ready from each platform
• ✅ Platform accounts – Active advertising accounts
• ✅ Client-side tracking – Set up standard ADT tracking first

Quick Setup (5 Minutes Per Platform)

Step 1: Enable Pixel Tracking

1. Go to WordPress Admin → ADT Settings
2. Click the Pixel Tracking tab
3. Check Enable Pixel Tracking
4. Select Dispatch Mode (recommend “Plugin Only”)
5. Save Settings

Step 2: Configure Individual Pixels

For each platform you want to use:

Meta (Facebook) Pixel

1. Get your Pixel ID from Meta Events Manager
2. In ADT Settings → Pixel Tracking:
   • Check Enable Meta Pixel
   • Enter your Meta Pixel ID
3. Save Settings

TikTok Pixel

1. Get your Pixel ID from TikTok Ads Manager
2. In ADT Settings → Pixel Tracking:
   • Check Enable TikTok Pixel
   • Enter your TikTok Pixel ID
3. Save Settings

Google Ads Tag

1. Get your Conversion ID from Google Ads
2. In ADT Settings → Pixel Tracking:
   • Check Enable Google Ads Tag
   • Enter your Google Ads Conversion ID
3. Save Settings

LinkedIn Insight Tag

1. Get your Partner ID from LinkedIn Campaign Manager
2. Get Conversion IDs for specific events (optional)
3. In ADT Settings → Pixel Tracking:
   • Check Enable LinkedIn Pixel
   • Enter your LinkedIn Partner ID
   • Enter Form Submit Conversion ID (optional)
   • Enter Purchase Conversion ID (optional)
4. Save Settings

X (Twitter) Pixel

1. Get your Pixel ID from X Ads Manager
2. In ADT Settings → Pixel Tracking:
   • Check Enable X (Twitter) Pixel
   • Enter your X Pixel ID
3. Save Settings

Pinterest Tag

1. Get your Tag ID from Pinterest Ads
2. In ADT Settings → Pixel Tracking:
   • Check Enable Pinterest Pixel
   • Enter your Pinterest Tag ID
3. Save Settings

Step 3: Verify Tracking

Each platform has browser extensions or debug tools:

• Meta: Meta Pixel Helper
• TikTok: TikTok Pixel Helper
• Google: Built into Google Ads
• LinkedIn: LinkedIn Insight Tag Helper
• X: Built into X Ads Manager
• Pinterest: Pinterest Tag Helper

Default Event Mapping

ADT automatically maps its events to platform-specific events:

Core Events

ADT Event	Meta	TikTok	Google	LinkedIn	X	Pinterest
page_view	PageView	–	page_view	–	PageView	pagevisit
form_submit	Lead	SubmitForm	generate_lead	✅	–	lead
sign_up	CompleteRegistration	–	sign_up	–	–	signup
search	Search	–	search	–	–	search

E-commerce Events

ADT Event	Meta	TikTok	Google	LinkedIn	X	Pinterest
view_item	ViewContent	ViewContent	view_item	–	–	pagevisit
add_to_cart	AddToCart	AddToCart	add_to_cart	–	–	addtocart
view_cart	–	–	view_cart	–	–	–
begin_checkout	InitiateCheckout	InitiateCheckout	begin_checkout	–	–	–
add_shipping_info	–	–	add_shipping_info	–	–	–
add_payment_info	–	–	add_payment_info	–	–	–
purchase	Purchase	CompletePayment	purchase	✅	–	checkout

Legend:

• ✅ = Uses conversion ID (must be configured)
• - = Not fired by default

Custom Event Mapping

Want to control exactly which events fire to which platforms?

How to Configure

1. Go to ADT Settings → Pixel Tracking
2. Scroll to Custom Event Mapping
3. Click Configure Event Mapping
4. Select which platforms should receive each event
5. Save Settings

JSON Configuration (Advanced)

You can also configure via JSON in the settings:

{
  "form_submit": ["meta", "linkedin"],
  "purchase": ["meta", "google", "tiktok"],
  "add_to_cart": ["meta", "google"],
  "page_view": ["meta"]
}

Format:

• Key = ADT event name
• Value = Array of platform codes

Platform Codes:

• meta = Meta/Facebook
• tiktok = TikTok
• google = Google Ads
• linkedin = LinkedIn
• x = X/Twitter
• pinterest = Pinterest

LinkedIn Conversion Tracking

LinkedIn requires Conversion IDs for specific events:

What are Conversion IDs?

LinkedIn conversion IDs are specific to each conversion action you want to track (e.g., form submission, purchase).

How to Get Conversion IDs

1. Go to LinkedIn Campaign Manager
2. Click Account Assets → Conversions
3. Click Create Conversion
4. Set up your conversion (name, type, value)
5. Copy the Conversion ID
6. Paste in ADT Settings under LinkedIn configuration

Supported Conversions

• Form Submit – Fires when form_submit event occurs
• Purchase – Fires when purchase event occurs

Without conversion IDs: Only the LinkedIn Insight Tag loads (for general tracking) With conversion IDs: Specific conversion events fire for optimization

Consent Management

Pixel Manager automatically respects consent:

How It Works

1. ADT detects your consent management platform (CMP)
2. Checks consent status for “marketing” category
3. Only fires pixels if marketing consent is granted
4. Queues events if consent not yet decided
5. Fires queued events when consent is granted

Supported CMPs

All CMPs supported by ADT Consent Manager:

• CookieYes
• Cookiebot
• OneTrust
• Complianz
• Borlabs Cookie
• Cookie Notice
• Termly
• IAB TCF 2.0

Manual Consent Check

You can also check consent manually:

// Check if marketing consent granted
if (window.hasConsent('marketing')) {
  // Pixels will fire
}

Event Data Enrichment

Pixel Manager automatically sends rich data with each event:

Standard Data (All Events)

• Event name
• Timestamp
• Page URL
• Referrer URL
• User agent

E-commerce Data

• Product IDs
• Product names
• Prices
• Quantities
• Categories
• Transaction values
• Currency

User Data (Hashed)

• Email (SHA-256 hash)
• IP address
• Client ID

Privacy Note: All PII is hashed before sending to comply with GDPR.

Troubleshooting

Pixels Not Firing

Problem: No pixel events in platform debug tools

Solutions:

1. ✅ Verify pixel is enabled in ADT Settings
2. ✅ Check pixel ID is correct
3. ✅ Ensure premium license is active
4. ✅ Check consent is granted (marketing category)
5. ✅ Verify dispatch mode matches your setup
6. ✅ Check browser console for errors

SDK Not Loading

Problem: Platform SDK (fbq, ttq, etc.) not found

Solutions:

1. Ensure dispatch mode is “Plugin Only” or “Dual Mode”
2. Check that pixel is enabled in settings
3. Verify pixel ID is saved correctly
4. Clear browser cache and reload
5. Check for script blockers or ad blockers
6. Wait 10 seconds after page load (SDKs load async)

Events Fire But Don’t Show in Platform

Problem: Events fire in browser but not in platform reporting

Solutions:

1. Wait 24-48 hours – Platform reporting has delays
2. Check real-time reports (if available)
3. Verify pixel ID matches your ad account
4. Ensure pixel is installed in platform settings
5. Check pixel status in platform (active/inactive)

Duplicate Events

Problem: Same event fires twice

Solutions:

1. Check dispatch mode – should not be “Dual Mode” unless intentional
2. Ensure GTM doesn’t have duplicate pixel tags
3. Check custom event mapping for duplicates
4. Verify only one instance of ADT is active

LinkedIn Conversions Not Tracking

Problem: LinkedIn Insight Tag loads but conversions don’t fire

Solutions:

1. Verify conversion IDs are entered in settings
2. Check conversion ID is for correct conversion action
3. Ensure conversion is active in LinkedIn Campaign Manager
4. Test with LinkedIn Tag Helper extension
5. Check that event name matches (form_submit or purchase)

Best Practices

1. Start with Plugin Only Mode

Why:

• Simplest setup
• Best performance
• Easiest to debug

When to switch:

• You need GTM’s advanced features
• Your team prefers GTM UI
• You have complex tag management needs

2. Test Each Platform Individually

Process:

1. Enable ONE pixel
2. Trigger an event
3. Verify in platform
4. Move to next pixel

Don’t:

• Enable all pixels at once
• Assume all work if one works

3. Use Browser Extensions

Install platform helper extensions:

• See events fire in real-time
• Verify event data
• Catch issues immediately

4. Configure LinkedIn Conversions

If using LinkedIn:

• Always set up conversion IDs
• Otherwise only pageview tracking works
• Conversions are what matter for optimization

5. Monitor Consent Rates

Check ADT Debug Overlay:

• What % of users grant marketing consent?
• Are pixels being blocked by consent?
• Adjust consent strategy if needed

6. Custom Event Mapping for Control

Don’t want all events on all platforms?

• Configure custom event mapping
• Only fire relevant events per platform
• Reduces noise in platform reporting

Advanced Features

Dispatch Mode Switching

Scenario: You want to migrate from GTM to Plugin Only

Steps:

1. Start with Dual Mode enabled
2. Verify both paths work (GTM + Plugin)
3. Monitor for 7 days
4. Switch to Plugin Only
5. Remove GTM pixel tags

Why Dual Mode First:

• Ensures no data loss during migration
• Provides fallback if issues arise
• Validates both systems work

Custom Event Firing

Fire custom events to pixels:

// Fire custom event to dataLayer
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  event: 'custom_conversion',
  conversion_value: 100,
  conversion_type: 'demo_request'
});

Pixel Manager will automatically route this to configured platforms.

Platform-Specific Data

Send different data to different platforms:

window.dataLayer.push({
  event: 'purchase',
  ecommerce: {
    value: 99.99,
    currency: 'USD'
  },
  // Meta-specific data
  meta_custom_data: {
    content_category: 'electronics'
  },
  // TikTok-specific data
  tiktok_custom_data: {
    shop_id: '12345'
  }
});

Performance Impact

Pixel Manager has minimal performance impact:

Page Load Time:

• Plugin Only: ~0.1s (SDKs load async)
• GTM Only: No additional impact
• Dual Mode: ~0.15s

Script Size:

• Pixel Manager: ~15KB gzipped
• Platform SDKs: 5-15KB each

Best Practices:

• Enable only platforms you’re actively using
• Use Plugin Only mode for best performance
• Avoid Dual Mode unless necessary

FAQ

Q: Can I use Pixel Manager without GTM? A: Yes! Set dispatch mode to “Plugin Only” and pixels fire directly.

Q: Will pixels fire if consent is denied? A: No. Pixel Manager respects consent. Marketing consent must be granted.

Q: Can I fire to some platforms but not others? A: Yes. Use custom event mapping to control which events go to which platforms.

Q: Do I need conversion IDs for all platforms? A: No, only LinkedIn requires conversion IDs. Other platforms use pixel IDs only.

Q: What happens if a platform SDK fails to load? A: Pixel Manager gracefully handles failures – other platforms continue working.

Q: Can I test pixels before going live? A: Yes! Use platform test modes:

• Meta: Use Test Events with test code
• Google: Use Preview mode
• TikTok: Use Test Events
• Others: Verify with browser extensions

Q: Does this work with WooCommerce? A: Yes! All WooCommerce e-commerce events are automatically tracked.

Q: How many platforms can I enable at once? A: All 6 simultaneously. No limit.

Q: What’s the difference between Pixel Manager and Server-Side Tracking? A:

• Pixel Manager: Client-side pixels (browser)
• Server-Side: Events sent from your server
• Best: Use both for maximum coverage

Q: Can I see which pixels fired in Debug Overlay? A: Yes! Enable Debug Overlay and check the Diagnostics tab for pixel status.

Platform-Specific Notes

Meta (Facebook)

Event Names: Auto-converted to Meta standard events

• form_submit → Lead
• add_to_cart → AddToCart
• purchase → Purchase

Advanced Matching: Automatically enabled (sends hashed email when available)

Best Practices:

• Use with Meta CAPI for server-side backup
• Enable dynamic ads with product catalog

TikTok

Event Names: Auto-converted to TikTok standard events

• form_submit → SubmitForm
• add_to_cart → AddToCart
• purchase → CompletePayment

Best Practices:

• Essential for TikTok shopping ads
• Combine with video content for best results

Google Ads

Integration: Works with Google Ads remarketing and conversion tracking

Best Practices:

• Use with GA4 for complete Google ecosystem
• Set up conversion values for ROAS optimization

LinkedIn

Conversion Tracking: Requires conversion IDs per action

Best Practices:

• Essential for B2B lead generation
• Use form submission tracking for lead ads
• Track demo requests and consultation bookings

X (Twitter)

Event Tracking: Custom events supported

Best Practices:

• Use for promoted tweets and campaigns
• Track engagement and conversion events

Pinterest

Shopping Support: Full e-commerce event tracking

Best Practices:

• Essential for Pinterest shopping ads
• Track product views and purchases
• Use product catalogs for dynamic ads

Support Resources

Debug Tools:

• ADT Debug Overlay (built-in)
• Platform browser extensions
• Browser console (F12)

Platform Documentation:

• Meta Pixel
• TikTok Pixel
• Google Ads Tag
• LinkedIn Insight Tag
• X Pixel
• Pinterest Tag

Need Help? Premium users can contact support for:

• Pixel configuration assistance
• Event mapping customization
• Troubleshooting tracking issues
• Platform-specific optimization

Quick Start Summary

5-Minute Setup Per Platform

1. Get Pixel ID from platform
2. Enable pixel in ADT Settings
3. Enter Pixel ID
4. Save Settings
5. Test with browser extension
6. Verify in platform reporting

Complete Setup (All Platforms)

1. Enable Pixel Tracking
2. Select Dispatch Mode (Plugin Only)
3. Configure each platform’s pixel
4. Set up custom event mapping (optional)
5. Configure LinkedIn conversion IDs (if using LinkedIn)
6. Test with browser extensions
7. Monitor in platform reporting (24-48 hours)

Total Time: ~30 minutes for all 6 platforms

Last Updated: 2025
Plugin Version: 1.2+
Premium Feature