type FrequencyCap (v202405)
Represents a limit on the number of times a single viewer can be exposed to the same LineItem in a specified time period.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202405
Field
|
maxImpressions
|
xsd:int
The maximum number of impressions than can be served to a user within a specified time period.
|
numTimeUnits
|
xsd:int
The number of FrequencyCap#timeUnit to represent the total time period.
|
timeUnit
|
TimeUnit
The unit of time for specifying the time period.
Enumerations
-
MINUTE
-
HOUR
-
DAY
-
WEEK
-
MONTH
-
LIFETIME
-
POD
- Per pod of ads in a video stream. Only valid for entities in a
EnvironmentType.VIDEO_PLAYER environment.
-
STREAM
- Per video stream. Only valid for entities in a
EnvironmentType.VIDEO_PLAYER environment.
-
UNKNOWN
- The value returned if the actual value is not exposed by the requested API version.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-05-15 UTC.
[null,null,["Last updated 2024-05-15 UTC."],[[["A FrequencyCap in Google Ad Manager limits the number of times a viewer sees the same line item within a specific timeframe."],["It's defined by the maximum impressions allowed (`maxImpressions`), the time period (`numTimeUnits`), and the unit of time (e.g., hour, day, week) (`timeUnit`)."],["Frequency caps can be applied to various services like ForecastService, InventoryService, LineItemService, and ProposalLineItemService."],["TimeUnit offers flexibility in setting the frequency cap duration, including options like minute, hour, day, week, month, lifetime, and even per pod or stream for video content."]]],["The `FrequencyCap` sets limits on viewer exposure to a `LineItem` within a time frame. Key components include `maxImpressions`, the maximum impressions served to a user. `numTimeUnits` defines the duration's count, and `timeUnit` specifies the unit of time, including minute, hour, day, week, month, lifetime, pod, stream, or unknown. This functionality applies to services like `ForecastService`, `InventoryService`, `LineItemService` and `ProposalLineItemService`, in the context of `LineItemSummary`.\n"]]
