Attention Contextuals Targeting

  • 2 minute(s) read
Prev Next

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:

Parameters

Parameter Type

Definition

Data Type

Required

id

path

Specifies the line ID.

integer

Y

attentionContextuals

body

Specifies attention contextuals to target.

To learn more, refer to Attention Contextuals Payload Object.

array

Y

attentionContextualsIncluded

body

A read-only array that identifies attention contextuals targeted by the line.

array

N/A

types

body

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

ATTENTION targeting type must be specified to apply the changes.

array

Y

Note

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

Attention Contextuals Payload Object

Field

Description

Data Type

added

Attention contextual IDs to add (always targeted).

array

removed

Attention contextual IDs to be removed from targeting.

array

clearAll

Indicates if all existing targeted attention contextuals should be removed. By default, false.

  • If true, remove all targeted attention contextuals. This will disable ATTENTION targeting.

  • If false, do not remove any targeted attention contextuals.

boolean

Read Attention Contextuals

Get a list of all available attention contextuals.

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

Parameters

Parameter

Description

Data Type

Required

taxonomyType

Specifies the taxonomy type.

Accepted value is:

ADELAIDE_ATTENTION

string

Y

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"
}

Related articles