A partire dall'
8 settembre 2025, ogni nuovo elemento pubblicitario dovrà dichiarare se pubblicherà o meno annunci politici dell'Unione Europea (UE). I caricamenti di API Display & Video 360 e SDF che non forniscono dichiarazioni non andranno a buon fine. Consulta la nostra
pagina dei ritiri per ulteriori dettagli su come aggiornare l'integrazione per effettuare questa dichiarazione.
Pacing
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Impostazioni che controllano la frequenza con cui viene speso un budget.
Rappresentazione 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 .
} |
Campi |
pacingPeriod |
enum (PacingPeriod )
Obbligatorio. Il periodo di tempo in cui verrà speso il budget di pacing. Quando l'allocazione automatica del budget è attivata nell'ordine di inserzione tramite automationType , questo campo è solo di output e il valore predefinito è PACING_PERIOD_FLIGHT .
|
pacingType |
enum (PacingType )
Obbligatorio. Il tipo di pacing che definisce la modalità di spesa dell'importo del budget nell'arco del pacingPeriod . PACING_TYPE_ASAP non è compatibile con pacingPeriod PACING_PERIOD_FLIGHT per gli ordini di inserzione.
|
Campo unione daily_max_value . Applicabile quando pacing_period è impostato su PACING_PERIOD_DAILY . daily_max_value può essere solo uno dei seguenti: |
dailyMaxMicros |
string (int64 format)
Importo massimo in micro della valuta dell'inserzionista da spendere ogni giorno. Applicabile quando il budget è basato sulla valuta. Deve essere maggiore di 0. Ad esempio, per 1,5 unità standard della valuta, imposta questo campo su 1500000. Il valore assegnato verrà arrotondato a unità fatturabili intere per la valuta pertinente in base alle seguenti regole: qualsiasi valore positivo inferiore a una singola unità fatturabile verrà arrotondato per eccesso a una unità fatturabile e qualsiasi valore superiore a una singola unità fatturabile verrà arrotondato per difetto al valore fatturabile più vicino. Ad esempio, se l'unità fatturabile della valuta è 0,01 e questo campo è impostato su 10257770, verrà arrotondato per difetto a 10250000, un valore pari a 10,25. Se impostato su 505, verrà arrotondato per eccesso a 10000, un valore di 0,01.
|
dailyMaxImpressions |
string (int64 format)
Numero massimo di impressioni da pubblicare ogni giorno. Applicabile quando il budget è basato sulle impressioni. Deve essere maggiore di 0.
|
PacingPeriod
Possibili periodi di tempo utilizzati per la spesa in base all'importo del pacing.
Enum |
PACING_PERIOD_UNSPECIFIED |
Il valore del periodo non è specificato o è sconosciuto in questa versione. |
PACING_PERIOD_DAILY |
L'impostazione del pacing verrà applicata su base giornaliera. |
PACING_PERIOD_FLIGHT |
L'impostazione del pacing verrà applicata all'intera durata del volo. |
PacingType
Possibili tipi di pacing.
Enum |
PACING_TYPE_UNSPECIFIED |
Il valore della modalità di pacing non è specificato o è sconosciuto in questa versione. |
PACING_TYPE_AHEAD |
Applicabile solo al periodo di pacing PACING_PERIOD_FLIGHT . Il pacing in anticipo tenta di spendere il budget più velocemente del pacing uniforme, per assicurarsi che l'intero budget venga speso entro la fine del periodo di pubblicazione. |
PACING_TYPE_ASAP |
Spendi tutto l'importo del budget di pacing il più rapidamente possibile. |
PACING_TYPE_EVEN |
Spendi un importo di budget costante ogni periodo di tempo. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]