Facebook Ads

This integration creates custom audiences from your first-party behavioral data to drive new user acquisition and conversions. Upload and sync behavioral cohorts directly to Facebook for campaign targeting across the Facebook ad network.

Considerations

• If your audience has fewer than 100 users, Facebook is unlikely to use it. For audiences between 100 and 1000 users, Facebook displays the user count as "<1000 users."
• Add this integration in each project. The person who sets up the integration must also accept the custom audience Terms of Service.
• Matching added users from uploaded custom audiences can take up to one hour, and removing users can take up to a day. The Audience you sync from Amplitude may not appear immediately.
• Facebook Ads requires hashed fields for ingestion. If you don't hash fields yourself, Amplitude hashes them when exporting the cohort.

Prerequisites

You need a Facebook Business Manager account.

Set up the integration

Amplitude setup

1. In Amplitude Data, click Catalog and select the Destinations tab.
2. In the Cohort section, click Facebook.
3. Click Continue with Facebook and log in to Facebook to accept the terms and conditions. You must accept Facebook's terms to set up the integration.
4. Map your Facebook users to your Amplitude users. Map a range of Facebook keys, such as email or phone number, and the Amplitude Identifier can be a user ID, device ID, or a custom user property. You can use Facebook keys that aren't specific to an individual user, such as "country," but you must send at least one uniquely identifiable key (like email or device ID). More key mappings produce a better match rate.

5. When finished, save your work.

Send a cohort

1. In Amplitude, open the cohort you want to export. Click Sync, and choose Facebook.
2. Choose the destination.
3. Select the sync cadence.
4. Save your work.

The exported cohort appears as a custom audience on the Audience page of Facebook Business Manager.

Troubleshooting

Three common errors can occur when setting up the Facebook integration.

Facebook Custom Audience Terms of Service not accepted

The Facebook ad account must authorize Amplitude to use custom audiences. Accept the Terms of Service to authorize Amplitude.

• Solution: Accept the terms of service. You need Admin/Manager permissions in Amplitude, plus the appropriate permissions on Facebook to accept the terms of service in the pop-up module.
  • Several levels of terms of service exist:
    • User level
    • Business level: visit https://business.facebook.com/ads/manage/customaudiences/tos.php?business_id={BUSINESS_ID} to accept the terms of service on behalf of the business account, which is different from the ad account or your own user account. (Replace {BUSINESS_ID} with your own ID.)
    • Ad account level: for each ad account you use, verify the terms of service are accepted. To do so, use the following URL by replacing {ACCOUNT_ID} with your ad account IDs (act_xxxx format): https://www.facebook.com/ads/manage/customaudiences/tos?{ACCOUNT_ID}.
  • After you accept all terms, disconnect and reconnect the Facebook Ads (Cohort sync) integration.

Facebook didn't connect to Business Manager

For security reasons, Facebook requires that ad accounts associate with Business Manager. This integration doesn't work unless you've enabled Business Manager for your ad account.

• Solution: Create a Business Manager for your account and associate your ad account with that Business Manager.

Facebook user lacks audience permissions

The user who sets up the integration on Amplitude must have permissions to access the Facebook APIs. Amplitude sends custom audiences to Facebook on behalf of that user, so without the proper permissions, Amplitude can't either.

• Solution: Grant the setup user access to use APIs. If the original setup user lost permissions, disconnect the integration and reconnect it with another user who has permissions. To disconnect the integration, navigate to Sources & Destinations --> {Project Name} --> Destinations --> Cohort Destinations --> Facebook.