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.
Availability
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.
Prerequisites
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:
Sign in to the Blueshift app, and click App Hub in the left navigation menu.
Go to All Apps, search for, and select Facebook Ads.
You can also go to Advertising Apps and select Facebook Ads.
Click Configure to view all the configured adapters.
Click +ADAPTER to add an adapter.
Add a Name for the adapter. If you have multiple adapters, the adapter name helps you to identify the integration.
Provide the following details for integration:
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.
Authorize Blueshift with the specified permissions.
Field | Description |
Advertising Account ID | Specify the Facebook Advertising ID that you get from your Facebook account. |
Exclude PII data
You can optionally exclude specific personally identifiable information (PII) attributes from being sent to the destination platform.
To exclude PII attributes:
Scroll to the Additional Configuration (Optional) section in the adapter setup.
Click the Exclude PII Data input.
Select one or more attributes to exclude, such as
emailorgender.Click Save Configuration to apply the changes.
The list of available attributes is destination-specific and may vary by platform.
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.
Customer value custom audience
Facebook allows you to target a value-based alike audiences using a customer value custom audience. You can sync a customer attribute present in Blueshift to Facebook to use it for targeting a look alike audience. Follow these steps while setting up Audience Sync to Facebook Ads to sync a customer value
While setting up the Audience Sync, if you are creating a new Facebook audience select the Value based checkbox to create a new customer value custom audience
If you already have a customer value custom audience setup on Facebook, then select that existing audience from the list of Facebook Audience name
Once you have created or selected an existing customer value custom audience you would have additional input to select the Customer Value Attribute that you would want to sync to Facebook
Select the appropriate Blueshift customer attribute in this input
Set up the rest of the Sync
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:
Verify that the integration is working by checking that existing audiences are listed.
Re-authenticate the Facebook Ads adapter
Go to the App Hub and open the required Facebook Ads adapter.
Click Reset Login.
You can now see the Login to Facebook Ads button.
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.
Go to Syndications and create a new Facebook Ads syndication.
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.