Viewability Targeting¶
This article describes resources that enable you to read and define viewability targeting rules.
Overview¶
You can set hard viewability goals for display and video line items. When you set a viewability threshold for a line item, viewability takes precedence over line item delivery, and you can expect line items to achieve and maintain the viewability goal.
The Yahoo DSP supports VIEWABILITY
targeting for lines serving display and video ads.
Endpoint¶
/traffic/lines/{id}/targeting
A
GET
request enables you to view viewability thresholds targeted by the specified line.A
POST
request enables you to target viewability thresholds with the specified line.
Resources¶
The targeting
resource is the standard Yahoo DSP resource for targeting consumers based on their profiles, behaviors, and ad content.
This resource comprises multiple fields that enable you to specify line targeting across many types of targets including the VIEWABILITY
target type.
The targeting
resource is defined by the following VIEWABILITY
targeting type-specific fields:
Parameter |
Parameter Type |
Description |
Data Type |
Required |
---|---|---|---|---|
|
path |
Specifies the line ID. |
|
Y |
|
body |
Specifies the viewability rate threshold expressed as a value between 1-100. |
|
Y [1] |
|
body |
Specifies an array of targeting types to update, enable, or disable.
To learn more, see Targeting Types. |
|
Y |
Note
For a complete list of targeting
resource fields, see Targeting Object.
Add/Update Viewability Targeting¶
Add or update viewability targeting 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¶
{
"inviewThreshold": 1.56,
"types": [
{
"name": "VIEWABILITY",
"isTargeted": true
}
]
}
See also