AdsApp.​FrequencyCaps

AI-generated Key Takeaways

• FrequencyCaps allows access and management of frequency caps within Google Ads campaigns.

• You can retrieve, create, and remove frequency caps for specific event types (like impressions or video views) and time units (like day, week, or month).

• The FrequencyCapBuilder helps create new frequency caps for a campaign, providing flexibility in setting limits.

• getEntityType identifies this entity as "FrequencyCaps" for programmatic access within scripts.

FrequencyCaps provides access to each of the frequency cap.

Methods:

Member	Type	Description
getEntityType()	String	Returns the type of this entity as a String, in this case, "FrequencyCaps".
getFrequencyCapFor(eventType, timeUnit)	AdsApp.FrequencyCap	Get the frequency cap for the chosen event type and time unit.
newFrequencyCapBuilder()	AdsApp.FrequencyCapBuilder	Returns a new frequency cap builder for the campaign that the frequency caps belong to.
removeFrequencyCapFor(eventType, timeUnit)	void	Remove 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:

Type	Description
String	Type of this entity: "FrequencyCaps".

getFrequencyCapFor(eventType, timeUnit)

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

Arguments:

Name	Type	Description
eventType	String	The type of event that the cap applies to.
timeUnit	String	The unit of time that the cap applies to. If unspecified, the function returns the first frequency cap applied to the event type.

Return values:

Type	Description
AdsApp.FrequencyCap	The 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:

Type	Description
AdsApp.FrequencyCapBuilder	Frequency 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:

Name	Type	Description
eventType	String	The type of event that the cap applies to. The value can be either IMPRESSION or VIDEO_VIEW.
timeUnit	String	The unit of time that the cap applies to. If unspecified, the function removes all frequency caps applied to the event type.