Documentation / Product / Integrations / Facebook

Facebook: Export Audience

Sync your Lytics audiences with Facebook custom audience lists to target those users in the Facebook Ads platform.

Integration Details

This integration utilizes the Facebook Marketing APIs to send user data. Once the export is started the workflow will:

  1. Create an audience in Facebook Ads called Lytics {Audience Name}.
  2. Scan the Lytics audience and hash the selected user identifiers, i.e. email or phone or name and location, which will then be sent to Facebook to be added to the newly created audience.
  3. The export will run continuously. As users enter or exit the Lytics audience, they will be added to a queue. The queue will be flushed and updates to the Facebook audience will be pushed every hour or until the queue reaches 1,000 users, whichever happens first. Users will be added or removed from the audience appropriately.

Fields

By default, Lytics exports the following fields to Facebook. Many of these fields are configurable.

Lytics User FieldDescriptionFacebook FieldType
emailEmail AddressEmailstring
first_nameFirst NameFNstring
last_nameLast NameLNstring
genderGenderGENstring
cityCityCTstring
stateStateSTstring
zipcodeZip CodeZPstring
countryCountry CodeCOUNTRYstring
phonePhone NumberPHONEstring
mobile_advertisor_idMobile Advertisor IDMADIDstring
lifetime valueuser's lifetime valueLOOKALIKE_VALUEunit

Configuration

Follow these steps to set up and configure an audience export to Facebook from the Lytics platform.

  1. Navigate to the Integrations section and select Facebook. facebook tile
  2. Select Workflows from the menu on the left.
  3. Select Export Audience from the list.
  4. From the Audience input, choose the audience of users to export to Facebook then click Next Step.
  5. From the Facebook Ads Account ID input, if it says you "must accept Custom Audiences Terms" next to the Ads Account ID, copy and paste the following URL into your browser: https://business.facebook.com/ads/manage/customaudiences/tos/?act=YOUR_ADS_ACCOUNT_ID. Replace YOUR_ADS_ACCOUNT_ID with the account id you wish to use. There you can accept the Facebook Ads Custom Audience terms and conditions, and then refresh this list in the Lytics App.
  6. From the Email Field input, select the field that contains the users emails.
  7. If emails in your account are stored as a SHA256 hashes, then from the SHA256 Email input, select the field that contains the SHA256 hash of the user emails. Use this field instead of or in conjunction with the Email Field above.
  8. Using the Field Mapping input, map the Lytics field on the left to a Facebook field on the right for a greater matching resolution. Lytics fields that are mapped to Hashed facebook fields are assumed to be already hashed appropriately for Facebook's API within Lytics.
  9. In the Field Mapping input, the Lifetime Value Facebook field specifies the field that contains the lifetime value of this user. The Lytics field mapped to the Lifetime Value Facebook field should contain a positive numeric value. If this field is mapped the Facebook audience will be created as a value based lookalike audience. In order to use Lifetime Value audiences in Facebook, special terms must be accepted at https://www.facebook.com/customaudiences/value_based/tos/?act=YOUR_ADS_ACCOUNT_ID (you will need to replace YOUR_ADS_ACCOUNT_ID with your ads account ID) before creating a value-based audience.
  10. Click on the Show Advanced Options tab to expand the advanced configuration.
  11. Select the Existing Users checkbox to add users who already exist in the selected Lytics audience during the first batch sync.
  12. From the Audience Source input, select whether data was collected directly from customers, directly from partners, or from both.
  13. Optionally add an alternate Audience Name and Audience Description to identify the audience in Facebook. If left empty the default name specified above will be used. Facebook Audience Populate configuration
  14. Click the Start Export button to start the work

The custom audience should appear immediately in Facebook Ads. When you begin syncing audiences, it may take some time for them to process within Facebook.

Audience Sizes in Facebook

Immediately after export, in the Facebook UI you will see a size of Below 1000 and under this you may see the word Populating. Even if the audience is much larger than 1000 users, Facebook will always say Below 1000 if it is Populating. Facebook says about this state:

Audience Is Populating

We're finding people who fit your audience criteria. You can start running ads with this audience right away, but be aware that your audience size will increase as the audience is populated.

facebook populating

This process may take a number of days to complete.

If the exported audience has a lot of activity, an audience that has users enter/exit every hour, then the Facebook status may always say "Populating" since the workflow is continually sending new data to Facebook. If you would like to see the current side of the audience in the Facebook UI, the only way is to pause the export work in Lytics. To pause the work

  1. From the facebook page in Lytics, click on the work: facebook work status

  2. From the dropdown menu select Pause. In the Facebook UI, the size should stabilize within a few hours. facebook work pause

  3. Once you've seen the audience size and want to continue adding users, you can unpause the work by, on the same page, clicking Resume. After resuming, the audience size may go back into the "Populating" and "Below 1000" state. facebook work resume

In addition to the size shown, in the Facebook UI, you can click through to the audience and see the Custom audience updated messages on the History tab to see the batches of users that were sent to Facebook.