API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

Create a First Party Audience

See the overview (above) for a list of supported countries.

Sample CREATE request:

POST /backstage/api/1.0/demo-advertiser/audience_onboarding/create
{
   "audience_name": "Demo Audience Name",
   "ttl_in_hours": 1440
}
{
    "audience_name": "Demo Audience Name",
    "ttl_in_hours": 1440,
    "audience_id": 49
}

📘

See the overview (above) for a list of supported countries.

🚧

End-to-end Flow

  1. Create a First Party Audience via the API (as described on this page).

    Keep a record of the newly created Audience ID.
    Allow up to 1 hour for the new audience to become available.

  2. Add 1 or more batches of users, passing the above Audience ID.

    For testing purposes, populate the audience with as many users as possible (1,000 users or more).
    To cater for network latency, limit each batch to 100k users (or less).

  3. Wait 1 - 3 days for the audience to achieve scale.

    You can check the audience_size using the My Audience endpoint, below.
    For basic troubleshotting steps, see the callout below.

  4. Target the above Audience ID.

🚧

Audience size has not changed?

The audience_size field reflects the estimated number of users with visible activity in the Taboola network, over the past 30 days.

If the audience_size does change, it means that Taboola was unable to match any of the uploaded users. In that case, check the following guidelines:

  1. Populate the audience with as many users as possible (1,000 users or more).
  2. Wait 1 - 3 days for the audience to achieve scale.
  3. Make sure that you have not mistakenly hashed the emails twice.
  4. If the problem persists, open a ticket with [email protected].
Language
Authorization
OAuth2