Taboola Audiences Connector Setup Guide | Early Access

API Information

This connector uses the following vendor API:

API Name: Taboola API
API Version: v1.0
API Endpoint: https://backstage.taboola.com/backstage/api/1.0
Documentation: Taboola API

Actions

Action name	AudienceStream	EventStream
Add User to Audience	✓	✓
Add User to Audience (Batched)	✓	✓
Remove User from Audience	✓	✓
Remove User from Audience (Batched)	✓	✓

Configuration

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see About Connectors.

When you add this connector, you must accept the vendor’s data platform policy.

After adding the connector, configure the following settings:

Account ID: Assigned Taboola account ID.

Action parameters

The following section lists the supported parameters for each action.

Add User to Audience

Parameters

Parameter	Description
Audience ID	The ID of the audience that the user will be added to. Click Verify Audience ID to verify the Audience ID that you entered. To create a new audience, use the following steps: Click Create Audience. Enter a unique audience name in the Audience Name field. Enter the time that a user should remain in an audience in the TTL in Hours field. The default value is `8670` (one year). To exclude the audience from new and existing campaigns, enter `True` in the Exclude from Campaigns field. The default value is `False`. Click Done.
User ID	The User ID, as a SHA256 hashed email address or a MAID device ID
Type	The User ID type (either `DEVICE_ID` or `EMAIL_ID` )

Add User to Audience (Batched)

Batch Limits

This action uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

Max number of requests: 10000
Max time since oldest request: 10 minutes
Max size of requests: 10 MB

Parameters

Parameter	Description
Audience ID	The ID of the audience that the user will be added to. Click Verify Audience ID to verify the Audience ID that you entered. To create a new audience, use the following steps: Click Create Audience. Enter a unique audience name in the Audience Name field. Enter the time that a user should remain in an audience in the TTL in Hours field. The default value is `8670` (one year). To exclude the audience from new and existing campaigns, enter `True` in the Exclude from Campaigns field. The default value is `False`. Click Done.
User ID	The User ID, as a SHA256 hashed email address or a MAID device ID
Type	The User ID type (either `DEVICE_ID` or `EMAIL_ID` )

Remove User from Audience

Parameters

Parameter	Description
Audience ID	The ID of the audience that the user will be added to. Click Verify Audience ID to verify the Audience ID that you entered. To create a new audience, use the following steps: Click Create Audience. Enter a unique audience name in the Audience Name field. Enter the time that a user should remain in an audience in the TTL in Hours field. The default value is `8670` (one year). To exclude the audience from new and existing campaigns, enter `True` in the Exclude from Campaigns field. The default value is `False`. Click Done.
User ID	The User ID, as a SHA256 hashed email address or a MAID device ID
Type	The User ID type (either `DEVICE_ID` or `EMAIL_ID` )

Remove User from Audience (Batched)

Batch Limits

Max number of requests: 10000
Max time since oldest request: 10 minutes
Max size of requests: 10 MB

Parameters

Parameter	Description
Audience ID	The Audience ID that the user will be added to. Click Verify Audience ID to verify the Audience ID that you entered. To create a new audience, use the following steps: Click Create Audience. Enter a unique audience name in the Audience Name field. Enter the time that a user should remain in an audience in the TTL in Hours field. The default value is `8670` (one year). To exclude the audience from new and existing campaigns, enter `True` in the Exclude from Campaigns field. The default value is `False`. Click Done.
User ID	The User ID, as a SHA256 hashed email address or a MAID device ID
Type	The User ID type (either `DEVICE_ID` or `EMAIL_ID` )