Facebook Conversions API (CAPI) Integration Guide
Optimize Ads with Linkzly + Facebook CAPI
Linkzly's Facebook CAPI integration sends click events to your Pixel, including UTM and action sources for precise attribution. Track offline QR scans as conversions, improving targeting and reducing costs. Production-grade with deduplication and test codes, this ensures high match quality and compliant tracking in a privacy-first world.
Uses Facebook's Conversions API for server-to-server events.
Why Integrate Linkzly with Facebook CAPI?
Enhance your Facebook advertising with server-side event tracking and improved attribution.
Better Attribution
Send "link_click" as conversions with UTM for accurate ROI.
Offline Tracking
Capture QR scans/phone calls not seen by Pixel.
Privacy-Resilient
Server-side sending bypasses blockers like iOS limits.
Ad Optimization
Lower CPA by 19% (as seen in case studies) with complete data.
Redundancy
Pair with Pixel for deduplicated events.
Scalable
Handle high volumes with batching and retries.
Key Features in Linkzly's Facebook CAPI Integration
Advanced event tracking with comprehensive testing and debugging capabilities.
Event Properties
UTM, action_source, custom data—up to v17.0 API.
Deduplication
Via event_id, fbp/fbc.
Test Codes
Debug without impacting live data.
Geo/Device
Enrich for better matching.
Timeouts
Custom for reliability.
Step-by-Step Setup Guide
Quick setup for ad excellence.
Access Integrations
Linkzly > "Integrations" > Add Facebook CAPI.
Enter Credentials
Pixel ID and Access Token (from Events Manager > Settings > Conversions API).
Configure Settings
Set API version, enable test codes.
Map Events
"link_click" to CAPI events like "Purchase" with revenue.
Test Connection
Use test events; verify in Events Manager > Test Events.
Activate & Monitor
Enable; check EMQ for match quality.
Sample Event Payload
Forwarded purchase:
{
"data": [
{
"action_source": "website",
"event_name": "Purchase",
"event_time": 1627849200,
"user_data": {
"em": "hashed_email",
"ph": "hashed_phone"
},
"custom_data": {
"value": 99.99,
"currency": "USD",
"content_ids": ["product123"]
},
"event_id": "unique-789"
}
],
"test_event_code": "TEST12345"
}POST Request
To https://graph.facebook.com/v17.0/PIXEL_ID/events?access_token=TOKEN.
Validation
Use Events Manager for EMQ (Poor to Great).
Best Practices for Production-Grade Use
Follow these recommendations to ensure optimal performance and match quality.
Matching
Send 8-10 user params (hashed) for >70% match rates.
Deduplication
Use event_id; share with Pixel.
Redundancy
Send browser + server events for max coverage.
Limits
Batch up to 1000 events; respect rate limits.
Testing
Separate test Pixel; use codes for debugging.
Real-World Example: E-Commerce Boost
Forward scans as conversions. CAPI shows 36% reach increase, 19% CPA drop—optimize ads for high-value users.
Integrate today—supercharge your Facebook ads with Linkzly!