Table of contents
Overview
Set up Meta Conversions API (CAPI) to bypass browser tracking limitations and improve ad performance on Facebook and Instagram.
Prerequisites
- Facebook Business Manager access
- Meta Pixel installed on website
- CustomerLabs account with tracking code deployed
- Meta Ads Manager access
Step 1: Generate Meta Access Token
- Go to Facebook Business Settings
- Navigate to System Users
- Create a new system user or select existing
- Generate access token with
ads_managementandbusiness_managementpermissions - Copy and save the access token securely
Step 2: Connect Meta in CustomerLabs
- Open CustomerLabs dashboard
- Navigate to Destinations → Meta
- Select “Conversions API”
- Enter your Pixel ID and Access Token
- Test connection
Step 3: Configure Event Mapping
Map CustomerLabs events to Meta standard events:
- Purchase → Meta
Purchase - Add to Cart → Meta
AddToCart - View Content → Meta
ViewContent - Initiate Checkout → Meta
InitiateCheckout - Lead → Meta
Lead
Step 4: Enable Event Deduplication
Configure event deduplication to avoid double-counting:
- Enable deduplication in CustomerLabs
- Set event_id parameter for both Pixel and CAPI
- Set deduplication window (default: 24 hours)
Step 5: Verify Setup in Meta Events Manager
- Go to Meta Events Manager
- Select your Pixel
- Check “Test Events” tab
- Trigger test events on your website
- Verify both Pixel and Server events appear
Step 6: Monitor Match Quality
- Navigate to Events Manager → Data Sources
- Select your Pixel
- Check “Match Quality” score
- Aim for 80%+ match rate
Expected Results
- 20-40% improvement in conversion tracking
- Better iOS 14+ tracking resilience
- Improved ROAS from better attribution
- Higher audience match rates
Advanced Configuration
Customer Information Parameters
Send additional parameters to improve matching:
- Email (hashed)
- Phone (hashed)
- First name (hashed)
- Last name (hashed)
- City, state, country
- Zip code
Custom Events
Map custom events for specific business needs:
// Example: Subscription event{ event_name: "Subscribe", custom_data: { subscription_type: "premium", value: 29.99, currency: "USD" }}Best Practices
- Always enable deduplication to prevent double-counting
- Send as many customer parameters as possible for better matching
- Hash PII data before sending (CustomerLabs does this automatically)
- Monitor Event Match Quality score weekly
- Test both Pixel and CAPI events regularly
Troubleshooting
Low match quality score
- Add more customer information parameters
- Verify data quality (valid emails, phone numbers)
- Check data hashing is working correctly
- Ensure consistent data formatting
Events not appearing in Events Manager
- Verify access token has correct permissions
- Check Pixel ID is correct
- Confirm CustomerLabs events are firing
- Review test events for errors
Duplicate events showing
- Enable event deduplication
- Verify event_id is set for both Pixel and CAPI
- Check deduplication window setting
- Ensure consistent event naming
Success Metrics
Track these KPIs after implementation:
- Event Match Quality Score (target: 80%+)
- Attributed Conversions increase (target: 20%+)
- ROAS improvement (target: 15-30%)
- iOS conversion tracking recovery