Video Ad Placements Targeting

This article describes resources that enable you to read and define video ad placement targeting.

Overview

You can specify where the video ads appear (within video content) or out-stream (outside of a video player, like in article content) using video ad placement targeting.

Endpoint

/traffic/lines/{id}/targeting
  • A GET request enables you to view video ad placement targeted by the specified line.

  • A POST request enables you to target video ad placement 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 VIDEO_PLACEMENT_TYPE target type.

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

Parameter

Parameter Type

Description

Data Type

Required

id

path

Specifies the line ID.

integer

Y

videoAdPlacements

body

Specifies the settings targeted:

  • INSTREAM - Integrated directly into video content that users choose to watch, including pre-roll, mid-roll, and post-roll formats.

  • OUTSTREAM - Displayed outside of a video player, such as within article content or social media feeds, and play automatically when in view, usually with sound muted.

  • UNKNOW - Video ad placement cannot be determined or is not specified.

  • ALL

array

Y

types

body

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

VIDEO_PLACEMENT_TYPE 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 Video Ad Placement Targeting

Add or update video ad placement 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

{
  "videoAdPlacements": [
    "INSTREAM"
  ],
  "types": [
    {
      "name": "VIDEO_PLACEMENT_TYPE",
      "isTargeted": true
    }
  ]
}

Example Response

{
  "response": {
    "types": [
      {
        "name": "VIDEO_PLACEMENT_TYPE",
        "isTargeted": true
      }
    ],
    "videoAdPlacements": [
      "INSTREAM"
    ],
    "errors": null,
    "timeStamp": "2018-01-12T01:57:40Z"
  }
}

Additional Resources

About Targeting