A Custom Audience is an ad targeting option that lets you find your existing audiences among people who are on Facebook. You can use sources such as customer lists, website or app traffic, or engagement on Facebook, to create Custom Audiences of people who already know your business.


This integration is available in all global regions.

Identifiers for customer matching

Blueshift uses multikey matching for audience syndication with Facebook Custom Audiences. Instead of just sending Facebook a customer email, telephone number or mobile id, Blueshift sends all available demographical information to Facebook. This allows Facebook to find customer who signed up with a different email and/or phone number and significantly increases the overall match rate.

Blueshift sends the following identifiers for customer matching:

  • Email address
  • Phone number
  • Gender
  • Birth Year
  • Birth Month
  • Birthday
  • Last name
  • First name
  • First Initial
  • State
  • City
  • Zip code / Postal code
  • Country code
  • Mobile advertiser id

Rate limit

The rate limit for this syndication is 1M customers per hour.

Facebook also has a rate limit of 200 requests/hour. Each request sent by Blueshift includes a maximum of 5000 customers.


Before you can set up integration with Blueshift, you must have your Facebook account set up.

The following information is required for integration with Blueshift:

  • Sign into the Facebook account that manages your Facebook advertisements and copy the Facebook Advertising ID from your account.

Set up integration

To set up integration with Facebook Custom Audience, complete the following steps:

  1. Sign in to the Blueshift app, and click App Hub in the left navigation menu.
  2. Go to All Apps, search for, and select Facebook Ads.
  3. You can also go to Advertising Apps and select Facebook Ads.
  4. Click Configure to view all the configured adapters.
  5. Click +ADAPTER to add an adapter.
  6. Add a Name for the adapter.  If you have multiple adapters, the adapter name helps you to identify the integration.
  7. Provide the following details for integration:


    Field Description
    Advertising Account ID Specify the Facebook Advertising ID that you get from your Facebook account. 
  8. Click Authorize Facebook. A pop-up appears that requests you to sign into the Facebook advertising account to let us access audiences that you have created in Facebook.
  9. Authorize Blueshift with the specified permissions.
  10. After Blueshift authorizes the Facebook integration, click Save.

Next steps

After the integration is complete, set up the syndication to Facebook. For more information, see Audience Syndications.

Troubleshooting Facebook permission errors

Syndications using a Facebook Ads integration adapter might fail with a permissions error if user authentication fails. User authentication for a user who previously authorized a Facebook Ads integration adapter in Blueshift might fail due to the following reasons:

  • The user is no longer a member of your organization.
  • The user changed the password.

In this case, a permissions error similar to "You cannot access the app till you log in to www.facebook.com and follow the instructions given." is displayed.

To resolve this issue, complete the following steps:

  1. Re-authenticate the Facebook Ads Adapter.
  2. Verify that the integration is working by checking that existing audiences are listed.
  3. Reset syndications with errors.

Re-authenticate the Facebook Ads Adapter

  1. Go to the App Hub and open the required Facebook Ads adapter.


  2. Click Reset Login.

    You can now see the Login to Facebook Ads button.

  3. Go to step 7 in Set up Facebook Ads integration, and follow the steps to complete the integration.

After you complete the steps, a new session token is acquired and saved with the adapter in Blueshift.

Verify that the integration is working

Verify that the integration is working by checking if it can list existing audiences.

  1. Go to Syndications and create a new Facebook Ads syndication.


  2. Click Refresh to fetch a fresh list of audiences. This might take a few minutes. If an error occurs, then the integration has failed.
  3. After the list is retrieved, select the adapter from the previous step.
  4. For Facebook Custom Audience Settings, select Sync with existing Facebook Custom Audience

    You can now see a list of existing audiences for Facebook Custom Audiences.

Reset syndications that have errors

Open each Facebook Ads syndication that has errors and click Reset.


Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.