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.

Set up Facebook Ads integration

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

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


    Field Description
    Advertising Account ID Specify the Facebook Advertising ID that you get from your Facebook account. 
  10. 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.
  11. Authorize Blueshift with the specified permissions.
  12. After Blueshift authorizes the Facebook integration, click Save.

Set up syndication

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

For Facebook Custom Audiences, we use Multikey Matching. Instead of just sending Facebook a user's email, telephone number or mobile id, Blueshift uses all available demographical information to Facebook. This allows Facebook to find users who signed up with a different email and/or phone number and significantly increases the overall match rate.

We send the following information (if available) to Facebook:

  1. Email address
  2. Phone number
  3. Gender
  4. Birth Year
  5. Birth Month
  6. Birthday
  7. Last name
  8. First name
  9. First Initial
  10. State
  11. City
  12. Zip code / Postal code
  13. Country code
  14. Mobile advertiser id

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.