- Risorsa: SubscriptionOrder
- 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 è |
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" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
partnerCosts[] |
I costi dei partner associati all'ordine di inserzione. Se il campo |
pacing |
Obbligatorio. L'impostazione della velocità di spesa del budget dell'ordine di inserzione. |
frequencyCap |
Obbligatorio. L'impostazione della 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. Per impostazione predefinita, è impostato il criterio |
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
Tipi possibili di un 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 |
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 degli ordini 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 è |
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. L'offerta e il 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 spostare il budget sugli elementi pubblicitari proprietari 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 informazioni sugli ordini di acquisto per ciascun segmento di budget e stamparle sulle fatture. Deve essere codificata in 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 |
|
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 |
|
---|---|
|
Elenca le opzioni di targeting assegnate di un ordine di inserzione per tutti i tipi di targeting. |
|
Crea un nuovo ordine di inserzione. |
|
Elimina un ordine di inserzione. |
|
Recupera un ordine di inserzione. |
|
Elenca gli ordini di inserzione in un inserzionista. |
|
Consente di aggiornare un ordine di inserzione esistente. |