Documentation

Installation

Installing PixelMate Pro takes less than a minute. Follow the steps below to get started.

1. Download the pixelmate-pro.zip file from your account dashboard.
2. In your WordPress admin, go to Plugins → Add New → Upload Plugin.
3. Choose the zip file and click Install Now.
4. Click Activate once installation completes.
5. You'll see a new PixelMate Pro menu item in your WordPress sidebar.

Quick Setup

After activation, the setup wizard will guide you through the initial configuration:

1. Navigate to PixelMate Pro → Dashboard.
2. Click Run Setup Wizard.
3. Select which platforms you want to enable.
4. Enter your Pixel IDs from each platform.
5. Choose your default events (PageView recommended for all platforms).
6. Save and start tracking.

Meta Pixel Setup

Connect Meta (Facebook, Instagram, Threads) tracking in three simple steps:

1. Go to PixelMate Pro → Platforms → Meta.
2. Enter your Meta Pixel ID (found in Meta Events Manager).
3. Optionally, enter your Conversions API Token for server-side tracking.

Available Meta Events:

• PageView — Tracks every page visit
• ViewContent — Product or content views
• AddToCart — Items added to cart
• InitiateCheckout — Checkout started
• Purchase — Completed purchases
• Lead — Form submissions and leads
• Custom — Any custom event name

Enable Enhanced Matching to send hashed user data (email, phone, name) for better attribution.

TikTok Pixel Setup

Integrate TikTok tracking for your viral campaigns:

1. Go to PixelMate Pro → Platforms → TikTok.
2. Enter your TikTok Pixel ID from TikTok Events Manager.
3. Configure which standard events to track.

Available TikTok Events:

• ViewContent — Content or product viewed
• AddToCart — Added item to cart
• Checkout — Initiated checkout
• Purchase — Completed purchase
• CompletePayment — Payment completed
• SubmitForm — Form submitted
• ClickButton — Button clicked
• Custom — Custom event names

Google Tag Manager

PixelMate Pro automatically pushes events to the GTM dataLayer:

1. Go to PixelMate Pro → Platforms → Google Tag Manager.
2. Enter your GTM Container ID (e.g., GTM-XXXXXXX).
3. Configure which events push to the dataLayer.

DataLayer format:

{
  event: 'pixelmate_event',
  pixelmate: {
    platform: 'meta' | 'tiktok' | 'custom',
    eventName: 'Purchase',
    eventData: { value: 49.99, currency: 'USD' }
  }
}

Create GTM triggers using the pixelmate_event custom event and map variables to your tags.

Custom Events System

Define unlimited custom events with dynamic data:

1. Go to PixelMate Pro → Custom Events → Add New.
2. Give your event a name (e.g., "Newsletter Signup").
3. Select the trigger type:
   • Click — Target a CSS selector
   • Form Submit — Form submission events
   • Scroll Depth — 25%, 50%, 75%, 100%
   • Time on Page — After X seconds
   • Element Visible — When element enters viewport
4. Add dynamic parameters using curly brace syntax: {post_id}, {user_email}, {cart_total}.
5. Select which platforms receive this event.
6. Save and activate.

Conditional Logic

Control pixel firing with precise conditions:

• Page Rules: Homepage, specific pages, posts, categories, tags, custom post types
• User Rules: Logged in/out, specific roles, user capabilities
• Device Rules: Desktop, tablet, mobile
• Geolocation: Include/exclude by country (uses MaxMind GeoIP)
• Schedule: Fire pixels only during specific dates or times

Combine conditions with AND/OR logic for complex rules.

Troubleshooting

Pixels aren't firing

1. Enable Debug Mode in PixelMate Pro → Settings → Debug.
2. Open your browser console (F12) and check for errors.
3. Verify your Pixel IDs are correct.
4. Check that your theme isn't blocking scripts (try a default WP theme).

Server-side events not sending

1. Verify your CAPI token is valid in Meta Events Manager.
2. Check your server's outgoing HTTP connections are allowed.
3. Review the event log in PixelMate Pro → Logs.

Still stuck?

Reach out to our support team via the Contact page with your debug log and we'll help you out.