TrueTracked

Documentation

Setup guides and reference documentation to help you get the most from TrueTracked.

Meta (CAPI) Setup

Connect your Meta Pixel to TrueSignal to send server-side conversion events via the Meta Conversions API (CAPI). This improves event match quality, provides more reliable data, and helps overcome browser-side tracking limitations.

Prerequisites:

  • A Meta Business account with an active Pixel
  • Your Pixel ID (found in Meta Events Manager)
  • A Conversions API Access Token (generated in Events Manager > Settings)
  • TrueTracked pixel installed on your site

Step 1: Get Your Meta Pixel ID

  1. Go to Meta Events Manager at business.facebook.com/events_manager
  2. Select your Pixel from the left sidebar
  3. Your Pixel ID is the number shown under the pixel name (e.g., 123456789012345)

Step 2: Generate a Conversions API Access Token

  1. In Events Manager, click on your Pixel
  2. Go to Settings
  3. Scroll to the Conversions API section
  4. Under "Set up manually", click Generate access token
  5. Copy the token — you'll need it in the next step

Important: Store your access token securely. It provides write access to your pixel data. TrueTracked encrypts and stores this token on our servers — it is never exposed to your frontend.

Step 3: Connect in TrueTracked

  1. Go to Settings > TrueSignal in your TrueTracked dashboard
  2. Click Connect on the Meta card
  3. Enter your Pixel ID
  4. Enter your Conversions API Access Token
  5. Optionally enter a Test Event Code to verify events in Events Manager before going live
  6. Optionally give the connection a Name (useful if you have multiple pixels)
  7. Click Connect

Step 4: Verify Events

  1. If you entered a Test Event Code, go to Events Manager > Test Events to see incoming server events in real-time
  2. Trigger a test purchase on your site
  3. Check that the event appears with Server as the processing method
  4. Once verified, you can remove the Test Event Code and toggle off Test Mode

Events Sent

TrueSignal sends the following events to Meta via CAPI:

  • Purchase — When an order is completed, including order value, currency, and product data
  • PageView — Page view events with user and session data
  • AddToCart — Cart addition events with product details
  • InitiateCheckout — Checkout initiation events

Each event includes enriched user data (hashed email, phone, IP address, user agent, click ID) to maximize Meta's Event Match Quality score.

Troubleshooting

  • Events not appearing in Events Manager: Check that your Pixel ID and Access Token are correct. Enable Test Mode and use a Test Event Code to debug.
  • Low Event Match Quality: Ensure your TrueTracked pixel is properly installed. The more user data captured (email at checkout, click IDs from ad clicks), the better the match quality.
  • Duplicate events: If you're also sending CAPI events through another integration, you may see duplicates. Use TrueSignal as your sole server-side sender for each pixel to avoid this.