---
title: "Attention Contextuals Targeting"
slug: "attention-contextuals-targeting"
updated: 2025-10-21T16:29:09Z
published: 2025-10-21T16:29:09Z
canonical: "help.yahooinc.com/attention-contextuals-targeting"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.yahooinc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```plaintext
 /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](/dsp-api/docs/attention-contextuals-targeting#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]
> Note
> 
> For a complete list of `targeting` resource fields, refer to [About Targeting](/dsp-api/docs/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.

```plaintext
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

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

### Sample Response Body

```json
{
  "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.

```plaintext
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

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

### Sample Request Body

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

### Sample Response

```json
{
  "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"
}
```