post
https://backstage.taboola.com/backstage/api/1.0//campaigns//targeting/contextual_segments
Update Contextual Targeting for the specified campaign.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
For a list of Contextual Segments that can be targeted by a given account, see the Dictionary (
dictionary/contextual_segmentsendpoint).
Sample requests
Sample request path
POST USER.SERVER_URL/backstage/api/1.0/demo-account/campaigns/1234/targeting/contextual_segmentsSample request objects
{
"collection": []
}{
"collection": [
{
"collection": [
1900004,
1900024,
1900037
],
"type": "INCLUDE"
}
]
}{
"collection": [
{
"collection": [
1900004,
1900024,
1900037
],
"type": "INCLUDE"
},
{
"collection": [
1905924,
1899997
],
"type": "EXCLUDE"
}
]
}
Guidelines
- Contextual Targeting does not support a PATCH operation.
- To add/remove segments, re-submit the entire collection.
- To remove all segments, submit an empty collection.
- For a given campaign, you can apply an INCLUDE and an EXCLUDE.
For a successful request, the same object is returned in the response.
Campaign Object
Sample request path
GET USER.SERVER_URL/backstage/api/1.0/demo-account/campaigns/1234Sample responses
{
// Other campaign fields omitted..
"contextual_segments_targeting": {
"state": "ALL",
"value": null,
"href": "https://backstage.taboola.com/backstage/api/1.0/demo-account/campaigns/1234/targeting/contextual_segments"
}
}{
// Other campaign fields omitted..
"contextual_segments_targeting": {
"state": "EXISTS",
"value": null,
"href": "https://backstage.taboola.com/backstage/api/1.0/demo-account/campaigns/1234/targeting/contextual_segments"
}
}