Documentation / Product / Integrations / Taboola

Taboola: S3 CSV Export

Export Lytics audiences to Taboola to reach the most relevant users with your Taboola ads.

To export audiences to Taboola, an active cookie sync using the Lytics JavaScript Tag is required. Additionally, only audiences that have been manually configured in Taboola can be exported to using this workflow. See the Required Setup section below.

Required Setup

This export requires additional account setup before you can begin exporting audiences. Follow these steps to prepare your account for exporting audiences to Taboola:

  1. Make sure the Taboola LQL has been added to your account. Contact your account manager to ensure this step is completed.
  2. Enable the client-side cookie sync, ensuring that Version 3 of the Lytics JavaScript tag is installed on your website. Enable the Taboola sync in your account settings and ensure that taboola is not included on your integration blocklist.
  3. Contact your account manager to configure segment taxonomies for the audiences you wish to sync to Taboola. This is a step required by Taboola. Only audiences that have been manually allow-listed and configured in Taboola can be synced.

Integration Details

The Lytics JavaScript Tag supports a client-side integration which syncs Taboola cookie IDs to your Lytics profiles. Once this is set up, the S3 CSV Export workflow is used to export Lytics audiences to Taboola. The export uploads CSVs containing audience membership to an S3 shared between Lytics and Taboola. Taboola ingests the files from the S3 and updates audience membership in Taboola accordingly.

Once the export is started the workflow will:

  1. Scan the audiences selected for export.
  2. Collect each user's Taboola ID from the selected Identifier Field.
  3. Write each user's Taboola ID to a CSV file, along with the selected audiences the user is a member of.
  4. Upload the CSV to an S3 bucket shared between Lytics and Taboola.
  5. Steps 1 through 4 will be repeated daily at the time specified by Time of Day and Timezone.

Fields

This export is for audience membership only. No fields are exported.

Configuration

Follow these steps to set up and configure an export from Lytics to Taboola.

  1. To begin the S3 CSV export from the Lytics UI, navigate to Data > Integrations and select Taboola.taboola 215
  2. Click on the New Workflow button.
  3. From the Audiences input, select the Lytics audiences that contain the users to export. taboola audience selection
  4. From the Identifier input, select the field containing the Taboola ID. Note that for most users, Taboola Cookie ID will be the default selection. If a default does not display in the dropdown, make sure the Taboola LQL has been uploaded to the account as described in step 1 of Required Setup above.
  5. Select the Time of Day to start the export each day.
  6. Select the Timezone for the Time of Day.
  7. Click the Start Export button to start the work.taboola configuration