Publisher Targeting (Blocking)

Overview

You can block publishers at the campaign level - this topic describes some typical flows.

πŸ“˜

You can also block publishers at the account level (i.e. for all campaigns). See: Account Level Blocking.

Flow

Update Targeting

  1. Use the campaigns endpoint to update the publisher_targeting field:
POST /backstage/api/1.0/demo-advertiser/campaigns/1234
{
   "publisher_targeting": {
      "type": "EXCLUDE",
      "value": [
         "demo-publisher-1",
         "demo-publisher-2",
         "demo-publisher-3"
      ]
   }
}

πŸ“˜

Publisher Networks

  • Blocking of publisher networks is not supported via the API.
  • When you apply campaign-level publisher targeting, the API will first strip out any network ids - and then suppress the remaining publisher ids.
  • If you need to block a publisher network, reach out to your Taboola Account Manager.

πŸ“˜

Publisher targeting supports EXCLUDE (suppression) only. The INCLUDE operation is not supported.

  1. In the updated Campaign Object, the value property stores the targeted collection:
{
   // other Campaign fields...
   "publisher_targeting": {
      "type": "EXCLUDE",
      "value": [
         "demo-publisher-1",
         "demo-publisher-2",
         "demo-publisher-3"
      ],
      "href": null
   }
}

πŸ“˜

Blocked at both levels

  • Publishers blocked at both the campaign and account levels, show at the account level only. (They are not returned by the campaigns endpoint.)
  • The same holds true for a network blocked at the account level. Campaign-level blocks (for any publishers under that network) are not returned by the campaigns endpoint.
  • Blocking of publisher networks is not supported via the API. (If do you need to block a publisher network, please reach out to your Taboola Account Manager.)

Remove Targeting (Target ALL)

  1. Use the campaigns endpoint to submit a type property of "ALL":
POST /backstage/api/1.0/demo-advertiser/campaigns/1234
{
   "publisher_targeting": {
      "type": "ALL"
   }
}
  1. In the updated Campaign Object, the value property is now an empty collection:
{
   // other Campaign fields...
   "publisher_targeting": {
      "type": "ALL",
      "value": [],
      "href": null
   }
}

πŸ“˜

For the publisher_targeting field, href is always null.

Patch Targeting

An update operation (above) overwrites any existing targeting. You can also patch the existing targeting (without re-submitting the entire collection). See: Patching Targeted Publishers.