SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

Fix Facebook Custom Audiences Sync Errors in Segment

Issue

When using Twilio Segment, you may find that your Reverse ETL sync to Facebook Custom Audiences is not populating existing audience lists, or you are unable to create a new audience or select an existing one while configuring a mapping. Additionally, you may notice that the resulting audience size in Facebook is significantly smaller than the number of records extracted.

 

Product

Twilio Segment

 

Environment

Segment Console

 

Cause

This issue is typically caused by either an authentication error or a low match rate due to insufficient user identifiers.

If the audience is not populating or cannot be selected, the Facebook user who authenticated with Segment likely lacks the required permissions for the configured Advertiser Account ID. If the audience size is smaller than expected, it means Facebook's internal matching logic could not find enough user profiles based on the limited identifiers sent from your data warehouse. For example, sending only a B2B work email might fail to match a user if their Facebook account is registered under a personal email address.

 

Resolution

To resolve authentication and permission issues:
  1. Navigate to your Facebook Custom Audiences destination settings in the Segment Console.
  2. Verify that you have authenticated with the correct Facebook account.
  3. Ensure that the authenticated Facebook user has at least an Advertiser or Admin role on the target Ad Account.
  4. Confirm that the user has access to the specific Advertiser Account ID configured in Segment.
To resolve low match rates and increase audience sizes:
  1. Open your Reverse ETL model mapping for Facebook Custom Audiences.
  2. Map as many user identifiers as you have available in your source model (such as email, phone number, mobile advertising IDs, first name, last name, city, state, etc.) to the destination fields.
  3. Save the mapping and allow the next sync to run. Providing more data points greatly increases the likelihood of a successful match on Facebook's end.

 

Additional Information 

Facebook requires all Personally Identifiable Information (PII) to be SHA256 hashed before it is sent to their API. You do not need to manually hash this data before syncing; to improve match rates, Segment automatically handles the formatting, normalization (e.g., stripping whitespace and converting to lowercase), and SHA256 hashing of unhashed PII like emails, phone numbers, names, and locations.

 

Have more questions? Submit a request
Powered by Zendesk