Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Facebook Custom Audiences Destination


Destination Info
  • Accepts Track calls.
  • In Cloud-mode, refer to it as PERSONAS - Facebook Ads, or Personas Facebook Custom Audiences in the Integrations object
  • This destination is only compatible with Twilio Engage.
Components
  • Server

Overview

overview page anchor

The Facebook Custom Audiences Destination is one of the most popular Engage destinations. It has a variety of use cases related to suppression, acquisition (using lookalikes), retargeting, and more.

This destination can send audiences (lists of users) created in Engage to Facebook Custom Audiences as a User-List. Once you set this up, Segment sends an initial list of users to Facebook, and then keeps it up-to-date as new users enter or exit that audience.

This lets you run advertising campaigns in Facebook without having to manually find and upload a refreshed a csv of users. Facebook Custom Audiences is also supported for Known Users.


Other Facebook destinations supported by Segment

other-facebook-destinations-supported-by-segment page anchor
(information)

Other Facebook destinations

This page is about the Facebook Custom Audiences destination developed specifically for use with Engage. No other sources support this destination.

For documentation on other Facebook destinations, see the pages linked.

Facebook DestinationSupported by Engage
Facebook App EventsYes
Facebook Offline ConversionsYes
Facebook PixelNo
Facebook Custom AudiencesYes
Facebook Conversions APIYes

Connection properties

connection-properties page anchor
PropertyDescription
Supports EngageYes
Destination typeList
Connection typeServer-side
Lookback windowAllowed
Destination rate limitNone
PropertyDescription
Audience appearanceFacebook Custom Audience
audience_name creationEngage automatically creates the audience. You don't need to predefine the `audience_name.
Minimum audience size100
Identifier typeDescription
Required identifiersEmail or Mobile Device ID (IDFA)
Accepted identifiersEmail and Mobile Device ID (IDFA). Other identifiers can be sent through Additional Traits Matching.

Facebook Custom Audiences lets you efficiently run several marketing and advertising operations. The following list outlines the most popular use cases when you know personally identifiable information (PII) about your users, such as email address, name, or phone number. Facebook takes the data that you send to Facebook Custom Audiences and matches it to the users that are on Facebook to enable these use cases.

  • Suppression Audiences. Create an audience of users that signed up, purchased a product, or otherwise performed some conversion event. Getting those users into Facebook in a timely manner (hourly syncs) prevents you from spending money targeting users that already converted. You can do this by creating an Audience in Engage, and syncing it to the Facebook Custom Audience Destination.
  • Lookalikes and Seed Audiences. You can use Engage to create a detailed profile of your most loyal customers (sometimes called a "seed audience") and then send this list of customers to Facebook. In Facebook, you can then use Facebook's lookalike audiencing features to find similar users to target. For example, you can create a group of high-value users that have spent a certain amount of money on your product, and then use Facebook audiences to find similar users.
  • Re-targeting Audiences. You can use Engage to target users who completed some initial action, but didn't follow through on a purchase or other conversion event. You can create audiences to re-target these individuals and remind them to complete the purchase or other process.

Anonymous users (Facebook Pixel support only)

anonymous-users-facebook-pixel-support-only page anchor

Sometimes, users visit your website and perform high-intent activities such as looking at a product or pricing page multiple times, but they don't convert (buy), and they don't provide any PII so you that can contact them later.

Facebook offers Meta Pixel(link takes you to an external page), which lets you retarget these types of anonymous users with advertising. This works by identifying users based on a cookie set in their browser. You can create a Website Custom Audience in Facebook for this use case.

How it works

how-it-works page anchor

Every time you create an audience in Engage and connect it to Engage Facebook Custom Audiences, Segment:

  1. Creates a Facebook Custom Audience (of type Customer List) with a name that matches the Engage Audience.
  2. Adds any users that fit the audience definition, based on the matching identifiers that Facebook supports (hashed). Facebook uses these identifiers to match users to Facebook users in their ads system.
  3. Once the audience is configured, Segment checks which users still fit the audience definition based on the same identifiers, and adds or remove users from the audience, every hour.
(information)

Real-time to batch destination sync frequency

Real-time audience syncs may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.

You can use the Audience History feature in Facebook to see this change over time.


Setting up the Facebook Custom Audiences destination

setting-up-the-facebook-custom-audiences-destination page anchor
(information)

Prerequisites

Before you start, make sure you have a Facebook Ads account with "Advertiser" or "Admin" access to link Engage to Facebook Ads.

1. Authorize Facebook Custom Audiences

1-authorize-facebook-custom-audiences page anchor
  1. Go to your Space in your Segment Workspace and click Engage Settings.
  2. Go to the Destinations tab and click Add Destination.
  3. Select the Facebook Custom Audiences option, and click Configure Facebook Custom Audiences.
  4. Authorize Facebook Ads and select a Facebook account ID to sync to.

Make sure you add the destination within the Engage space and not through the connections pipeline to ensure proper configuration.

2. Create an audience in Engage and connect to Facebook

2-create-an-audience-in-engage-and-connect-to-facebook page anchor
  1. Go to the Audience Builder in Engage and create a new Audience with your desired event and trait criteria.
  2. Go to your Space, and select the Facebook destination you added to connect the audience to Facebook.
  3. Give the audience a name and description, and click Create.
  4. Your audience starts syncing from Engage to Facebook Ads.

