post
https://backstage.taboola.com/backstage/api/1.0//campaigns//targeting/custom_audience
Update Custom Audience Targeting for the specified campaign.
Rate limit: Tier 1
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
With Custom Audiences, you can specify both INCLUDE and EXCLUDE.For example: include all female visitors that made a purchase - but exclude visitors above the age of 40.
Combining INCLUDE and EXCLUDE conditions limits your target audience (AND Operation).
VALID request examples:
(Follow the examples from left to right...)
{
"collection": []
}{
"collection": [
{
"collection": [
224820,
25287
],
"type": "INCLUDE"
}
]
}{
"collection": [
{
"collection": [
224820,
25287
],
"type": "INCLUDE"
},
{
"collection": [
19884,
29870
],
"type": "EXCLUDE"
}
]
}{
"collection": [
{
"collection": [
224820,
25287
],
"type": "INCLUDE"
},
{
"collection": [],
"type": "EXCLUDE"
}
]
}{
"collection": [
{
"collection": [
224820,
25287
],
"type": "EXCLUDE"
}
]
}
Audience Targeting does not support a PATCH operation - the submitted values overwrite the old ones.
For a successful request, the same object is returned in the response.
Recommended FlowIf you want to remove exclusions (but keep inclusions), perform the following steps:
- Fetch the current list of inclusions.
- Send a request to Target ALL (see first example, above).
- Send a request to target the inclusions (obtained in step 1).
INVALID request examples:
{
"collection": [
{
"collection": [],
"type": "EXCLUDE"
}
]
}{
"collection": [
{
"collection": [],
"type": "INCLUDE"
},
{
"collection": [],
"type": "EXCLUDE"
}
]
}{
"http_status": 400,
"message": "Please select an audience",
"offending_field": "retargeting_first_party_audience"
}If the Audience Targeting Object contains a non-empty collection, then at least 1 of the Audience Targeting Restrictions Objects must also contain a non-empty collection.
Rate limit
Rate limitTier 1. Custom audience targeting has its own write budget, separate both from its reads and from every other targeting type.
See Rate limits for the request allowance each tier carries.