Video Ad Placements Targeting

Specify where video ads appear with the content of web video inventory using video ad placement targeting.

Endpoint

/traffic/lines/{id}/targeting

A GET request enables viewing video ad placements targeted by the specified line.
A POST request enables video ad placement targeting with the specified line.

Resources

The targeting resource is the standard 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. `UNKNOWN` - Video ad placement cannot be determined or is not specified. `ALL` Note: The above parameters will be deprecated in September 2025 and will be replaced with `videoAdPlcmts`.	`array`	Y
`videoAdPlcmts`	body	`INSTREAM` - Pre-roll, mid-roll and post-roll ads that are played before, during or after the streaming video content that the consumer has requested. Instream video must be set to “sound on” by default at player start, or have explicitly clear user intent to watch the video content. While there may be other content surrounding the player, the video content must be the focus of the user’s visit. It should remain the primary content on the page and the only video player in-view capable of audio when playing. If the player converts to floating/sticky subsequent ad calls should accurately convey the updated player size. `ACCOMPANYING_CONTENT` - Pre-roll, mid-roll and post-roll ads that are played before, during, or after streaming video content. The video player loads and plays before, between, or after paragraphs of text or graphical content, and starts playing only when it enters the viewport. Accompanying content should only start playback upon entering the viewport. It may convert to a floating/sticky player as it scrolls off the page. `INTERSTITIAL` - Video ads that are played without video content. During playback, it must be the primary focus of the page and take up the majority of the viewport and cannot be scrolled out of view. This can be in placements like in-app video or slideshows. `NO_CONTENT_STANDALONE` - Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating. `UNKNOWN` - 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.	`array`	Y

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.

Sample Request URL

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

Sample Request Body

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

Sample Response

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