Note that if you change the name of the audience in Engage, it won't be reflected in Facebook.

3. Verify that the audience appears in Facebook

3-verify-that-the-audience-appears-in-facebook page anchor

Once created, the audience should be available in Facebook within ten minutes unless it's unusually large.

  1. From within Facebook Ads, go to Business Manager > All tools > Assets > Audiences.
  2. Click the Facebook audience name that matches your Engage audience name, and check Audience History to see how many users were added.
A screenshot of the Audiences page in Facebook Ads.

Additional traits matching

additional-traits-matching page anchor

Trait Enrichment lets you send an expanded list of identifiers or traits to Facebook, so that Facebook can try to use these additional data points to match to their user profiles.

If you have this feature enabled and implemented any of these traits in your Segment tracking, Engage can send this data to Facebook. Segment can also sync multiple emails if the profile contains more than one. Additionally as part of this feature, Segment hashes fields before sending them downstream to Facebook, if required. For hashing requirements, see the following table.

Note that the trait data implemented in your Segment tracking must match the naming convention and format specified in the table, otherwise Segment can't send it to Facebook.

NameTrait Key formats supportedFacebook KeysFacebook Hashing RequiredFacebook Guideline
EmailEMAILYes. Segment hashes for you. In case you are already hashing emails, emails will get sent to Facebook double-hashed. Facebook will still match on double-hashed emails, but this is not recommended.Trim leading, trail whitespace, and convert all characters to lowercase.
Mobile IDMADIDNoUse all lowercase, keep hyphens.
First Namefirst_name
firstname
firstName
first
FNYesUse a-z only. Lowercase only, no punctuation. Special characters in UTF8(link takes you to an external page) format.
Last Namelast_name
lastname
lastName
last
LNYesUse a-z only. Lowercase only, no punctuation. Special characters in UTF8(link takes you to an external page) format.
Phonephone
phone_number
phonenumber
phoneNumber
PHONE (+1XXXXXXXXXX)YesRemove symbols, letters, and any leading zeroes. If COUNTRY field isn't specified, add the country code prefix(link takes you to an external page).
Gendergender
gen
GENYesUse values: m for male and f for female.
Birth Yearbirth_yearDOBYYesUse the YYYY format from 1900 to current year.
Birth Monthbirth_monthDOBMYesUse the MM format: 01 to 12.
Birth Daybirthday
birth_day
date_of_birth
DOB
dateOfBirth
DOBDYesUse the DD format: 01 to 31.
Statestate
address_state
STYesUse the 2-character ANSI abbreviation code, lowercase. Normalize states outside U.S. in lowercase, no punctuation, no special characters, no white space.
Citycity
address_city
CTYesUse a-z only. Lowercase only, no punctuation, no special characters, no white space.
Zipcodezip
zip_code
zipCode
ZIPYesUse lowercase, no white space. Use only the first 5 digits for U.S. Use Area/District/Sector format for the UK.
Countrycountry_code
countryCode
COUNTRYYesUse 2-letter country codes (lowercase) in ISO 3166-1 alpha-2(link takes you to an external page).

Not seeing an audience in Facebook

not-seeing-an-audience-in-facebook page anchor

If syncs to the destination are failing, this might be due to an authorization error. Whoever created the destination account needs to accept the TOS. The account manager then needs to log in to their Facebook account, navigate to Audiences > Search Audience and click Accept Terms.

Audience size smaller than expected

audience-size-smaller-than-expected page anchor

Segment sends lists of users with identifiers that Facebook supports to Facebook. The matching logic itself occurs within Facebook. Facebook is more likely to be able to match a user profile if you track as many identifiers as possible, including email, mobile advertising identifiers (IDFA, Google advertising ID), and others. If Facebook is unable to identify users based on the data that you provide, then the match rate will be low.

For example, many B2B SaaS businesses have users that sign up for their products with a work email address, like jane.doe@segment.com. However, most Facebook users sign up for Facebook with a personal email only, like janedoe@gmail.com. If you only provide the work email address, and no other identifiers, then Facebook can't match your user to the Jane Doe Facebook profile. This is the case for all identifiers - Facebook must have the identifier somewhere in a user's profile, or else they can't match on it.

Why are all of my audiences connected to Facebook failing with an 'Internal Error' message?

why-are-all-of-my-audiences-connected-to-facebook-failing-with-an-internal-error-message page anchor

This is most likely due to your Facebook account needing to be reauthorized, sometimes due to a password change. Reauthorize the Facebook destination connection. If the error persists, contact Segment Support.

Note, emails must be in a plain text format. Facebook also provides these guidelines for the emails that you send to them: trim leading, trail whitespace, and convert all characters to lowercase.

Do you support LTV audiences?

do-you-support-ltv-audiences page anchor

Facebook has a feature called value-based audiences(link takes you to an external page) where you can send an additional field like LTV, to tell Facebook how to optimize their advertising based on a customer's value. The Facebook Custom Audiences destination does not support value based audiences. If you're interested in this feature, contact Segment support(link takes you to an external page).