Meta Ads Integration | Facebook & Instagram Campaigns

Integration Features

Campaign performance sync
Conversions API (CAPI) support
Automated bid optimization
Creative performance tracking
Audience insights integration

Overview

The Meta Ads integration connects your Facebook and Instagram advertising campaigns with ClicksFlyer. This enables unified reporting, conversion tracking, and automated optimization across your mobile UA efforts.

Integration Methods

1. Marketing API Integration

Full bi-directional sync of campaign data, performance metrics, and optimization signals.

2. Conversions API (CAPI)

Server-side event tracking for improved attribution accuracy, especially post-iOS 14.

3. Reporting API

Pull campaign performance data for unified analytics.

Setup Guide

Step 1: Connect Meta Business Account

Go to ClicksFlyer Settings → Integrations → Meta Ads
Click "Connect with Facebook"
Authorize ClicksFlyer to access your ad accounts
Select the ad accounts to connect

Step 2: Configure Pixel & CAPI

For server-side tracking, set up Conversions API:

Go to Events Manager in Meta Business Suite
Select your Pixel
Navigate to Settings → Conversions API
Generate an access token
Add token to ClicksFlyer integration settings

Step 3: Map Events

Map your ClicksFlyer events to Meta standard events:

{
  "install": "fb_mobile_install",
  "purchase": "fb_mobile_purchase",
  "registration": "fb_mobile_complete_registration",
  "add_to_cart": "fb_mobile_add_to_cart"
}

CAPI Implementation

Conversions API sends events server-side, improving attribution reliability:

POST https://graph.facebook.com/v18.0/{pixel_id}/events
{
  "data": [{
    "event_name": "Purchase",
    "event_time": 1699488000,
    "user_data": {
      "em": "hashed_email",
      "ph": "hashed_phone"
    },
    "custom_data": {
      "currency": "USD",
      "value": 9.99
    }
  }],
  "access_token": "your_token"
}

iOS 14+ Considerations

With ATT and limited device tracking:

CAPI is essential for accurate conversion data
Use Aggregated Event Measurement (AEM)
Configure 8 priority events per domain/app
Expect delayed and modeled data

Available Metrics

Impressions and Reach
Clicks and CTR
Installs and Cost per Install
ROAS and Revenue
Video views and completion rates
Frequency and audience overlap

Troubleshooting

Connection failed: Verify you have admin access to the ad account
Missing data: Check API permissions and token expiration
CAPI events not matching: Verify event deduplication setup