Auto-Targeted Publishers

Overview

Occasionally, Smart Bid (aka the Auto Blocker) automatically blocks a publisher that performs poorly, so that it does not impact campaign performance.

You can view this list of suppressed publishers via the readonly auto_publisher_targeting field.

Although you cannot overwrite this list, you can remove 1 or more publishers via a PATCH operation (REMOVE only).

PATCH Flow

1. Use the PATCH verb to submit a Publisher Targeting Patch Object to the 'campaigns' resource (REMOVE only).
2. In the auto_publisher_targeting field, include only the account_ids that you want to remove.

📘

The account_id is an alphabetic string.

Example

STEP 1 - Fetch a campaign and view the auto_publisher_targeting details:

GET /backstage/api/1.0/taboola-demo-advertiser/campaigns/1234

{
   "id": "1234",
   // ...
   "auto_publisher_targeting": {
      "type": "EXCLUDE",
      "value": [
         "demo-publisher-1",
         "demo-publisher-2"
      ],
      "href": null
   }
   // ...
}

📘

This collection is autogenerated and cannot be updated directly.

STEP 2 - PATCH the auto_publisher_targeting (REMOVE only).

The response echoes back the same object that was submitted, but with a full set of fields:

PATCH /backstage/api/1.0/taboola-demo-advertiser/campaigns/1234

{
   "patch_operation": "REMOVE",
   "auto_publisher_targeting": {
      "publishers": [
         "demo-publisher-1"
      ]
   }
}

{
    "patch_operation": "REMOVE",
    "publisher_targeting": null,
    "auto_publisher_targeting": {
        "publishers": [
            "demo-publisher-1"
        ]
    },
    "publisher_bid_modifier": null,
    "publisher_bid_strategy_modifiers": null
}

🚧

REMOVE is the only supported operation.

STEP 3 - Re-fetch the campaign and view the patched auto_publisher_targeting details:

GET /backstage/api/1.0/taboola-demo-advertiser/campaigns/1234

{
   "id": "1234",
   // ...
   "auto_publisher_targeting": {
      "type": "EXCLUDE",
      "value": [
         "demo-publisher-2"
      ],
      "href": null
   }
   // ...
}