post
https://backstage.taboola.com/backstage/api/1.0//campaigns//targeting/my_audiences
Update My Audience Targeting for the specified campaign.
My Audience Targeting supports both First Party Audiences and Custom Audiences.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Request
- My Audience Targeting supports both First Party Audiences and Custom Audiences.
- The Custom Audiences are the same as those used by Custom Audience Targeting, but have different Audience IDs.
You can specify both INCLUDE and EXCLUDE.For example, you might want to 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 (applies an 'AND' operator).
VALID request examples:
(Follow the examples from left to right...)
{
"collection": []
}{
"collection": [
{
"collection": [
1713658,
151037
],
"type": "INCLUDE"
}
]
}{
"collection": [
{
"collection": [
1713658,
151037
],
"type": "INCLUDE"
},
{
"collection": [
1898703,
1918825,
1918824
],
"type": "EXCLUDE"
}
]
}{
"collection": [
{
"collection": [
1713658,
151037
],
"type": "INCLUDE"
},
{
"collection": [],
"type": "EXCLUDE"
}
]
}{
"collection": [
{
"collection": [
1713658,
151037
],
"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"
}
At least 1 of the Audience Targeting Restrictions objects must contain a non-empty collection.