Mobile Placement Targeting
  • 1 Minute to read

    Mobile Placement Targeting


      Article summary

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

      Overview

      You can target mobile consumers using all mobile placement types (pre-roll, banner, interstitial, etc.), only interstitial ad placements, or only rewarded ad placements.

      Endpoint

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

      • A POST request enables you to target mobile 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 MOBILE_PLACEMENT target type.

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

      Parameter

      Parameter Type

      Description

      Data Type

      Required

      id

      path

      Specifies the line ID.

      integer

      Y

      mobilePlacements

      body

      Specifies the settings targeted:

      • INTERSTITIAL - Interstitial ads are mobile placements that cover all or most of the user’s screen on an app.

      • REWARDED - Rewarded ads allow users to opt-in to watching, or otherwise consuming, ads in exchange for some kind of benefit (i.e. points, lives, virtual goods, or premium content).

      • ALL - Target all mobile placement types.

      array

      Y

      types

      body

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

      MOBILE_PLACEMENT 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 Mobile Placement Targeting

      Add or update mobile 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

      {
        "mobilePlacements": [
          "INTERSTITIAL"
        ],
        "types": [
          {
            "name": "MOBILE_PLACEMENT",
            "isTargeted": true
          }
        ]
      }

      Example Response

      {
        "response": {
          "types": [
            {
              "name": "MOBILE_PLACEMENT",
              "isTargeted": true
            }
          ],
          "mobilePlacements": [
            "INTERSTITIAL"
          ],
          "errors": null,
          "timeStamp": "2018-01-12T01:57:40Z"
        }
      }

      Additional Resources

      About Targeting


      Was this article helpful?