Ad Position Targeting¶
This article describes resources that enable you to read and define ad position targeting.
Overview¶
The Yahoo DSP supports AD_POSITION
targeting for lines serving display ads.
Endpoint¶
/traffic/lines/{id}/targeting
A
GET
request enables you to view ad positions targeted by the specified line.A
POST
request enables you to target ad positions 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.
The targeting
resource is defined by the following AD_POSITION
targeting type-specific fields:
Parameter |
Parameter Type |
Definition |
Data Type |
Required |
---|---|---|---|---|
|
path |
Specifies the line ID. |
|
Y |
|
body |
For display ads, specifies location on the page where the ad appears:
|
|
Y |
|
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 targeting
resource fields, refer to Targeting Object.
Add/Update Ad Position Targeting¶
Add or update ad position targets 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¶
{
"id": 365277,
"positions": [
"ABOVE_FOLD"
],
"types": [
{
"name": "AD_POSITION",
"isTargeted": true
}
]
}
Example Response¶
{
"response": {
"types": [
{
"name": "AD_POSITION",
"isTargeted": true
}
],
"positions": [
"ABOVE_FOLD"
],
"errors": null,
"timeStamp": "2018-01-12T01:57:40Z"
}
}