Ad Frequency Capping

🚧

Ad Frequency Capping is in BETA

Overview

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.

Property

Description

FreqCap
(integer)

The number of times that you would like the frequency cap to occur

FreqCapDuration
(integer)

How often the frequency cap should occur

FreqCapType
(integer)

Which unit of time you would like frequency capping to occur. Key:
1 = Hour
2 = Day

DontAffectParentFreqCap
(boolean)

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.

creative={
  "CampaignId":123,
  "Creative":{
    "Id":12345
  },
  "FlightId":1234,
  "IsActive":true,
  "FreqCap": 10,
  "FreqCapDuration": 1,
  "FreqCapType": 2,
  "DontAffectParentFreqCap": true
}

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