The Data Activation connector for Meta (formerly Facebook) Custom Audiences enables seamless integration between your customer data and Meta's powerful advertising platform. By connecting these systems, you can efficiently target and re-engage your audience with highly personalized ads that resonate at every stage of the customer journey.
This integration empowers you to:
Leverage real-time insights: Use up-to-date, first-party customer data to create dynamic and precise Custom Audiences on Meta.
Boost campaign ROI: Optimize ad spend by focusing on the most relevant segments, such as high-value customers, recent purchasers, or users likely to churn.
Enhance cross-channel consistency: Align your messaging and offers on Meta with other channels to deliver cohesive and personalized customer experiences.
Automate audience updates: Keep your Meta Custom Audiences automatically refreshed with the latest data, ensuring your targeting remains relevant and impactful.
Key features:
Create a Meta custom audience directly from the Data Activation
Send user identifiers to Meta anytime based on online/offline profile data (unlike Meta pixel integration which only triggers when a user interacts with a web page)
Combine several types of identifiers
Automatically add/remove users from connected Meta custom audiences when profiles enter or leave audiences/journeys
Destination connector overview
Attribute | Value |
|---|---|
Platform type | Social |
PartnerType Slot | Hashed email (7001), Hashed phone (7002), Facebook user ID (7003), Mobile advertising ID IDFA/GAID (7005) |
Cookie Sync | No |
Connecting protocol | HTTP |
API Version | V16 |
Syncs Data On | Add, Remove |
Allowed setting multiple connectors | Yes |
ProfileVars Support | No |
Connector Type | Audiences/Journey Orchestration |
Before you begin
Before configuring the Meta connector, ensure the following requirements are met:
Admin access to an active Business Manager account.
Admin access to Ad Account (using Meta Business Manager).
Your Meta Ad account ID. To find your Meta Ad account ID, visit this page with the owner account and click the dropdown toggle on the top right. Copy the Ad Account ID you want to connect and save this for later.
Accepted Custom Terms and Conditions (see
https://business.facebook.com/ads/manage/customaudiences/tos/?act=<AD_ACCOUNT_ID>).To find your AD_ACCOUNT_ID, visit Facebook Ads Manager Settings with the owner account and click the dropdown toggle on the top right.
Prepared links for your company's Privacy Policy URL, Terms of Service URL, and User Data Deletion URL.
Note
Meta configuration is not the Data Activation's responsibility. This article is meant as a guide to set up the connector.
High-level Meta configuration
Create an app type “Business” within the Marketing API permission using developers.facebook.com, by following Meta’s instructions.
Fill in the details and select the relevant Business Manager.
App Display Name
App Contact Email
Use cases: Measure ad performance data with Marketing API
Business portfolio: You can connect your business portfolio now or later
Create the app
In the menu on the left, go to Use cases and click Customize on the selected use case.
Under Tools, click Generate New Token, with the following permissions:
ads_read
ads_management
Copy the token and save this in a secure location.
Go to Settings and then select Basic from the left sidebar of your App Dashboard. Fill in the required fields, making sure to provide a valid Privacy Policy URL, Terms of Service URL, and User Data Deletion URL.
Go to Facebook People Settings, and select the Business → Users → System Users.
Add a new Admin System User or select an existing one.
Ensure the Meta Ad Account and App are both connected assets of the System User.
If the App or Ad Accounts aren't listed under Assigned Assets, add them by clicking Add Assets.
Note
When you've added these assets, make sure you have admin access by clicking the dropdown arrow in the associated “Ad Accounts” dropdown list under which the configured Ad Account should be seen.
Activate the Manage Ad Account to allow control ad account settings, finances and permissions.
To verify everything is configured correctly, go to Facebook access token and paste in the token you generated earlier.
When you have set all the configuration, publish the app you created earlier by going to your app instance in https://developers.facebook.com/ and click Publish on the side and press the Publish button.
Instructions
Step 1: Configure destination
On the Data Activation platform, select Connectors in the left-side navigation bar.
Click + New Connector.
Select Facebook.
Use the same access token that was created in the Meta configuration process.
You can set up multiple Meta connectors connected to different Ad Accounts and/or types of identifiers (see Payload type) for the same Ad account.
Step 2: Add the destination connector to an Audience or Journey
On the Data Activation platform, select Audiences in the left-side navigation bar.
Configure the criteria users should meet to become part of the audience in step 1.
Add your Meta connector in step 2 of the audience setup.
Make sure profile identifiers mentioned in the Quick Connector Overview are collected in the Data Activation before using this connector.
Error handling
Meta error codes are reported on the Data Exchange section of the audience or journey using the following error codes:
Timeout
Other error
Invalid credentials
For more information, see the Meta API documentation:
If your error isn't listed above, consult the Meta Marketing API error reference documentation for investigation.
FAQs
How do I use the external ID as payload type?
The Data Activation team is currently assessing whether the external ID provides any added value compared to first-party identifiers such as cookies created by the Meta pixel or email/phone hash.
Can I use the external_id in combination with CAPI/pixel?
Meta uses different storage for custom audiences compared to CAPI/pixel; an external_id sent using pixel cannot be used in Custom Audiences and vice versa.