---
title: "Viewability Targeting"
slug: "viewability-targeting"
updated: 2025-10-21T16:39:41Z
published: 2025-10-21T16:39:41Z
canonical: "help.yahooinc.com/viewability-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.

# Viewability Targeting

*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

```plaintext
/traffic/lines/{id}/targeting
```

- A `GET` request enables you to view viewability thresholds targeted by the specified line.
- A `POST` request 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** |
| --- | --- | --- | --- | --- |
| `id` | path | Specifies the line ID. | `integer` | Y |
| `viewabilityVendor` | body | Specifies the viewability provider. Accepted values are: - `YAHOO_VIEWABILITY_TARGETING_MEASUREMENT` - `YAHOO_VIEWABILITY_MEASUREMENT_ONLY` - `DOUBLE_VERIFY_VIEWABILITY` - `IAS_VIEWABILITY` - `IAS_PUBLICIS_VIEWABILITY` - `IAS_GROUPM_VIEWABILITY` | `string` | Y |
| `inviewThreshold` | 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. - `YAHOO_VIEWABILITY_TARGETING_MEASUREMENT` | `number` | Y* |
| `viewabilityContextualId` | body | Specifies the viewability contextual id to be targeted. Only works in conjunction with viewability vendors. - `DOUBLE_VERIFY_VIEWABILITY` - `IAS_VIEWABILITY` - `IAS_PUBLICIS_VIEWABILITY` - `IAS_GROUPM_VIEWABILITY` | `integer` | N |
| `types` | body | Specifies an array of targeting types to update, enable, or disable. `VIEWABILITY` targeting type must be specified to apply the changes. To learn more, refer to [Targeting Types](/dsp-api/docs/about-targeting#targeting-types). | `array` | Y |

> [!NOTE]
> Note
> 
> For a complete list of `targeting` resource fields, refer to [Targeting Object](/dsp-api/docs/about-targeting#targeting-object).

## Add/Update Viewability Targeting

Add or update viewability targeting 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.

### Example Request URL

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

### Example Request Body

```json
{
  "viewabilityVendor": "YAHOO_VIEWABILITY_TARGETING_MEASUREMENT"
  "inviewThreshold": 70.00,
  "types": [
    {
      "name": "VIEWABILITY",
      "isTargeted": true
    }
  ]
}
```

## Read Viewability Contextuals

Get a list of all available viewability contextuals.

```plaintext
GET traffic/contextuals/viewability?taxonomyName={taxonomyType}
```

### Parameters

| Parameter | Description | Data Type | Required |
| --- | --- | --- | --- |
| `taxonomyType` | Specifies the taxonomy type. Accepted values are: - `DOUBLE_VERIFY_VIEWABILITY` - `IAS_VIEWABILITY` - `IAS_PUBLICIS_VIEWABILITY` - `IAS_GROUPM_VIEWABILITY` | `string` | Y |

### Sample Request URL

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

### Sample Response Body

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

[About Targeting](/dsp-api/docs/about-targeting)