- 1 Minute to read
Frequency Capping Targeting
- 1 Minute to read
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.
Parameter | Description | Data Type | Create | Update |
---|---|---|---|---|
| Specifies the maximum number of impressions to serve per minute. |
| Optional | Optional |
| Specifies the maximum number of impressions to serve per hour. |
| Optional | Optional |
| Specifies the line frequency capping period. Supports 6 hours or 12 hours. Values
|
| Optional | Optional |
| Specifies the maximum number of impressions to serve over 6 or 12 hours. This is required when |
| Optional | Optional |
| Specifies the maximum number of impressions to serve per day. |
| Optional | Optional |
| Specifies the maximum number of impressions to serve per week. |
| Optional | Optional |
| Specifies the maximum number of impressions to serve per month. |
| Optional | Optional |
| Specifies the frequency cap pacing type. Supports EVEN pacing type. Values
| string | Required | Required |
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"
}