AdsApp.​FrequencyCaps

FrequencyCaps provides access to each of the frequency cap.

Methods:

MemberTypeDescription
getEntityTypeStringReturns the type of this entity as a String, in this case, "FrequencyCaps".
getFrequencyCapForAdsApp.FrequencyCapGet the frequency cap for the chosen event type and time unit.
newFrequencyCapBuilderAdsApp.FrequencyCapBuilderReturns a new frequency cap builder for the campaign that the frequency caps belong to.
removeFrequencyCapForvoidRemove the frequency cap for the chosen event type and time unit.

getEntityType()

Returns the type of this entity as a String, in this case, "FrequencyCaps".

Return values:

TypeDescription
StringType of this entity: "FrequencyCaps".

getFrequencyCapFor(eventType, timeUnit)

Get the frequency cap for the chosen event type and time unit.

Arguments:

NameTypeDescription
eventTypeStringThe type of event that the cap applies to.
timeUnitStringThe unit of time that the cap applies to. If unspecified, the function returns the first frequency cap applied to the event type.

Return values:

TypeDescription
AdsApp.FrequencyCapThe corresponding frequency cap with the event type and time unit or null if one does not exist.

newFrequencyCapBuilder()

Returns a new frequency cap builder for the campaign that the frequency caps belong to. When FrequencyCapBuilder.build() is called, a frequency cap will be added in this campaign.

Return values:

TypeDescription
AdsApp.FrequencyCapBuilderFrequency cap builder used to create a new frequency cap in the campaign.

removeFrequencyCapFor(eventType, timeUnit)

Remove the frequency cap for the chosen event type and time unit.

Returns nothing.

Arguments:

NameTypeDescription
eventTypeStringThe type of event that the cap applies to. The value can be either IMPRESSION or VIDEO_VIEW.
timeUnitStringThe unit of time that the cap applies to. If unspecified, the function removes all frequency caps applied to the event type.