Frequency Capping Targeting

Set a limit on how frequently an ad is displayed to a user within a specified time frame.

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

Endpoint

/traffic/lines/{id}/targeting

• Use the GET method to retrieve the target frequency capping configured for the specified line.

• Use the POST method to apply the target frequency capping targeting to a specified line.

Required and Supported Parameters

The targeting resource is defined by the following FREQUENCY_CAPPING targeting type-specific fields.

Line Frequency Cap Object

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

The lineFrequencyCap can be used to set up to 3 layers of frequency capping.

Add/Update Frequency Cap Targeting

Add or update frequency capping controls 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.

Sample Request URL

POST https://dspapi.admanagerplus.yahoo.com/traffic/lines/{id}/targeting/

Sample Request Body

{
   "lineFrequencyCap": {
       "frequencyCapValueMinute": 0,
       "frequencyCapValueHour": 0,
       "frequencyCapPeriodMultiHour": 0,
       "frequencyCapValueMultiHour": 0,
       "frequencyCapValueDay": 5,
       "frequencyCapValueWeek": 6,
       "frequencyCapValueMonth": 7
   },
   "types": [
       {
           "name": "FREQUENCY_CAPPING",
           "isTargeted": true
       }
   ]
}

Sample Response

{
  "response": {
    "lineFrequencyCap": {
      "frequencyCapValueMinute": 0,
      "frequencyCapValueHour": 0,
      "frequencyCapValueDay": 5,
      "frequencyCapValueWeek": 6,
      "frequencyCapValueMonth": 7,
      "frequencyCapPeriodMultiHour": 0,
      "frequencyCapValueMultiHour": 0,
      "lineId": 123456
    },
    "types": [
      {
        "isTargeted": true,
        "name": "FREQUENCY_CAPPING"
      }
    ]
  },
  "errors": null,
  "timeStamp": "2025-09-19T21:35:37.599Z"
}