Line Multi-Layer Frequency Capping Targeting¶

This article describes resources you can use to read and define multi-layer frequency capping targeting.

Overview¶

Set a limit on how frequently the platform shows an ad to a user within a specified time frame.

Multi-layer frequency capping is not available for Yahoo Native lines.

The Yahoo DSP supports FREQUENCY_CAPPING targeting for lines serving display and video ads.

Endpoint¶

/traffic/lines/{id}/targeting

Use a GET request to view frequency capping targets by the specified line.
Use a POST request to target frequency capping with the specified line.

Resources¶

Define the targeting resource by the following FREQUENCY_CAPPING targeting type-specific fields:

Line Frequency Cap Object¶

A Line Frequency Cap object defines multi-layer frequency capping for the line.

Use the lineFrequencyCap to set up to 3 layers of frequency capping.

Field	Description	Data Type	Create	Update
`lineFrequencyCapId`	Specifies the line frequency cap ID.	`integer`	N/A	Required
`lineId`	Specifies the line ID.	`integer`	Required	Required
`frequencyCapValueMinute`	Specifies the maximum number of impressions to serve per minute.	`integer`	Optional	Optional
`frequencyCapValueHour`	Specifies the maximum number of impressions to serve per hour.	`integer`	Optional	Optional
`frequencyCapPeriodMultiHour`	Specifies the line frequency capping period. Currently, supports 6 hours and 12 hours.	`integer`	Optional	Optional
`frequencyCapPeriodMultiHour`	Specifies the maximum number of impressions to serve per 6 or 12 hours. This is mandatory when `frequencyCapPeriodMultiHour` is specified.	`integer`	Optional	Optional
`frequencyCapValueDay`	Specifies the maximum number of impressions to serve per day.	`integer`	Optional	Optional
`frequencyCapValueWeek`	Specifies the maximum number of impressions to serve per week.	`integer`	Optional	Optional
`frequencyCapValueMonth`	Specifies the maximum number of impressions to serve per month.	`integer`	Optional	Optional

Note

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

Add/Update Multi-Layer Line Frequency Cap Targeting¶

Add or update frequency capping controls for the specified line.

POST traffic/lines/{id}/targeting/

Parameters¶

Specify the line ID is in the path of the URL. Specify all other parameters in the body of the application/json payload.

Example Request URL¶

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

Example Request Body¶

{
  "lineFrequencyCap": {
    "lineFrequencyCapId": 101,
    "lineId": 365277,
    "frequencyCapValueMinute": 0,
    "frequencyCapValueHour": 0,
    "frequencyCapPeriodMultiHour": 6,
    "frequencyCapValueMultiHour": 2,
    "frequencyCapValueDay": 0,
    "frequencyCapValueWeek": 10,
    "frequencyCapValueMonth": 20
  },
  "serveUnknownUser": true,
  "types": [
    {
      "name": "FREQUENCY_CAPPING",
      "isTargeted": true
    }
  ]
}

Example Response¶

{
  "response": {
    "types": [
      {
        "name": "FREQUENCY_CAPPING",
        "isTargeted": true
      }
    ],
    "lineFrequencyCap": {
      "lineFrequencyCapId": 101,
      "lineId": 365277,
      "frequencyCapValueMinute": 0,
      "frequencyCapValueHour": 0,
      "frequencyCapPeriodMultiHour": 6,
      "frequencyCapValueMultiHour": 2,
      "frequencyCapValueDay": 0,
      "frequencyCapValueWeek": 10,
      "frequencyCapValueMonth": 20
    },
    "serveUnknownUser": true
  },
  "errors": null,
  "timeStamp": "2019-10-20T04:04:25Z"
}

Additional Resources¶

About Targeting