2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은
지원 중단 페이지를 참고하세요.
FrequencyCap
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
특정 기간 동안 사용자에게 동일한 광고가 게재될 수 있는 횟수를 제어하는 설정입니다.
| JSON 표현 |
{
"unlimited": boolean,
"timeUnit": enum (TimeUnit),
"timeUnitCount": integer,
"maxImpressions": integer,
"maxViews": integer
} |
| 필드 |
unlimited |
boolean
게재빈도 제한 없음이 적용되는지 여부입니다. 이 필드가 true로 설정되면 나머지 최대 게재빈도 필드는 적용되지 않습니다.
|
timeUnit |
enum (TimeUnit)
최대 게재빈도가 적용되는 시간 단위입니다. unlimited이 false인 경우에 필요합니다.
|
timeUnitCount |
integer
최대 게재빈도가 지속되는 timeUnit 수입니다. unlimited이 false인 경우에 필요합니다. timeUnit 값에 따라 다음과 같은 제한사항이 적용됩니다.
TIME_UNIT_MONTHS - 1이어야 합니다.TIME_UNIT_WEEKS - 1~4 사이여야 합니다.TIME_UNIT_DAYS - 1~6 사이여야 합니다.TIME_UNIT_HOURS - 1~23 사이여야 합니다.TIME_UNIT_MINUTES - 1~59 사이여야 합니다.
|
maxImpressions |
integer
이 기간 동안 사용자에게 동일한 광고가 게재될 수 있는 최대 횟수입니다. 0보다 커야 합니다. unlimited이 false이고 maxViews가 설정되지 않은 경우 필요합니다.
|
maxViews |
integer
선택사항입니다. 이 기간 동안 사용자가 광고를 더 이상 게재되지 않을 때까지 클릭하거나 완전히 볼 수 있는 최대 횟수입니다. 0보다 커야 합니다. YouTube 및 파트너 리소스에만 적용됩니다. unlimited이 false이고 maxImpressions가 설정되지 않은 경우 필요합니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eFrequency capping settings determine how often a user sees the same ad within a specific timeframe.\u003c/p\u003e\n"],["\u003cp\u003eThese settings offer control over the maximum impressions or views a user receives within a defined period.\u003c/p\u003e\n"],["\u003cp\u003eYou can set frequency caps based on various time units (lifetime, months, weeks, days, hours, minutes) and limits.\u003c/p\u003e\n"],["\u003cp\u003eThe "unlimited" option bypasses other frequency cap settings, allowing for unlimited ad exposure.\u003c/p\u003e\n"],["\u003cp\u003eFor YouTube and Partner resources, you can set limits for both impressions (ad displays) and views (clicks or full views).\u003c/p\u003e\n"]]],[],null,["# FrequencyCap\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nSettings that control the number of times a user may be shown with the same ad during a given time period.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"unlimited\": boolean, \"timeUnit\": enum (/display-video/api/reference/rest/v3/TimeUnit), \"timeUnitCount\": integer, \"maxImpressions\": integer, \"maxViews\": integer } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `unlimited` | `boolean` Whether unlimited frequency capping is applied. When this field is set to `true`, the remaining frequency cap fields are not applicable. |\n| `timeUnit` | `enum (`[TimeUnit](/display-video/api/reference/rest/v3/TimeUnit)`)` The time unit in which the frequency cap will be applied. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false`. |\n| `timeUnitCount` | `integer` The number of [timeUnit](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.time_unit) the frequency cap will last. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false`. The following restrictions apply based on the value of [timeUnit](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.time_unit): - `TIME_UNIT_MONTHS` - must be 1 - `TIME_UNIT_WEEKS` - must be between 1 and 4 - `TIME_UNIT_DAYS` - must be between 1 and 6 - `TIME_UNIT_HOURS` - must be between 1 and 23 - `TIME_UNIT_MINUTES` - must be between 1 and 59 |\n| `maxImpressions` | `integer` The maximum number of times a user may be shown the same ad during this period. Must be greater than 0. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false` and [maxViews](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.max_views) is not set. |\n| `maxViews` | `integer` Optional. The maximum number of times a user may click-through or fully view an ad during this period until it is no longer served to them. Must be greater than 0. Only applicable to YouTube and Partners resources. Required when [unlimited](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.unlimited) is `false` and [maxImpressions](/display-video/api/reference/rest/v3/FrequencyCap#FIELDS.max_impressions) is not set. |"]]
