Facebook Conversions API (CAPI) Setup

This guide explains how to set up Facebook Conversions API for enhanced, server-side tracking.

What is Conversions API?

Facebook Conversions API (CAPI) is a server-side tracking method that sends events directly from your server to Facebook, rather than relying solely on browser-based pixel tracking.

Benefits of CAPI

• Better data accuracy: Not affected by ad blockers or browser restrictions
• More reliable tracking: Works even when cookies are blocked
• Improved attribution: Better connection between ads and conversions
• Future-proof: Works with privacy-first browsing changes
• Enhanced matching: Better customer matching for optimization

Prerequisites

Before setting up CAPI, you need:

1. A Facebook Business account
2. A Facebook Pixel already configured
3. CAPI Access Token from Facebook Events Manager
4. Facebook account connected in Pixee app

Getting Your CAPI Access Token

Step 1: Go to Events Manager

1. Visit Facebook Events Manager
2. Select your pixel from the Data Sources menu

Step 2: Generate Access Token

1. Click on Settings tab
2. Scroll to “Conversions API” section
3. Click Generate access token
4. Copy the generated token (it is only shown once)

Important: Keep your access token secure. Do not share it publicly.

Enabling CAPI in Pixee

Step 1: Connect Your Facebook Account

1. Go to Settings in the Pixee app
2. Under “Login with Facebook”, click Login with Facebook
3. Authorize the required permissions
4. Your account is now connected

Step 2: Enable CAPI on Your Pixel

1. Go to the Dashboard
2. Find your Facebook pixel in the list
3. Click Edit on the pixel
4. Toggle on “Enable Conversions API”
5. Enter your Access Token
6. Click Save

Step 3: Verify CAPI Status

1. Check the pixel list on the Dashboard
2. The “CAPI Status” column should show “Enabled”
3. Your pixel now sends events via both browser and server

Events Sent via CAPI

When CAPI is enabled, these events are sent server-side:

Deduplication

When using both browser pixel and CAPI, events might be sent twice. Pixee handles deduplication automatically:

• Each event is assigned a unique event ID
• Facebook uses this ID to deduplicate events
• You will only see one event per action in Events Manager

Testing CAPI

Using Events Manager Test Events

1. Go to Facebook Events Manager
2. Select your pixel
3. Click Test events
4. Enter your store URL
5. Browse your store
6. Check both “Browser” and “Server” events appear

Verifying in Events Manager

1. Go to Events Manager > Overview
2. Look at event breakdown
3. You should see events from both “Browser” and “Server”

Plan Requirements

Troubleshooting

CAPI Events Not Appearing

1. Verify the Access Token is correct
2. Check your Facebook account is connected
3. Ensure CAPI is enabled on the pixel
4. Wait 15-30 minutes for events to appear
5. Check Events Manager for any error messages

Access Token Expired

Access tokens can expire. If events stop appearing:

1. Go to Facebook Events Manager
2. Generate a new access token
3. Update the token in your pixel settings

“Invalid Access Token” Error

1. Verify you copied the full token
2. Check for extra spaces before or after the token
3. Generate a new token if needed

Duplicate Events in Events Manager

1. Verify Pixee is handling deduplication (check event IDs)
2. Check you do not have other apps also sending CAPI events
3. Contact support if duplicates persist

Best Practices

1. Always use CAPI with browser pixel: Use both for maximum data accuracy
2. Secure your token: Never share your access token publicly
3. Monitor Events Manager: Check weekly for any issues
4. Keep Facebook connected: Maintain your Facebook account connection

Facebook Requirements

Facebook recommends using Conversions API for:

• Better ad optimization
• More accurate conversion measurement
• Compliance with privacy regulations
• Future-proofing against browser changes

Next Steps

• Configure Event Tracking to customize tracked events
• Create Product Feeds for dynamic ads
• Set up Catalog Sync to sync products with Facebook