Day Parting Targeting
  • 2 Minutes to read

    Day Parting Targeting


      Article summary

      This article describes resources that enable you to read and define day parting targeting.

      Overview

      Day parting enables you to target ad placement opportunities during specific days of the week and hours of the day.

      The days of the week and hours of the day targeted are specified in the dayParting object.

      The Yahoo DSP supports ENHANCED_DAY_PARTING targeting for lines serving display and video ads. Day parting is not supported for lines serving native ads.

      Endpoint

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

      • A POST request enables you to target day parting schedules with the specified line.

      Resources

      Parameter

      Parameter Type

      Description

      Data Type

      Required

      id

      path

      Specifies the line ID.

      integer

      Y

      dayParting

      body

      Specifies a dayParting object that specifies the days and hours targeted.

      The dayParting object consists of multiple arrays representing days of the week. Each day is defined by an array of integers that specify the hours of the day targeted. An empty array targets the entire day. To learn more, refer to Day Parting Object.

      object

      Y

      types

      body

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

      ENHANCED_DAY_PARTING targeting type must be specified to apply the changes.

      To learn more, refer to Targeting Types.

      array

      Y

      Day Parting Object

      The dayParting object defines the days of the week and hours of the day that are targeted by a specific line.

      The dayParting object consists of array objects that represent the days of the week: sunday, monday, tuesday, wednesday, thursday, friday, saturday. Each day-of-the-week array specifies the hours of the day targeted. Valid values are integers between 0 and 23 with 0 representing 12 a.m. and 23 representing 11 p.m.

      If a day-of-the-week array is an empty array or contains all possible values (0-23), the entire day is targeted.

      Field

      Description

      Data Type

      sunday

      An array of integers that specify the hours of the day targeted. Valid values: [0-23].

      array

      monday

      An array of integers that specify the hours of the day targeted. Valid values: [0-23].

      array

      tuesday

      An array of integers that specify the hours of the day targeted. Valid values: [0-23].

      array

      wednesday

      An array of integers that specify the hours of the day targeted. Valid values: [0-23].

      array

      thursday

      An array of integers that specify the hours of the day targeted. Valid values: [0-23].

      array

      friday

      An array of integers that specify the hours of the day targeted. Valid values: [0-23].

      array

      saturday

      An array of integers that specify the hours of the day targeted. Valid values: [0-23].

      array

      Note

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

      Add/Update Day Parting Targeting

      Adds or updates dayParting targets for the specified line.

      POST traffic/lines/{id}/targeting/

      The dayParting object defines the days of the week and hours of the day that are targeted by a specific line. To learn more, see Day Parting Object.

      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/lines/365277/targeting/

      Example Request Body

      {
        "dayParting": {
          "sunday": [],
          "monday": [
            3
          ],
          "tuesday": [
            4,
            5,
            7
          ]
        },
        "types": [
          {
            "name": "ENHANCED_DAY_PARTING",
            "isTargeted": true
          }
        ]
      }

      Example Response

      {
        "response": {
          "types": [
            {
              "name": "ENHANCED_DAY_PARTING",
              "isTargeted": true
            }
          ],
          "dayParting": {
            "monday": [
              3
            ],
            "tuesday": [
              4,
              5,
              7
            ]
          },
          "errors": null,
          "timeStamp": "2018-01-12T01:57:40Z"
        }
      }

      Additional Resources

      About Targeting


      Was this article helpful?