Meta Integration Guide

To use Meta Custom Audiences, you must first accept the Meta Custom Audiences Terms of Service. You can find more information here.

Configuration

The following configuration fields are required by the Cortex development team to enable the Meta Audiences integration in your Cortex account.

Name	Data type	Description
Meta Account ID	String	Meta Account ID to associate the audiences to. Found in Ads power tool.
Meta Access Token	String	Meta Access Token required to grant Audience Builder API access to create and populate audiences. Details can be found on the Meta Developer site.

Access Tokens

App access tokens are available on the Developer Tools page. However, it is recommended to generate a new access token for each partner integration. Follow the steps below to complete this process.

Generating A New Access Token

You can also generate new app access tokens via the terminal using the cURL command below. Be sure to replace app_id and app_secret with the values found in your app's settings page.

curl -X GET "https://graph.facebook.com/oauth/access_token?client_id={app_id}&client_secret={app_secret}&grant_type=client_credentials"

To access your app's settings page, start by navigating to the Apps Dashboard. You should see a screen similar to the one below:

Select the app you want to sync audiences to. In this example, we’ll choose Test App. From the left-hand navigation menu, go to Settings and then select Basic.

Once selected, you'll see your App ID and App Secret available (upon reauthorisation).

Note: This token will now need to be shared with the Cortex team securely. If you're unsure how to do this, please contact the team to ask for support first.

Supported Data Fields

The following data fields are synced to the Meta platform. Each field is hashed using SHA-256, enabling Meta to securely match them against their own hashed records without exposing any raw, sensitive information.

Email Address (SHA256)
Phone Number (SHA256)

Sync Frequency

Audiences are synced to the Meta platform every 3 hours. This synchronisation flow performs a full audience refresh every time, as recommended by the Meta platform. For large audiences, this can take up to 24 hours to update in the Meta platform.

Deleting an audience

Audience Builder deletes the downstream Meta audience when you delete an audience from the Cortex platform. This may take up to 24 hours to update in the Meta platform.

Meta Limits

Meta enforces a limit of 500 Custom Audiences per Meta Ads account. If you reach this limit, you'll need to delete audiences either from Cortex or directly within the Meta platform to allow new audiences to be synced.