- Risorsa: elemento pubblicitario
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- Piattaforma
- Metodi
Risorsa: elemento pubblicitario
Un singolo elemento pubblicitario.
Rappresentazione JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Campi | |
---|---|
name |
Solo output. Il nome della risorsa dell'elemento pubblicitario. |
advertiserId |
Solo output. L'ID univoco dell'inserzionista a cui appartiene l'elemento pubblicitario. |
campaignId |
Solo output. L'ID univoco della campagna a cui appartiene l'elemento pubblicitario. |
insertionOrderId |
Obbligatorio. Immutabile. L'ID univoco dell'ordine di inserzione a cui appartiene l'elemento pubblicitario. |
lineItemId |
Solo output. L'ID univoco dell'elemento pubblicitario. Assegnato dal sistema. |
displayName |
Obbligatorio. Il nome visualizzato dell'elemento pubblicitario. Deve essere codificata in UTF-8 con una dimensione massima di 240 byte. |
lineItemType |
Obbligatorio. Immutabile. Il tipo di elemento pubblicitario. |
entityStatus |
Obbligatorio. Controlla se l'elemento pubblicitario può spendere il budget e fare offerte per l'inventario.
|
updateTime |
Solo output. Il timestamp dell'ultimo aggiornamento dell'elemento pubblicitario. Assegnato dal sistema. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
partnerCosts[] |
I costi partner associati all'elemento pubblicitario. Se non è presente o è vuota nel metodo |
flight |
Obbligatorio. L'ora di inizio e di fine del periodo di pubblicazione dell'elemento pubblicitario. |
budget |
Obbligatorio. L'impostazione di allocazione del budget dell'elemento pubblicitario. |
pacing |
Obbligatorio. L'impostazione della velocità di spesa del budget dell'elemento pubblicitario. |
frequencyCap |
Obbligatorio. Le impostazioni della quota limite delle impressioni dell'elemento pubblicitario. Il campo |
partnerRevenueModel |
Obbligatorio. L'impostazione del modello di entrate del partner dell'elemento pubblicitario. |
conversionCounting |
L'impostazione del monitoraggio delle conversioni dell'elemento pubblicitario. |
creativeIds[] |
Gli ID delle creatività associate all'elemento pubblicitario. |
bidStrategy |
Obbligatorio. La strategia di offerta dell'elemento pubblicitario. |
integrationDetails |
Dettagli di integrazione dell'elemento pubblicitario. |
inventorySourceIds[] |
Gli ID delle origini dell'inventario private assegnate all'elemento pubblicitario. |
targetingExpansion |
Le impostazioni di targeting ottimizzato dell'elemento pubblicitario. Questa configurazione è applicabile solo agli elementi pubblicitari display, video o audio che utilizzano le offerte automatiche e hanno come target elenchi dei segmenti di pubblico idonei. |
warningMessages[] |
Solo output. I messaggi di avviso generati dall'elemento pubblicitario. Questi avvisi non bloccano il salvataggio dell'elemento pubblicitario, ma alcuni potrebbero bloccarne l'esecuzione. |
mobileApp |
L'app mobile promossa dall'elemento pubblicitario. Questo si applica solo quando |
reservationType |
Solo output. Il tipo di prenotazione dell'elemento pubblicitario. |
excludeNewExchanges |
Indica se escludere le nuove piattaforme di scambio dal targeting automatico dell'elemento pubblicitario. Per impostazione predefinita, questo campo è impostato su false. |
LineItemType
I possibili tipi di un elemento pubblicitario.
Il tipo di elemento pubblicitario determina le impostazioni e le opzioni applicabili, come il formato degli annunci o le opzioni di targeting.
Enum | |
---|---|
LINE_ITEM_TYPE_UNSPECIFIED |
Il valore del tipo non è specificato o è sconosciuto in questa versione. Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API. |
LINE_ITEM_TYPE_DISPLAY_DEFAULT |
Annunci illustrati, HTML5, nativi o rich media. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
Annunci display che generano installazioni di un'app. |
LINE_ITEM_TYPE_VIDEO_DEFAULT |
Annunci video venduti su base CPM per diversi ambienti. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL |
Annunci video che generano installazioni di un'app. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY |
Annunci display pubblicati nell'inventario per app mobile. Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY |
Annunci video pubblicati nell'inventario per app mobile. Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
Annunci audio RTB venduti per diversi ambienti. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
Annunci over-the-top presenti negli ordini di inserzione OTT. Questo tipo è applicabile solo agli elementi pubblicitari con un ordine di inserzione di insertionOrderType OVER_THE_TOP . |
LineItemFlight
Impostazioni che controllano la durata attiva di un elemento pubblicitario.
Rappresentazione JSON |
---|
{ "flightDateType": enum ( |
Campi | |
---|---|
flightDateType |
Obbligatorio. Il tipo di periodo di pubblicazione dell'elemento pubblicitario. |
dateRange |
Le date di inizio e di fine del periodo di pubblicazione dell'elemento pubblicitario. Vengono risolti in base al fuso orario dell'inserzionista principale.
|
triggerId |
L'ID dell'attivazione manuale associato all'elemento pubblicitario.
Avviso: gli elementi pubblicitari che utilizzano attivatori manuali non vengono più pubblicati in Display & Video a 360°. Questo campo verrà ritirato il 1° agosto 2023. Per ulteriori informazioni, leggi il nostro annuncio sul ritiro delle funzionalità. |
LineItemFlightDateType
Possibili tipi di periodo di pubblicazione di un elemento pubblicitario.
Enum | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
Il valore del tipo non è specificato o è sconosciuto in questa versione. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
Il periodo di pubblicazione dell'elemento pubblicitario viene ereditato dall'ordine di inserzione principale. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
L'elemento pubblicitario utilizza il proprio periodo di pubblicazione personalizzato. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
L'elemento pubblicitario utilizza un attivatore. Avviso: gli elementi pubblicitari che utilizzano attivatori manuali non vengono più pubblicati in Display & Video a 360°. Questo valore verrà ritirato il 1° agosto 2023. Per ulteriori informazioni, leggi il nostro annuncio sul ritiro delle funzionalità. |
LineItemBudget
Impostazioni che controllano la modalità di allocazione del budget.
Rappresentazione JSON |
---|
{ "budgetAllocationType": enum ( |
Campi | |
---|---|
budgetAllocationType |
Obbligatorio. Il tipo di allocazione del budget.
|
budgetUnit |
Solo output. L'unità budget specifica se il budget è basato sulla valuta o sull'impressione. Questo valore è ereditato dall'ordine di inserzione principale. |
maxAmount |
L'importo massimo del budget che l'elemento pubblicitario spenderà. Deve essere maggiore di 0. Quando
|
LineItemBudgetAllocationType
Possibili tipi di allocazione del budget.
Enum | |
---|---|
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED |
Il valore del tipo non è specificato o è sconosciuto in questa versione. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC |
L'allocazione automatica del budget è abilitata per l'elemento pubblicitario. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED |
All'elemento pubblicitario viene allocato un importo fisso per il budget massimo. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
Nessun limite di budget applicato all'elemento pubblicitario. |
PartnerRevenueModel
Impostazioni che controllano il modo in cui vengono calcolate le entrate del partner.
Rappresentazione JSON |
---|
{
"markupType": enum ( |
Campi | |
---|---|
markupType |
Obbligatorio. Il tipo di markup del modello di entrate del partner. |
markupAmount |
Obbligatorio. L'importo del markup del modello di entrate del partner. Deve essere maggiore o uguale a 0.
|
PartnerRevenueModelMarkupType
Possibili tipi di markup del modello di entrate del partner.
Enum | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED |
Il valore del tipo non è specificato o è sconosciuto in questa versione. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM |
Calcola le entrate del partner in base a un CPM fisso. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP |
Calcola le entrate del partner in base a un supplemento percentuale del costo dei media. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
Calcola le entrate del partner in base a un supplemento percentuale del costo dei media totale, che include tutti i costi del partner e i costi dei dati. |
ConversionCountingConfig
Impostazioni che controllano la modalità di conteggio delle conversioni.
Verranno conteggiate tutte le conversioni post-clic. È possibile impostare un valore percentuale per il conteggio delle conversioni post-visualizzazione.
Rappresentazione JSON |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Campi | |
---|---|
postViewCountPercentageMillis |
La percentuale di conversioni post-visualizzazione da conteggiare, in migliaia (1/1000 di una percentuale). Il valore deve essere compreso tra 0 e 100.000 (inclusi). Ad esempio, per monitorare il 50% delle conversioni post clic, imposta il valore 50.000. |
floodlightActivityConfigs[] |
Le configurazioni dell'attività Floodlight utilizzate per monitorare le conversioni. Il numero di conversioni conteggiate è la somma di tutte le conversioni conteggiate da tutti gli ID attività Floodlight specificati in questo campo. |
TrackingFloodlightActivityConfig
Impostazioni che controllano il comportamento di una singola configurazione attività Floodlight.
Rappresentazione JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
Campi | |
---|---|
floodlightActivityId |
Obbligatorio. L'ID dell'attività Floodlight. |
postClickLookbackWindowDays |
Obbligatorio. Il numero di giorni successivi al clic su un annuncio entro i quali può essere conteggiata una conversione. Il valore deve essere compreso tra 0 e 90 (inclusi). |
postViewLookbackWindowDays |
Obbligatorio. Il numero di giorni successivi alla visualizzazione di un annuncio durante i quali può essere conteggiata una conversione. Il valore deve essere compreso tra 0 e 90 (inclusi). |
TargetingExpansionConfig
Impostazioni che controllano le impostazioni di targeting ottimizzato dell'elemento pubblicitario.
Rappresentazione JSON |
---|
{
"targetingExpansionLevel": enum ( |
Campi | |
---|---|
targetingExpansionLevel |
Obbligatorio. Indica se il targeting ottimizzato è attivo. Questo campo supporta i seguenti valori:
Se questo campo viene impostato su qualsiasi altro valore, verrà automaticamente impostato su
|
excludeFirstPartyAudience |
Indica se escludere i segmenti di pubblico proprietari dall'utilizzo nell'espansione del targeting. Questo campo è stato ritirato con il lancio del targeting ottimizzato. Questo campo verrà impostato su |
TargetingExpansionLevel
L'impostazione Targeting ottimizzato.
Enum | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
L'impostazione del targeting ottimizzato non è specificata o è sconosciuta in questa versione. |
NO_EXPANSION |
Il targeting ottimizzato è disattivato. |
LEAST_EXPANSION |
Il targeting ottimizzato è attivo. |
SOME_EXPANSION |
Se utilizzato, verrà impostato automaticamente su |
BALANCED_EXPANSION |
Se utilizzato, verrà impostato automaticamente su |
MORE_EXPANSION |
Se utilizzato, verrà impostato automaticamente su |
MOST_EXPANSION |
Se utilizzato, verrà impostato automaticamente su |
LineItemWarningMessage
I messaggi di avviso generati da un elemento pubblicitario. Questi tipi di avvisi non bloccano il salvataggio di un elemento pubblicitario, ma potrebbero bloccarne l'esecuzione.
Enum | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Non specificato o sconosciuto. |
INVALID_FLIGHT_DATES |
Il periodo di pubblicazione di questo elemento pubblicitario non è valido. L'elemento pubblicitario non verrà pubblicato. |
EXPIRED |
La data di fine di questo elemento pubblicitario è nel passato. |
PENDING_FLIGHT |
L'esecuzione di questo elemento pubblicitario inizierà in futuro. |
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED |
Nessuna piattaforma attivata dal partner è stata scelta come target. L'elemento pubblicitario non verrà pubblicato. |
INVALID_INVENTORY_SOURCE |
Nessuna origine dell'inventario attiva è stata scelta come target. L'elemento pubblicitario non verrà pubblicato. |
APP_INVENTORY_INVALID_SITE_TARGETING |
Le app e le impostazioni di Il targeting per URL non include app mobile. Il tipo di questo elemento pubblicitario richiede l'inclusione di app mobile nel tuo canale, elenco di siti o targeting per app. L'elemento pubblicitario non verrà pubblicato. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
Per questo elemento pubblicitario non è stato scelto come target alcun utente di dispositivi mobili. Questo tipo di elemento pubblicitario richiede come target un elenco di utenti di dispositivi mobili. L'elemento pubblicitario non verrà pubblicato. |
NO_VALID_CREATIVE |
Questo elemento pubblicitario non contiene creatività valide. L'elemento pubblicitario non verrà pubblicato. |
PARENT_INSERTION_ORDER_PAUSED |
L'ordine di inserzione di questo elemento pubblicitario è in pausa. L'elemento pubblicitario non verrà pubblicato. |
PARENT_INSERTION_ORDER_EXPIRED |
La data di fine dell'ordine di inserzione di questo elemento pubblicitario è impostata nel passato. L'elemento pubblicitario non verrà pubblicato. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
Questo elemento pubblicitario non usa come target alcun elenco di pubblico; ciò potrebbe provocare un esaurimento eccessivamente rapido del budget. |
APP_INSTALL_NO_CONVERSION_PIXEL |
Nessun pixel di conversione configurato per questo elemento pubblicitario con installazione di app. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
Questo elemento pubblicitario ha come target uno o più elenchi di utenti che non sono più disponibili. In futuro, ciò impedirà la pubblicazione dell'elemento pubblicitario, pertanto ti consigliamo di rimuovere questi elenchi dal targeting. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
Questo elemento pubblicitario con installazione di app non dispone di una strategia di offerta ottimale. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
I deal scelti come target da questo elemento pubblicitario accettano dimensioni della creatività non in uso. Ciò potrebbe limitare la pubblicazione o il rendimento dell'elemento pubblicitario. |
NO_CREATIVE_FOR_TARGETED_DEALS |
Questo elemento pubblicitario non contiene creatività per i deal scelti come target. |
TARGETING_DEPRECATED_GEO_TARGET |
Questo elemento pubblicitario ha come target un targeting geografico che è stato ritirato. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Questo elemento pubblicitario utilizza l'impostazione Aggiorna l'integrazione dell'API per escludere direttamente tutti i segmenti di pubblico proprietari che utilizzano il targeting per pubblico prima del 25 marzo 2023 in modo da tenere conto del ritiro del campo |
MobileApp
Un'app mobile promossa da un elemento pubblicitario per l'installazione di app mobile.
Rappresentazione JSON |
---|
{
"appId": string,
"platform": enum ( |
Campi | |
---|---|
appId |
Obbligatorio. L'ID dell'app fornito dallo store della piattaforma. Le app per Android sono identificate dall'ID pacchetto utilizzato dal Play Store di Android, ad esempio Le app per iOS sono identificate da un ID app di nove cifre utilizzato dall'App Store di Apple, ad esempio |
platform |
Solo output. La piattaforma dell'app. |
displayName |
Solo output. Il nome dell'app. |
publisher |
Solo output. Il publisher dell'app. |
Piattaforma
Possibili piattaforme di app mobile.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
La piattaforma non è specificata. |
IOS |
completamente gestita per iOS. |
ANDROID |
la piattaforma Android. |
Metodi |
|
---|---|
|
Modifiche collettive alle opzioni di targeting in un singolo elemento pubblicitario. |
|
Elenca le opzioni di targeting assegnate a un elemento pubblicitario nei vari tipi di targeting. |
|
Crea un nuovo elemento pubblicitario. |
|
Elimina un elemento pubblicitario. |
|
Crea un nuovo elemento pubblicitario con impostazioni (incluso il targeting) ereditate dall'ordine di inserzione e un entity_status ENTITY_STATUS_DRAFT . |
|
Consente di ottenere un elemento pubblicitario. |
|
Elenca gli elementi pubblicitari di un inserzionista. |
|
Consente di aggiornare un elemento pubblicitario esistente. |