Mulai
8 September 2025, setiap item baris baru harus menyatakan apakah item baris tersebut akan menayangkan iklan politik Uni Eropa (EU) atau tidak. Upload SDF dan API Display & Video 360 yang tidak memberikan pernyataan akan gagal. Lihat
halaman penghentian penggunaan kami untuk mengetahui detail selengkapnya tentang cara memperbarui integrasi Anda untuk membuat pernyataan ini.
Pacing
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Setelan yang mengontrol kecepatan pembelanjaan anggaran.
Representasi 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 .
} |
Kolom |
pacingPeriod |
enum (PacingPeriod )
Wajib. Jangka waktu saat anggaran kecepatan akan dibelanjakan. Jika alokasi anggaran otomatis diaktifkan di pesan pemasangan iklan melalui automationType , kolom ini hanya output dan default-nya adalah PACING_PERIOD_FLIGHT .
|
pacingType |
enum (PacingType )
Wajib. Jenis kecepatan yang menentukan cara jumlah anggaran akan dibelanjakan di seluruh pacingPeriod . PACING_TYPE_ASAP tidak kompatibel dengan pacingPeriod PACING_PERIOD_FLIGHT untuk pesanan pemasangan iklan.
|
Kolom union daily_max_value . Berlaku saat pacing_period ditetapkan menjadi PACING_PERIOD_DAILY . daily_max_value hanya dapat berupa salah satu dari hal berikut: |
dailyMaxMicros |
string (int64 format)
Jumlah mata uang maksimum yang akan dibelanjakan setiap hari dalam mikro mata uang pengiklan. Berlaku jika anggaran didasarkan pada mata uang. Harus lebih besar dari 0. Misalnya, untuk 1,5 unit standar mata uang, tetapkan kolom ini ke 1500000. Nilai yang ditetapkan akan dibulatkan ke unit yang dapat ditagih utuh untuk mata uang yang relevan dengan aturan berikut: nilai positif apa pun yang kurang dari satu unit yang dapat ditagih akan dibulatkan ke atas menjadi satu unit yang dapat ditagih dan nilai apa pun yang lebih besar dari satu unit yang dapat ditagih akan dibulatkan ke bawah menjadi nilai yang dapat ditagih terdekat. Misalnya, jika unit tagihan mata uang adalah 0,01, dan kolom ini ditetapkan ke 10257770, nilainya akan dibulatkan ke bawah menjadi 10250000, yaitu nilai 10,25. Jika ditetapkan ke 505, nilainya akan dibulatkan ke atas menjadi 10.000, dengan nilai 0,01.
|
dailyMaxImpressions |
string (int64 format)
Jumlah maksimum tayangan iklan yang akan ditayangkan setiap hari. Berlaku jika anggaran didasarkan pada tayangan. Harus lebih besar dari 0.
|
PacingPeriod
Kemungkinan jangka waktu yang digunakan untuk membelanjakan jumlah kecepatan.
Enum |
PACING_PERIOD_UNSPECIFIED |
Nilai periode tidak ditentukan atau tidak diketahui dalam versi ini. |
PACING_PERIOD_DAILY |
Setelan kecepatan akan diterapkan setiap hari. |
PACING_PERIOD_FLIGHT |
Setelan kecepatan akan diterapkan ke seluruh durasi penerbangan. |
PacingType
Kemungkinan jenis kecepatan.
Enum |
PACING_TYPE_UNSPECIFIED |
Nilai mode kecepatan tidak ditentukan atau tidak diketahui dalam versi ini. |
PACING_TYPE_AHEAD |
Hanya berlaku untuk periode kecepatan PACING_PERIOD_FLIGHT . Kecepatan lebih cepat mencoba membelanjakan lebih cepat daripada secara merata, untuk memastikan seluruh anggaran dihabiskan pada akhir periode. |
PACING_TYPE_ASAP |
Belanjakan semua jumlah anggaran kecepatan secepat mungkin. |
PACING_TYPE_EVEN |
Belanjakan jumlah anggaran yang konsisten setiap jangka waktu. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[],["The Display & Video 360 API v4 beta includes settings to control budget spending rates. Key parameters are `pacingPeriod` (timeframe: daily or flight duration) and `pacingType` (spending mode: even, ahead, or ASAP). When `pacingPeriod` is daily, `dailyMaxMicros` or `dailyMaxImpressions` define the maximum daily budget. `dailyMaxMicros` applies to currency-based budgets and must be above zero, values will be rounded to whole billable units. `dailyMaxImpressions` refers to the max number of impressions to serve each day.\n"],null,["# Pacing\n\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/v4/Pacing#PacingPeriod), \"pacingType\": enum (/display-video/api/reference/rest/v4/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/v4/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/v4/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/v4/Pacing#PacingType)`)` Required. The type of pacing that defines how the budget amount will be spent across the [pacingPeriod](/display-video/api/reference/rest/v4/Pacing#FIELDS.pacing_period). `PACING_TYPE_ASAP` is not compatible with [pacingPeriod](/display-video/api/reference/rest/v4/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/v4/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. |"]]