Viewability Targeting
- 3 Minutes to read
Viewability Targeting
- 3 Minutes to read
Article summary
Did you find this summary helpful?
Thank you for your feedback!
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}/targetingA
GETrequest enables you to view viewability thresholds targeted by the specified line.A
POSTrequest 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 provider. Accepted values are:
|
| Y |
| body | Specifies the viewability rate threshold expressed as a value between 1-100. Required to add or update a viewability target. Only works in conjunction with viewability vendor.
|
| Y* |
| body | Specifies the viewability contextual id to be targeted. Only works in conjunction with viewability vendors.
|
| N |
| body | Specifies an array of targeting types to update, enable, or disable.
To learn more, refer to Targeting Types. |
| Y |
Note
For a complete list of
targetingresource fields, refer to 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
{
"viewabilityVendor": "YAHOO_VIEWABILITY_TARGETING_MEASUREMENT"
"inviewThreshold": 70.00,
"types": [
{
"name": "VIEWABILITY",
"isTargeted": true
}
]
}Read Viewability Contextuals
Get a list of all available viewability contextuals.
GET traffic/contextuals/viewability?taxonomyName={taxonomyType}Parameters
Parameter | Description | Data Type | Required |
|---|---|---|---|
| Specifies the taxonomy type. Accepted values are:
|
| Y |
Sample Request URL
GET https://dspapi.admanagerplus.yahoo.com/traffic/contextuals/viewability?taxonomyType=DOUBLE_VERIFY_IAB_VIEWABILITYSample Response Body
{
"response": [
{
"name": "All Display Sizes - 80% or Higher Viewability Rate",
"id": 11161,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Display Sizes - 75% or Higher Viewability Rate",
"id": 11162,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Display Sizes - 70% or Higher Viewability Rate",
"id": 11163,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Display Sizes - 65% or Higher Viewability Rate",
"id": 11164,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Display Sizes - 60% or Higher Viewability Rate",
"id": 11165,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Display Sizes - 55% or Higher Viewability Rate",
"id": 11166,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Display Sizes - 50% or Higher Viewability Rate",
"id": 11167,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Display Sizes - 40% or Higher Viewability Rate",
"id": 11168,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Display Sizes - 30% or Higher Viewability Rate",
"id": 11169,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 80% or Higher Viewability Rate",
"id": 11170,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 75% or Higher Viewability Rate",
"id": 11171,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 70% or Higher Viewability Rate",
"id": 11172,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 65% or Higher Viewability Rate",
"id": 11173,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 60% or Higher Viewability Rate",
"id": 11174,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 55% or Higher Viewability Rate",
"id": 11175,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 50% or Higher Viewability Rate",
"id": 11176,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 40% or Higher Viewability Rate",
"id": 11177,
"taxonomyType": "DoubleVerify"
},
{
"name": "All Video Sizes - 30% or Higher Viewability Rate",
"id": 11178,
"taxonomyType": "DoubleVerify"
},
{
"name": "Fully on Screen Video",
"id": 46056,
"taxonomyType": "DoubleVerify"
}
],
"errors": null,
"timeStamp": "2025-10-06T10:34:04.795Z"
}Additional Resources
Was this article helpful?
