[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eThe FrequencyCap object in Google Ad Manager's ForecastService represents a limit on the number of times an ad is shown to a single viewer.\u003c/p\u003e\n"],["\u003cp\u003eIt uses \u003ccode\u003emaxImpressions\u003c/code\u003e, \u003ccode\u003enumTimeUnits\u003c/code\u003e, and \u003ccode\u003etimeUnit\u003c/code\u003e to define the frequency cap's limits and timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etimeUnit\u003c/code\u003e can range from minutes to a user's lifetime and also includes specific options like pods and streams for video content.\u003c/p\u003e\n"],["\u003cp\u003eFrequency caps help manage ad exposure, preventing viewer fatigue and ensuring campaign effectiveness.\u003c/p\u003e\n"]]],["The `FrequencyCap` feature limits how often a viewer sees a specific `LineItem` within a set timeframe. Key fields include `maxImpressions` (maximum impressions), `numTimeUnits` (total time period), and `timeUnit` (unit of time). Time units can be minutes, hours, days, weeks, months, or the entire lifetime. It also supports `POD` or `STREAM` which are for video stream specific environments. This applies to `ForecastService` and related services.\n"],null,["# type FrequencyCap (v202408)\n\n**Service** \n**ForecastService** [InventoryService](/ad-manager/api/reference/v202408/InventoryService.FrequencyCap) [LineItemService](/ad-manager/api/reference/v202408/LineItemService.FrequencyCap) [ProposalLineItemService](/ad-manager/api/reference/v202408/ProposalLineItemService.FrequencyCap) **Dependencies** \n[LineItemSummary](/ad-manager/api/reference/v202408/ForecastService.LineItemSummary) [ProposalLineItem](/ad-manager/api/reference/v202408/ForecastService.ProposalLineItem) \n▼\n**FrequencyCap**\n\nRepresents a limit on the number of times a single viewer can be exposed to the same [LineItem](/ad-manager/api/reference/v202408/ForecastService.LineItem) in a specified time period.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `maxImpressions` | ` `xsd:`int` The maximum number of impressions than can be served to a user within a specified time period. |\n| ### `numTimeUnits` | ` `xsd:`int` The number of `FrequencyCap#timeUnit` to represent the total time period. |\n| ### `timeUnit` | ` `[TimeUnit](/ad-manager/api/reference/v202408/ForecastService.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](/ad-manager/api/reference/v202408/ForecastService.EnvironmentType#VIDEO_PLAYER) environment. `STREAM` : Per video stream. Only valid for entities in a [EnvironmentType.VIDEO_PLAYER](/ad-manager/api/reference/v202408/ForecastService.EnvironmentType#VIDEO_PLAYER) environment. `UNKNOWN` : The value returned if the actual value is not exposed by the requested API version. \u003cbr /\u003e |"]]
