2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은
지원 중단 페이지를 참고하세요.
Pacing
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
JSON 표현 |
{
"pacingPeriod": enum (PacingPeriod ),
"pacingType": enum (PacingType ),
// Union field daily_max_value can be only one of the following:
"dailyMaxMicros": string,
"dailyMaxImpressions": string
// End of list of possible types for union field daily_max_value .
} |
필드 |
pacingPeriod |
enum (PacingPeriod )
필수 항목입니다. 속도 예산이 지출되는 기간입니다. automationType 를 통해 게재 신청서에서 자동 예산 할당이 사용 설정된 경우 이 필드는 출력 전용이며 기본값은 PACING_PERIOD_FLIGHT 입니다.
|
pacingType |
enum (PacingType )
필수 항목입니다. pacingPeriod 에서 예산 금액이 지출되는 방식을 정의하는 속도 유형입니다. PACING_TYPE_ASAP 은(는) 게재 신청서의 pacingPeriod PACING_PERIOD_FLIGHT 와 호환되지 않습니다.
|
통합 필드 daily_max_value . pacing_period 가 PACING_PERIOD_DAILY 로 설정된 경우에 적용됩니다. daily_max_value 은 다음 중 하나여야 합니다. |
dailyMaxMicros |
string (int64 format)
광고주의 통화로 매일 지출할 수 있는 최대 통화 금액(마이크로 단위)입니다. 예산이 통화 기반인 경우에 적용됩니다. 0보다 커야 합니다. 예를 들어 통화의 표준 단위가 1.5인 경우 이 필드를 1500000으로 설정합니다. 할당된 값은 다음 규칙에 따라 관련 통화의 청구 가능 단위로 반올림됩니다. 청구 가능 단위 1개 미만의 양수 값은 청구 가능 단위 1개로 올림되고 청구 가능 단위 1개를 초과하는 값은 가장 가까운 청구 가능 값으로 내림됩니다. 예를 들어 통화의 청구 단위가 0.01이고 이 필드가 10257770으로 설정된 경우 10250000(10.25)으로 내림합니다. 505로 설정하면 0.01의 값인 10,000으로 반올림됩니다.
|
dailyMaxImpressions |
string (int64 format)
매일 게재할 최대 노출수입니다. 예산이 노출 기반인 경우에 적용됩니다. 0보다 커야 합니다.
|
PacingPeriod
속도 금액에 지출하는 데 사용되는 가능한 기간입니다.
열거형 |
PACING_PERIOD_UNSPECIFIED |
이 버전에서 기간 값이 지정되지 않았거나 알 수 없습니다. |
PACING_PERIOD_DAILY |
예산 소진 속도 설정은 매일 적용됩니다. |
PACING_PERIOD_FLIGHT |
속도 설정은 전체 비행 시간에 적용됩니다. |
PacingType
열거형 |
PACING_TYPE_UNSPECIFIED |
이 버전에서 속도 모드 값이 지정되지 않았거나 알 수 없습니다. |
PACING_TYPE_AHEAD |
PACING_PERIOD_FLIGHT 속도 설정 기간에만 적용됩니다. '빨리' 예산 소진 속도는 전체 예산이 광고 게재 기간이 끝나기 전에 지출되도록 균등 지출보다 빠른 지출을 시도합니다. |
PACING_TYPE_ASAP |
최대한 빨리 전체 예산을 소진합니다. |
PACING_TYPE_EVEN |
일정한 기간마다 일정한 예산 금액을 지출합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003ePacing settings manage the rate at which a budget is spent, either daily or over the entire campaign duration.\u003c/p\u003e\n"],["\u003cp\u003eYou can control spending by setting daily limits for currency or impressions.\u003c/p\u003e\n"],["\u003cp\u003ePacing types allow you to spend evenly, quickly ("ASAP"), or ahead of schedule to exhaust the budget by the campaign's end.\u003c/p\u003e\n"],["\u003cp\u003eStarting November 5, 2024, the "ASAP" pacing type will no longer work with campaign-duration pacing for insertion orders.\u003c/p\u003e\n"]]],["Pacing settings control budget spending rates, defined by `pacingPeriod` and `pacingType`. `pacingPeriod` specifies the time frame (daily or flight duration), with `PACING_PERIOD_FLIGHT` as the default for automated budget allocation. `pacingType` dictates spending behavior (ASAP, ahead, or evenly), with `PACING_TYPE_ASAP` being incompatible with `PACING_PERIOD_FLIGHT`. For daily pacing, `dailyMaxMicros` sets the maximum daily currency spending, and `dailyMaxImpressions` sets the maximum number of daily impressions.\n"],null,["# Pacing\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- [PacingPeriod](#PacingPeriod)\n- [PacingType](#PacingType)\n\nSettings that control the rate at which a budget is spent.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"pacingPeriod\": enum (/display-video/api/reference/rest/v3/Pacing#PacingPeriod), \"pacingType\": enum (/display-video/api/reference/rest/v3/Pacing#PacingType), // Union field `daily_max_value` can be only one of the following: \"dailyMaxMicros\": string, \"dailyMaxImpressions\": string // End of list of possible types for union field `daily_max_value`. } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pacingPeriod` | `enum (`[PacingPeriod](/display-video/api/reference/rest/v3/Pacing#PacingPeriod)`)` Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via [automationType](/display-video/api/reference/rest/v3/advertisers.insertionOrders#InsertionOrderBudget.FIELDS.automation_type), this field is output only and defaults to `PACING_PERIOD_FLIGHT`. |\n| `pacingType` | `enum (`[PacingType](/display-video/api/reference/rest/v3/Pacing#PacingType)`)` Required. The type of pacing that defines how the budget amount will be spent across the [pacingPeriod](/display-video/api/reference/rest/v3/Pacing#FIELDS.pacing_period). `PACING_TYPE_ASAP` is not compatible with [pacingPeriod](/display-video/api/reference/rest/v3/Pacing#FIELDS.pacing_period) `PACING_PERIOD_FLIGHT` for insertion orders. |\n| Union field `daily_max_value`. Applicable when [pacing_period](/display-video/api/reference/rest/v3/Pacing#FIELDS.pacing_period) is set to be `PACING_PERIOD_DAILY`. `daily_max_value` can be only one of the following: ||\n| `dailyMaxMicros` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Maximum currency amount to spend every day in micros of advertiser's currency. Applicable when the budget is currency based. Must be greater than 0. For example, for 1.5 standard unit of the currency, set this field to 1500000. The value assigned will be rounded to whole billable units for the relevant currency by the following rules: any positive value less than a single billable unit will be rounded up to one billable unit and any value larger than a single billable unit will be rounded down to the nearest billable value. For example, if the currency's billable unit is 0.01, and this field is set to 10257770, it will round down to 10250000, a value of 10.25. If set to 505, it will round up to 10000, a value of 0.01. |\n| `dailyMaxImpressions` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Maximum number of impressions to serve every day. Applicable when the budget is impression based. Must be greater than 0. |\n\nPacingPeriod\n------------\n\nPossible time periods used to spend to the pacing amount.\n\n| Enums ||\n|-----------------------------|------------------------------------------------------------------|\n| `PACING_PERIOD_UNSPECIFIED` | Period value is not specified or is unknown in this version. |\n| `PACING_PERIOD_DAILY` | The pacing setting will be applied on daily basis. |\n| `PACING_PERIOD_FLIGHT` | The pacing setting will be applied to the whole flight duration. |\n\nPacingType\n----------\n\nPossible pacing types.\n\n| Enums ||\n|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `PACING_TYPE_UNSPECIFIED` | Pacing mode value is not specified or is unknown in this version. |\n| `PACING_TYPE_AHEAD` | Only applicable to `PACING_PERIOD_FLIGHT` pacing period. Ahead pacing attempts to spend faster than evenly, to make sure the entire budget is spent by the end of the flight. |\n| `PACING_TYPE_ASAP` | Spend all of pacing budget amount as quick as possible. |\n| `PACING_TYPE_EVEN` | Spend a consistent budget amount every period of time. |"]]