Documentation / Product / Integrations / Facebook

Facebook: Export Audiences (Conversion API)

Send Lytics Audience events to the Facebook Conversion API to improve your ad campaign performance.

Integration Details

This integration uses the Facebook Conversion API to send the Lytics audiences events. Once the job is started, it will:

  1. Scan the Lytics audiences and hash the user's email, or use the user's prehashed email. It also adds the Lytics audience membership information for the selected audiences for the user being exported. It then sends the information to Facebook.
  2. The export will run continuously. As users enter or exit the Lytics audience, they will be added to a queue. The queue will be sent to Facebook every hour or until the queue reaches 10,000 users, whichever happens first.

Fields

Lytics sends a hashed email and the Lytics audience membership to Facebook. An example of the payload that is sent to Facebook Conversion API is:

{
    "data": [
        {
            "event_name": "Lytics Audiences",
            "event_time": 1616772618,
            "action_source": "Lytics Server",
            "user_data": {
                "em": "e43763399e5318f14cd7473c4902a6b319343d577ec8283898a5edf9dbc6d711"
            },
            "custom_data": {
                "lytics_audience_slug_1": "true",
                "lytics_audience_slug_2": "false",
                "lytics_audience_slug_3": "true",
            }
        }
    ]
} 

Configuration

Follow these steps to set up and configure an Export Audiences to Conversion API job for Facebook. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Facebook from the list of providers.
  2. Select the export Export Audiences to Conversion API from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the audiences to export to Facebook Conversion API.
  7. From the Facebook Ads Account ID input, select your Facebook Ads Account. Note: 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.
  8. From the Pixel input, select your Facebook Pixel to link the Lytics audience(s) events.
  9. (Optional) From the Email Field input, select the Lytics field that contains the user emails. NOTE: you must select either Email Field or SHA256 Email.
  10. (Optional) From the SHA256 Email input, select the Lytics field that contains the SHA256 hash of user emails. NOTE: you must select either Email Field or SHA256 Email.
  11. (Optional) Select the Existing Users checkbox to add the users who already exist in the selected Lytics audiences.
  12. Click Start Export. facebook-conversion-api