Connect this destination to export audience membership as a Taboola first-party custom audience, for use in Taboola campaigns.

This destination writes to your Taboola account and is a good fit when you want to:

Make GrowthLoop audiences available for Taboola campaigns
Match contacts on email, device ID, or both

This maps to GrowthLoop Audiences and Journeys:

Use it for	Audiences	Journeys
Sending GrowthLoop audiences as Taboola first-party custom audiences	✓	✓

Prerequisites

Make sure you have:

A Taboola advertiser account with access to Backstage.
Backstage API credentials: Account ID, Client ID, and Client Secret. Ask your Taboola account representative if you do not have them.

Set up Taboola as a destination

In GrowthLoop, click the Destinations tab on the left sidebar.
Click New Destination in the top right corner.
Search for Taboola and click Add Taboola.
Enter the required information, then click Create.

Field	Description
Destination Name	Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Taboola Ads".
Sync Frequency	Set the default export frequency (for example, daily or weekly). You can override this setting for individual exports.
Account ID	Your Taboola advertiser account ID.
Client ID	Backstage API client ID from your Taboola account representative.
Client Secret	Backstage API client secret from your Taboola account representative.

GrowthLoop validates the credentials against Taboola. Taboola then appears in your list of connected destinations.

Export to Taboola

From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.

After building or selecting an audience, click Export, then search for Taboola. In a journey, add a Destination Node under Ads and select Taboola.

Map contact identifiers

On an audience or in a journey Destination Node, map Email, Device ID, or both. At least one is required.

Match field	Notes
Email	Email address. GrowthLoop hashes it as SHA-256
Device ID	Mobile advertising ID. GrowthLoop sends it in clear text

This destination does not send additional personalization fields.

Configure the export

This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.

Setting	Audience export	Journey Destination Node
Export Name	Defaults to `{audience name}_GL_Audience_{audience ID}`. That is the Taboola audience name unless you change it.	Required. Enter a name so you can find the export in GrowthLoop and the audience in Taboola.
Campaign type	Choose a one-time or ongoing export.	The journey schedule controls when the journey runs and contacts are sent to Taboola.
List Status	Choose New to create a Taboola audience, or Existing and enter the integer List Id.	Journeys use the list status you set on the node.
Export Inclusion Criteria	All audience members for a full refresh, or Newly added audience members for additions and removals since the last export.	The journey sends contacts who reach this node.
Schedule	Set frequency, start date, end date, and days of the week for ongoing exports.	Users reach this node when the journey runs. Add a Delay Node or set Criteria Evaluation to control timing.

Export behavior

This is what GrowthLoop writes when you export an audience.

Behavior	What happens
What GrowthLoop writes	A Taboola first-party custom audience. Direction is GrowthLoop → Taboola.
When it runs	GrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. Journeys send exports on demand when users reach the Destination Node.
New audience	GrowthLoop creates a first-party audience named after Export Name. Later runs reuse that audience. Membership lasts 60 days unless a later export adds the contact again.
Existing audience	GrowthLoop adds and removes contacts on the List Id you entered. That ID must be a first-party audience created through the Backstage API.
Match field	Email, hashed as SHA-256, Device ID in clear text, or both.
Add	GrowthLoop adds mapped identifiers to the audience.
Remove	GrowthLoop removes mapped identifiers from the audience.
One-time exports	GrowthLoop sends current membership once.
Ongoing adds and removals	Ongoing exports add contacts who enter the audience and remove contacts who leave that Taboola audience.
Deletes	GrowthLoop does not delete the Taboola audience.

Confirm the export was successful

When the run finishes, confirm you can use the data in Taboola.

Audience export: Sign in to Taboola Backstage, open Audiences, and look up Custom Audiences. Look for the _GL_Audience_ name unless you changed Export Name. A newly created audience can take up to an hour to become available.
Journey Destination Node: Open Custom Audiences and look up the audience named after the export.

In GrowthLoop, review counts on the audience Exports tab, or open the Activity tab on the journey Destination Node. See Export an audience or Monitor a journey for more information.

Congrats on successfully exporting to Taboola!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

Problem	Cause	Resolution
Connection fails to validate	Account ID, Client ID, or Client Secret is wrong	Paste the Backstage API credentials from your Taboola account representative
Rows fail to export	Email and Device ID are both unmapped or blank	Map Email, Device ID, or both
You cannot find the audience	You are searching for the unsuffixed audience name, or the audience is still creating	Search Custom Audiences for the `_GL_Audience_` export name. Wait up to an hour after the first create
Existing list export fails	List Id is not a first-party audience created through the Backstage API	Use a Backstage first-party audience ID, or choose New
Contacts who left the audience are still in Taboola	The export is one-time, or inclusion criteria did not include removals	Use an ongoing export and Newly added audience members or All audience members so removals run
Contacts drop off the Taboola audience after about 60 days	New audiences set a 60-day membership window	Keep an ongoing export so GrowthLoop adds those contacts again