Create a First Party Audience

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 new First Party Audience via the API (this page), and save the newly created Audience ID.

   Allow 1 hour for the new audience to become available.

2. Add 1 or more batches of users, passing the above Audience ID. (See Add/remove users, below.)

   For testing purposes, we recommend populating the audience with at least 1,000 users.
   To cater for network latency, we suggest limiting each upload to 100k users.

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

   You can check the audience_size using the My Audience endpoint, below.
   Audience size has not changed? See callout below.

4. Target the above Audience ID. (See Update My Audience Targeting, below.)

🚧

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.
• For testing purposes, we recommend populating the audience with at least 1,000 users. Wait 1 - 3 days for the audience to achieve scale.
• If the audience_size does not update, it means that the system was unable to match any of the uploaded users.
• Make sure that you have not mistakenly hashed the user's email twice.
• If the problem persists, open a ticket with [email protected]