Player Size Targeting
  • 1 Minute to read

    Player Size Targeting


      Article summary

      This article describes resources that enable you to read and define player size targeting.

      Overview

      The Yahoo DSP supports PLAYER_SIZE targeting for lines serving video ads.

      Endpoint

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

      • A POST request enables you to target player sizes 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 PLAYER_SIZE target type.

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

      Parameter

      Parameter Type

      Description

      Data Type

      Required

      id

      path

      Specifies the line ID.

      integer

      Y

      playerSizes

      body

      For video ads, the platform determines the player size based on height and width (in pixels) specified in the bid request. The platform extracts the larger of the two and assigns a player size:

      • SMALL - Less than 350 pixels.

      • MEDIUM - Between 350 and 500 pixels.

      • LARGE - Greater than 500 pixels.

      • UNKNOWN

      • ALL - All player sizes.

      array

      N

      types

      body

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

      PLAYER_SIZE targeting type must be specified to apply the changes.

      To learn more, refer to Targeting Types.

      array

      Note

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

      Add/Update Player Size Targeting

      Add or update player size 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

      {
        "playerSizes": [
          "SMALL",
          "LARGE"
        ],
        "types": [
          {
            "name": "PLAYER_SIZE",
            "isTargeted": true
          }
        ]
      }

      Example Response

      {
        "response": {
          "types": [
            {
              "name": "PLAYER_SIZE",
              "isTargeted": true
            }
          ],
          "playerSizes": [
            "SMALL",
            "LARGE"
          ],
          "errors": null,
          "timeStamp": "2018-01-12T01:57:40Z"
        }
      }

      Additional Resources

      About Targeting


      Was this article helpful?