Viewability Targeting

  • 3 minute(s) read
Prev Next

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

/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.

array

Y

Note

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

Add/Update Viewability Targeting

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

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

Read Viewability Contextuals

Get a list of all available viewability contextuals.

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

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

Sample Response Body

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

Related articles