Video Ad Placements Targeting
  • 1 Minute to read

    Video Ad Placements Targeting


      Article summary

      Specify where video ads appear in-stream (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 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

      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 :mimetype:`application/json` payload.

      Sample Request URL

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

      Sample Request Body

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

      Sample Response

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


      Was this article helpful?