Facebook Ads Integration

Overview

The Facebook Ads integration allows you to sync your AddressBook contact groups to Facebook Custom Audiences. This enables you to target your existing contacts with ads on Facebook.

Prerequisites

Before setting up the integration, ensure you have the following:

1. Facebook Business Portfolio (Business Manager) — You must have an active Business Portfolio. If you don't have one, create it at business.facebook.com.

2. Facebook Ad Account — An Ad Account linked to your Business Portfolio. Note down the Ad Account ID (numeric, found in Business Manager under Ad Accounts).

3. Admin Access — The user authorizing the connection must have admin/full control permissions on the Business Portfolio.

4. Custom Audience Terms of Service Accepted — Before the integration can create Custom Audiences, you must accept Facebook's Custom Audience Terms.

   • Visit: <https://business.facebook.com/ads/manage/customaudiences/tos/?act=<YOUR_AD_ACCOUNT_ID>>

   • This is a one-time requirement per ad account.

5. AddressBook Groups — You must have contact groups created in AddressBook that you want to sync to Facebook Ads.

Setup Steps

Step 1: Start Authorization

1. Navigate to the CDP Marketplace and select the Facebook Ads adapter.

2. Click Connect to authorize Facebook Ads to start the connection process.

Step 2: Select Your Business Portfolio

• Facebook will ask: "Which business portfolio would you like to connect to CDP Ads Integration?"

• Select your Business Portfolio from the list.

• Click Continue.

Step 3: Grant Ad Account Access

• Facebook will ask you to choose which Ad Accounts the integration can access.

• Select the ad account(s) you want to use for Custom Audiences.

• Click Continue.

NOTE: Please select only the Ads account that you have provided to the delivery team. Do not choose any other account.

Step 4: Review and Confirm Permissions

• Review the requested permissions (Ad accounts and ads_management permission).

• Click Save to confirm.

Step 5: Connection Complete

• You will see a confirmation: "[Your Business] has been connected to CDP Ads Integration".

• Click Got it — you will be redirected back to the Marketplace.

• The integration will generate a System User Access Token that does not expire. You do not need to re-authorize unless you revoke access.

Step 6: Configure the Adapter

After authorization, provide the following configuration:

Facebook Ad Account: An Ad Account linked to the Business Portfolio you intend to authorize. To find your Ad Account ID:

• Go to Facebook Ads Manager

• Click the Account dropdown in the top-left corner

• Your Ad Account ID is the numeric value displayed below the account name (e.g., 123456789)

• Ensure this ad account is linked to the Business Portfolio you will grant access to during authorization

CDP Account ID

Your Address Book Account ID allows you to select the contacts or groups you want to sync to Facebook Ads. The delivery team can assist you in getting the Account Id

Manage Groups to Sync

You can click on the Manage Groups button, which will redirect you to a page where you can select the groups you want to sync with Facebook Ads.

You can select multiple groups that you want to sync and can click on save groups button

Step 7: Sync

Once configured, the integration will:

• Automatically sync contacts based on the configured schedule.

• You can also trigger a Sync Data manually from the adapter settings.

How the Sync Works

1. Initialization — The system prepares the sync session.

2. Audience Setup — For each selected AddressBook group:

   • Checks if a Custom Audience with the same name already exists in your Ad Account.

   • If it exists, reuses the existing Custom Audience.

   • If not, creates a new Custom Audience with the same name as your AddressBook group.

3. Contact Sync — For each group:

   • Retrieves contacts from the AddressBook group.

   • Filters out contacts without email addresses and unsubscribed contacts.

   • Hashes email addresses using SHA-256 — raw emails are never shared with Facebook.

   • Uploads hashed emails to the corresponding Custom Audience in batches of 1,000.

Important Notes

• Token Validity — The integration uses a System User Access Token that never expires. You do not need to re-authorize periodically.

• Data Privacy — Email addresses are hashed (SHA-256) before being sent to Facebook. Facebook matches these hashes against their own user database — plain-text emails are never shared.

• Match Rate — Facebook matches uploaded hashed emails against its user base. Not all contacts will match, which is expected behavior. Match rates vary depending on how many of your contacts have Facebook accounts with the same email.

• Unsubscribed Contacts — Contacts marked as unsubscribed in your AddressBook are automatically excluded from the sync.

• Custom Audience Naming — Custom Audiences are created with the same name as your AddressBook groups.

• Re-authorization — If you need to change which ad accounts the integration can access, simply go through the authorization flow again.

Troubleshooting