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
- Go to Meta Events Manager at
business.facebook.com/events_manager - Select your Pixel from the left sidebar
- Your Pixel ID is the number shown under the pixel name (e.g.,
123456789012345)
Step 2: Generate a Conversions API Access Token
- In Events Manager, click on your Pixel
- Go to Settings
- Scroll to the Conversions API section
- Under "Set up manually", click Generate access token
- 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
- Go to Settings > TrueSignal in your TrueTracked dashboard
- Click Connect on the Meta card
- Enter your Pixel ID
- Enter your Conversions API Access Token
- Optionally enter a Test Event Code to verify events in Events Manager before going live
- Optionally give the connection a Name (useful if you have multiple pixels)
- Click Connect
Step 4: Verify Events
- If you entered a Test Event Code, go to Events Manager > Test Events to see incoming server events in real-time
- Trigger a test purchase on your site
- Check that the event appears with Server as the processing method
- 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.