Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

Taboola (Actions) Destination


Destination Info
  • Accepts Track calls.
  • Refer to it as Taboola (actions), or Taboola (Actions) in the Integrations object
  • This integration is partner owned. Please reach out to the partner's support for any issues.
  • This destination is in Beta

Taboola(link takes you to an external page) integration allows you to connect and target your Segment audiences with Taboola.

This destination is maintained by Taboola. For any issues with the destination, contact their Support team or your account manager.


Getting started

getting-started page anchor

Get Taboola Account Details

get-taboola-account-details page anchor

Before connecting the Taboola (Actions) destination you'll need the following:

  1. Your Taboola Client ID and Client Secret - provided by your Taboola account manager.
  2. Account ID: retrieve using one of these options:

Create and Connect the Taboola Destination

create-and-connect-the-taboola-destination page anchor
  1. From your Segment workspace's Destination catalog page(link takes you to an external page) search for Taboola (Actions).
  2. Select Taboola (Actions) and click Add Destination.
  3. Next, connect the Engage Space to your Taboola (Actions) Destination. To do this, use the Search for a source search field to find your Engage Space, then select it. Next, click the Confirm Source button.
  4. On the Basic Settings screen input the Taboola Client ID and Client Secret values.
  5. Enable the Destination using the toggle, then click the Save Changes button.

The Taboola (Actions) Destination is now connected to your Engage Space. The next steps cover connecting an Audience to a Mapping on your Taboola (Actions) Destination.

  1. Navigate to the Audience you'd like to sync to Taboola (Actions).

  2. On the Audience Overview tab, click the Add Destination button, then select the Taboola (Actions) Destination.

  3. Under the Destinations heading in the Audience Overview page you should now see your Taboola (Actions) listed. Click the Add Mapping button.

    Add mapping.
  4. When the side panel on the right displays, navigate to the Settings tab.

  5. On the Settings tab, ensure that Send Track is enabled, then populate the Taboola Account ID field.

    Audience settings.
  6. Click the Save button.

  7. Remain in the side panel, and navigate to the Matching mappings tab. Click the Add mapping button, then select Sync Audience.

  8. On the Sync Audience page, click the Save button. You'll be taken back to the Matching mappings tab. Enable the Mapping using the toggle.

    Enabled mapping.

The Audience will start to sync to Taboola shortly. It takes another 2-5 days for the segment to scale up and become available for targeting/suppression in Taboola Ads.

(information)

Info

To view the audience on the Taboola platform, navigate to the Taboola Ads audience page(link takes you to an external page), select "Custom Audience" and search for the audience you have just connected.


The Taboola (Actions) destination supports syncing Audiences to Taboola using either the email and/or the Mobile Device ID. email will be automatically included if present. Additional configuration steps are required in order to sync Mobile Device ID values. To sync Mobile Device ID values ensure the following is configured:

  1. Configure your Engage Space's identity resolution rules for android.id and ios.id identifiers by navigating to Unify >> Unify Settings.

    Enage ID Resolution Settings with android.id and ios.id configured.
  2. Ensure that both the android.id and ios.id identifiers are configured exactly as per the image below. This configuration step takes place when the Destination is being connected to an Audience.

    Device ID config for android.id and ios.id identifiers.

Property nameTypeRequiredDescription
Audience Identifierselect

Optional

The audience identifier from your Taboola account.


Client IDstring
required

The client ID from your Taboola account.


Client Secretpassword
required

The client's secret from your Taboola account.


Build your own Mappings. Combine supported triggers with the following Taboola-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Sync users to Taboola.

Sync Audience is a Cloud action. The default Trigger is type = "track"

Property nameTypeRequiredDescription
Email addressSTRING

Optional

The user's email address


Batch eventsBOOLEAN
required

When enabled, events will be batched before being sent to Taboola. In most cases, batching should be enabled.


Mobile Device IDSTRING

Optional

To send iOS and Android Device IDs include them as 'ios_id' and 'android_id' via the 'Customized Setup' option when connecting your Audience.


You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo(link takes you to an external page).

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to false.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

(information)

Real-time to batch destination sync frequency

Real-time audience syncs to Taboola (Actions) may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.


Segment lets you change these destination settings from the Segment app without having to touch any code.

Property nameTypeRequiredDescription
Audience Identifierselect

Optional

The audience identifier from your Taboola account.

Default: computation_key

Client IDstring
required

The client ID from your Taboola account.


Client Secretpassword
required

The client's secret from your Taboola account.