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:

Make sure the Taboola LQL has been added to your account. Contact your account manager to ensure this step is completed.
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.
The cookie sync needs time to sync users with Taboola and populate profiles in your Lytics account with Taboola IDs. The S3 export will only send users that have been captured by the cookie sync and that have a valid Taboola ID on their profile. It is recommended to turn on the cookie sync at least a week prior to sending audiences via the S3 export.
Contact your Taboola 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

Implementation Type: Server-side.
Implementation Technique: JavaScript Tag and File based transfer.
Frequency: Batch.
Resulting data: Audience membership.

The Lytics JavaScript Tag supports a client-side integration which syncs Taboola cookie IDs to your Lytics profiles. See the Cookie Sync document for more information.

Once the cookie sync 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:

Scan the audiences selected for export.
Collect each user's Taboola ID from the selected Identifier Field.
Write each user's Taboola ID to a CSV file, along with the selected audiences the user is a member of.
Upload the CSV to an S3 bucket shared between Lytics and Taboola.
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. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

Select Taboola from the list of providers.
Select the Export job type from the list.
Enter a Label to identify this job you are creating in Lytics.
(Optional) Enter a Description for further context on your job.
Select the audience to export.
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.
Select the Time of Day to start the export each day.
Select the Timezone for the Time of Day.
Click Start Export.