Ad Frequency Capping


When you set up frequency capping, you set the maximum number of times a given ad can be displayed to any particular person in a particular time period.



Set caps by hour, day, or minute. Max duration is 180 days, 168 hours, or 4400 minutes.

Setting Up with UI

  1. When creating/editing a Creative, in the Delivery Settings --> Distribution section there is a Frequency Capping toggle
  2. Add in the required fields and Save

Setting Up with API

Use the below parameters in the Create Ads request.

The number of times that you would like the frequency cap to occur
How often the frequency cap should occur
Which unit of time you would like frequency capping to occur. Key:
1 = Hour
2 = Day
Optional. If true, opts-it out of frequency cap settings imposed at advertiser, campaign, or flight level



To understand frequency capping, use this formula: Display this advertiser {{FreqCap}} times per {{FreqCapDuration}} {{FreqCapType}}. For instance: Display this advertiser 3 times per 6 hours

Here's an example request for a Create Ads request with frequency cap settings of 10 times per 1 day and which is opted-out of advertiser/campaign/flight level caps.

  "FreqCap": 10,
  "FreqCapDuration": 1,
  "FreqCapType": 2,
  "DontAffectParentFreqCap": true

You can also update the caps with the Update Ad request.