Attention Contextuals Targeting

Attention targeting provides the option to target inventory by the amount of attention it is predicted to receive based on the vendor’s precise measure of media quality. To target by attention, select a segment, referred to as an attention target.

Endpoint

 /traffic/lines/{id}/targeting

• GET request  view enables contextuals targeted by the specified line.

• POST request enables you to target contextuals with the specified line.

Resources

Targeting

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

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

Note

For a complete list of targeting resource fields, refer to About Targeting.

Attention Contextuals Payload Object

Read Attention Contextuals

Get a list of all available attention contextuals.

GET traffic/contextuals/attention?taxonomyName={taxonomyType}

Parameters

Sample Request URL

GET https://dspapi.admanagerplus.yahoo.com/traffic/contextuals/attention?taxonomyType=ADELAIDE_ATTENTION

Sample Response Body

{
  "response": [ 
    { 
      "name": "Target High Attention Media" 
      "id": 54066 
    } 
    { 
      "name": "Target High and Medium Attention Media" 
      "id": 54067 
    } 
    { 
      "name": "Target High, Medium and Low Attention Media" 
      "id": 54068 
    } 
  ], 
  "errors": null, 
  "timeStamp": "2025-09-23T22:17:19.047Z"
}

Add/Update Attention Contextuals Targeting

Add or update attention contextual 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.

Sample Request URL

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

Sample Request Body

{
  "id": 365277,
  "attentionContextuals": {
    "clearAll": false,
    "added": [
      366748
    ],
    "removed": []
  },
  "types": [
    {
      "name": "ATTENTION",
      "isTargeted": true
    }
  ]
}

Sample Response

{
  "response": {
    "types": [
      {
        "name": "ATTENTION",
        "isTargeted": true
      }
    ],
      "attentionContextualsIncluded": [
           {
               "id": 54066,
               "name": "Target High Attention Media",
               "taxonomyType": "ADELAIDE_ATTENTION"
           }
       ],
  },
  "errors": null,
  "timeStamp": "2019-10-15T00:54:14.401Z"
}