post
https://backstage.taboola.com/backstage/api/1.0//campaigns//targeting/audience_segments
Update Marketplace Audience Targeting (aka Audience Segment 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…
VALID request examples:
{
"collection": []
}{
"collection": [
{
"collection": [
158354,
84965,
15495,
167,
1687024,
3119
],
"type": "INCLUDE"
}
]
}
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.
The following code snippets depict an initial, default state of the Campaign without targeting - followed by its updated state with targeting:
{
// other Campaign fields..
"audience_segments_multi_targeting": {
"state": "ALL",
"value": null,
"href": "https://backstage.taboola.com/backstage/api/1.0/demo-account/campaigns/1234/targeting/audience_segments"
}
}{
// other Campaign fields..
"audience_segments_multi_targeting": {
"state": "EXISTS",
"value": null,
"href": "https://backstage.taboola.com/backstage/api/1.0/demo-account/campaigns/1234/targeting/audience_segments"
}
}INVALID request example:
{
"collection": [
{
"collection": [
158354,
84965,
15495,
167,
1687024,
3119
],
"type": "EXCLUDE"
}
]
}{
"http_status": 400,
"message": "This configuration is not allowed. Contact support to change the campaign's audience targeting settings",
"offending_field": "audience_segments_targeting.collection[0].type"
}
Marketplace Audience Targeting does not support EXCLUDE.
Remove An AudienceTo remove an audience, re-submit a new collection (omitting any relevant audiences).
Remove All AudiencesTo remove all audiences, submit an empty collection.
Rate limit
Rate limitTier 1. Audience segment 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.