[[["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\u003eA FrequencyCap in Google Ad Manager limits the number of times a viewer sees the same ad within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eIt uses parameters like \u003ccode\u003emaxImpressions\u003c/code\u003e, \u003ccode\u003enumTimeUnits\u003c/code\u003e, and \u003ccode\u003etimeUnit\u003c/code\u003e to define these limits.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etimeUnit\u003c/code\u003e options include minutes, hours, days, weeks, months, and more, offering flexibility in setting frequency caps.\u003c/p\u003e\n"],["\u003cp\u003eThis feature helps control ad exposure and prevent viewer fatigue by managing ad delivery frequency.\u003c/p\u003e\n"]]],["The content defines the `FrequencyCap`, which limits how often a viewer sees a specific `LineItem` within a timeframe. Key elements include `maxImpressions` (maximum impressions served), `numTimeUnits` (quantity of time units), and `timeUnit` (unit of time). The supported `timeUnit` enumerations are MINUTE, HOUR, DAY, WEEK, MONTH, LIFETIME, POD, STREAM, and UNKNOWN. POD and STREAM are specifically for VIDEO_PLAYER environments. Several services are listed including ForecastService, InventoryService, LineItemService, and ProposalLineItemService.\n"],null,["# type FrequencyCap (v202411)\n\n**Service** \n[ForecastService](/ad-manager/api/reference/v202411/ForecastService.FrequencyCap) [InventoryService](/ad-manager/api/reference/v202411/InventoryService.FrequencyCap) **LineItemService** [ProposalLineItemService](/ad-manager/api/reference/v202411/ProposalLineItemService.FrequencyCap) **Dependencies** \n[LineItemSummary](/ad-manager/api/reference/v202411/LineItemService.LineItemSummary) \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/v202411/LineItemService.LineItem) in a specified time period.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202411`\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/v202411/LineItemService.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/v202411/LineItemService.EnvironmentType#VIDEO_PLAYER) environment. `STREAM` : Per video stream. Only valid for entities in a [EnvironmentType.VIDEO_PLAYER](/ad-manager/api/reference/v202411/LineItemService.EnvironmentType#VIDEO_PLAYER) environment. `UNKNOWN` : The value returned if the actual value is not exposed by the requested API version. \u003cbr /\u003e |"]]