Bot Targeting¶

This article describes resources that enable you to provide line-level bot fraud protection.

Overview¶

The Verizon Media DSP supports BOT targeting for lines serving display and video ads so that you can ensure your ads are properly represented and delivered to real people, rather than to bot traffic.

Note

Bot targeting is only available via special role.

Endpoint¶

Use the following endpoint to read or specify line-level bot protection settings.

/traffic/lines/{id}/targeting

A GET request enables you to view line-level bot protection for the specified line.
A POST request enables you to add line-level bot protection for the specified line.

Resources¶

The targeting resource is the standard Verizon Media DSP resource for targeting consumers based on their profiles, behaviors, and ad content.

The targeting resource is defined by the following BOT targeting type-specific fields:

Parameter	Parameter Type	Definition	Data Type	Required
`id`	path	Specifies the line ID.	`integer`	Y
`bots`	body	Specifies the bot fraud prevention partner.	`array`	Y
`types`	body	Specifies an array of targeting types to update, enable, or disable. `BOT` targeting type must be specified to apply the changes. To learn more, see Targeting Types.	`array`	Y

Parameter

Parameter Type

Definition

Data Type

Required

id

path

Specifies the line ID.

integer

bots

body

Specifies the bot fraud prevention partner.

array

types

body

Specifies an array of targeting types to update, enable, or disable.

BOT targeting type must be specified to apply the changes.

To learn more, see Targeting Types.

array

Note

For a complete list of targeting resource fields, see Targeting Object.

Add/Update Bot Targeting¶

Add or update bot fraud protection for the specified line.

POST /traffic/lines/{id}/targeting/

Parameters¶

The line ID is specified in the path of the URL. All other parameters are specified in the body of the application/json payload.

Example Request URL¶

POST https://dspapi.admanagerplus.yahoo.com/traffic/lines/365277/targeting/

Example Request Body¶

{
  "bots": [
    "IAS"
  ],
  "types": [
    {
      "name": "BOT",
      "isTargeted": true
    }
  ]
}

Example Response¶

{
  "response": {
    "types": [
      {
        "name": "BOT",
        "isTargeted": true
      }
  ],
  "bots": [
      "IAS"
   ],
   "errors": null,
   "timeStamp": "2018-01-12T01:57:40Z"
  }
}