- Risorsa: seguente ordine di inserzione
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- Metodi
Risorsa: ordine di inserzione
Un singolo ordine di inserzione.
Rappresentazione JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Campi | |
---|---|
name |
Solo output. Il nome della risorsa dell'ordine di inserzione. |
advertiserId |
Solo output. L'ID univoco dell'inserzionista a cui appartiene l'ordine di inserzione. |
campaignId |
obbligatorio. Immutabile. L'ID univoco della campagna a cui appartiene l'ordine di inserzione. |
insertionOrderId |
Solo output. L'ID univoco dell'ordine di inserzione. Assegnato dal sistema. |
displayName |
obbligatorio. Il nome visualizzato dell'ordine di inserzione. Deve essere codificata in UTF-8 con una dimensione massima di 240 byte. |
insertionOrderType |
Il tipo di ordine di inserzione. Se questo campo non viene specificato durante la creazione, il valore predefinito sarà |
entityStatus |
obbligatorio. Controlla se l'ordine di inserzione può spendere il proprio budget e fare offerte per l'inventario.
|
updateTime |
Solo output. Il timestamp dell'ultimo aggiornamento dell'ordine di inserzione. Assegnato dal sistema. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
partnerCosts[] |
I costi partner associati all'ordine di inserzione. Se il valore non è presente o vuoto nel metodo |
pacing |
obbligatorio. L'impostazione della velocità di spesa del budget dell'ordine di inserzione. |
frequencyCap |
obbligatorio. L'impostazione di quota limite dell'ordine di inserzione. |
integrationDetails |
Ulteriori dettagli di integrazione dell'ordine di inserzione. |
performanceGoal |
obbligatorio. Obiettivo di rendimento dell'ordine di inserzione. |
budget |
obbligatorio. Le impostazioni di allocazione del budget dell'ordine di inserzione. |
bidStrategy |
La strategia di offerta dell'ordine di inserzione. Il campo |
reservationType |
Solo output. Il tipo di prenotazione dell'ordine di inserzione. |
billableOutcome |
Immutabile. Il risultato fatturabile dell'ordine di inserzione. L'acquisto basato sui risultati è stato ritirato. |
InsertionOrderType
Possibili tipi di ordine di inserzione.
Il tipo di ordine di inserzione determina le impostazioni e le opzioni applicabili, ad esempio il formato degli annunci o le opzioni di targeting.
Enum | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
Il tipo di ordine di inserzione non è specificato o è sconosciuto. |
RTB |
Offerte in tempo reale. |
OVER_THE_TOP |
Over-the-top. |
InsertionOrderBudget
Impostazioni che controllano la modalità di allocazione del budget per l'ordine di inserzione.
Rappresentazione JSON |
---|
{ "budgetUnit": enum ( |
Campi | |
---|---|
budgetUnit |
obbligatorio. Immutabile. L'unità del budget specifica se il budget è basato sulla valuta o sulle impressioni. |
automationType |
Il tipo di automazione utilizzato per gestire l'offerta e il budget per l'ordine di inserzione. Se questo campo non viene specificato durante la creazione, il valore predefinito sarà |
budgetSegments[] |
obbligatorio. L'elenco dei segmenti di budget. Utilizza un segmento di budget per specificare un budget specifico per un determinato periodo di tempo in cui è in esecuzione un ordine di inserzione. |
InsertionOrderAutomationType
Possibili opzioni per automatizzare l'offerta dell'ordine di inserzione e il budget.
Enum | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
L'opzione di automazione dell'ordine di inserzione non è specificata o è sconosciuta in questa versione. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Allocazione automatica del budget. Consenti al sistema di spostare automaticamente il budget sugli elementi pubblicitari proprietari per ottimizzare il rendimento definito da performanceGoal . Nessuna automazione sulle impostazioni delle offerte. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Nessuna automazione dell'offerta o del budget a livello di ordine di inserzione. Offerta e budget devono essere configurati manualmente a livello di elemento pubblicitario. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Consenti al sistema di aggiustare automaticamente le offerte e riassegnare il budget ai proprietari degli elementi pubblicitari per ottimizzare il rendimento definito da performanceGoal . |
InsertionOrderBudgetSegment
Impostazioni che controllano il budget di un singolo segmento di budget.
Rappresentazione JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Campi | |
---|---|
budgetAmountMicros |
obbligatorio. L'importo del budget che l'ordine di inserzione spenderà per il |
description |
La descrizione del segmento di budget. Può essere utilizzato per inserire le informazioni degli ordini di acquisto per ogni segmento di budget e fare in modo che vengano stampate sulle fatture. Deve utilizzare la codifica UTF-8. |
dateRange |
obbligatorio. Le impostazioni delle date di inizio e di fine del segmento di budget. Vengono risolti in base al fuso orario dell'inserzionista principale.
|
campaignBudgetId |
Il |
BillableOutcome
Possibili risultati fatturabili per un ordine di inserzione.
Enum | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
Risultato fatturabile non specificato. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
Pagamento per impressioni. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Pagamento per clic. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Pagamento per Visualizzazione attiva. |
Metodi |
|
---|---|
|
Crea un nuovo ordine di inserzione. |
|
Elimina un ordine di inserzione. |
|
Recupera un ordine di inserzione. |
|
Elenca gli ordini di inserzione in un inserzionista. |
|
Elenca le opzioni di targeting assegnate a un ordine di inserzione per tutti i tipi di targeting. |
|
Aggiorna un ordine di inserzione esistente. |