Facebook Ads

This integration enables you to create custom audiences from your first-party behavioral data to drive new user acquisition and conversions. With this integration, you can upload and sync behavioral cohorts directly to Facebook for campaign targeting throughout 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."
  • You must add this integration in each individual project. The person who establishes the integration is also the person who needs to agree with the custom audience Terms of Service.
  • Matching for added users from uploaded custom audiences can take up to one hour, and removing users can take up to a day. As a result, there can be a delay before you see the Audience you synced from Amplitude.
  • Facebook Ads requires hashed fields for ingestion. If you don't hash fields yourself, Amplitude hashes them when it exports the cohort.

Setup

Prerequisites

You need a Facebook Business Manager account.

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. You can choose to map a wide 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). The more key mappings you add, the better your match rate is.
  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 is now available as a custom audience on the Audience page of Facebook Business Manager.

Common errors

There are three common errors users can run into while setting up the Facebook integration.

The Facebook Custom Audience Terms of Service weren't accepted. Amplitude must be authorized by the Facebook ad account to use custom audiences. You must accept the Terms of Service to authorize Amplitude.

  • Solution: Accept the terms of service. You need Admin/Manager permissions in Amplitude, as well as the appropriate permissions on Facebook to accept the terms of service in the pop-up module.
    • There are several levels of terms of service:
      • 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 that their 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 are associated 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 the appropriate permissions to access the Facebook APIs. Amplitude sends custom audiences to Facebook on behalf of that user, so if they don't have the proper permissions, Amplitude doesn'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.
Was this page helpful?

Thanks for your feedback!

April 18th, 2024

Need help? Contact Support

Visit Amplitude.com

Have a look at the Amplitude Blog

Learn more at Amplitude Academy

© 2024 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.