REST Resource: advertisers.lineItems

Risorsa: LineItem

Un singolo elemento pubblicitario.

Rappresentazione JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
Campi
name

string

Solo output. Il nome della risorsa dell'elemento pubblicitario.
advertiserId

string (int64 format)

Solo output. L'ID univoco dell'inserzionista a cui appartiene l'elemento pubblicitario.
campaignId

string (int64 format)

Solo output. L'ID univoco della campagna a cui appartiene l'elemento pubblicitario.
insertionOrderId

string (int64 format)

Obbligatorio. Immutabile. L'ID univoco dell'ordine di inserzione a cui appartiene l'elemento pubblicitario.
lineItemId

string (int64 format)

Solo output. L'ID univoco dell'elemento pubblicitario. Assegnato dal sistema.
displayName

string

Obbligatorio. Il nome visualizzato dell'elemento pubblicitario.

Deve avere codifica UTF-8 e una dimensione massima di 240 byte.
lineItemType

enum (LineItemType)

Obbligatorio. Immutabile. Il tipo di elemento pubblicitario.
entityStatus

enum (EntityStatus)

Obbligatorio. Controlla se l'elemento pubblicitario può spendere il suo budget e fare offerte per l'inventario.

  • Per il metodo lineItems.create, è consentito solo ENTITY_STATUS_DRAFT. Per attivare un elemento pubblicitario, utilizza il metodo lineItems.patch e aggiorna lo stato in ENTITY_STATUS_ACTIVE dopo la creazione.
  • Un elemento pubblicitario non può essere riportato allo stato ENTITY_STATUS_DRAFT da qualsiasi altro stato.
  • Se l'ordine di inserzione principale dell'elemento pubblicitario non è attivo, l'elemento pubblicitario non può spendere il proprio budget anche se il suo stato è ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento dell'elemento pubblicitario. Assegnato dal sistema.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
partnerCosts[]

object (PartnerCost)

I costi partner associati all'elemento pubblicitario.

Se assente o vuoto nel metodo lineItems.create, l'elemento pubblicitario appena creato erediterà i costi dei partner dall'ordine di inserzione principale.
flight

object (LineItemFlight)

Obbligatorio. La data e l'ora di inizio e di fine del periodo di pubblicazione dell'elemento pubblicitario.
budget

object (LineItemBudget)

Obbligatorio. L'impostazione di allocazione del budget dell'elemento pubblicitario.
pacing

object (Pacing)

Obbligatorio. L'impostazione della velocità di spesa del budget dell'elemento pubblicitario.
frequencyCap

object (FrequencyCap)

Facoltativo. Obbligatorio se il tipo di elemento pubblicitario non è LINE_ITEM_TYPE_DEMAND_GEN. Le impostazioni della quota limite di impressioni dell'elemento pubblicitario.

Se assegni un limite, devi utilizzare il campo maxImpressions in questo oggetto delle impostazioni.
partnerRevenueModel

object (PartnerRevenueModel)

Obbligatorio. L'impostazione del modello di entrate del partner dell'elemento pubblicitario.
conversionCounting

object (ConversionCountingConfig)

L'impostazione di monitoraggio delle conversioni dell'elemento pubblicitario.
creativeIds[]

string (int64 format)

Gli ID delle creatività associate all'elemento pubblicitario.
bidStrategy

object (BiddingStrategy)

Obbligatorio. La strategia di offerta dell'elemento pubblicitario.
integrationDetails

object (IntegrationDetails)

Dettagli dell'integrazione dell'elemento pubblicitario.
targetingExpansion

object (TargetingExpansionConfig)

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[]

enum (LineItemWarningMessage)

Solo output. I messaggi di avviso generati dall'elemento pubblicitario. Questi avvisi non impediscono il salvataggio dell'elemento pubblicitario, ma alcuni potrebbero impedirne la pubblicazione.
mobileApp

object (MobileApp)

L'app mobile promossa dall'elemento pubblicitario.

Questo vale solo quando lineItemType è LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL o LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

Solo output. Il tipo di prenotazione dell'elemento pubblicitario.
excludeNewExchanges

boolean

Indica se escludere le nuove piattaforme di scambio pubblicitario dal targeting automatico dell'elemento pubblicitario. Questo campo è false per impostazione predefinita.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Facoltativo. Impostazioni specifiche per gli elementi pubblicitari YouTube e partner.
demandGenSettings

object (DemandGenSettings)

Facoltativo. Impostazioni specifiche per gli elementi pubblicitari Demand Gen.

Applicabile solo agli elementi pubblicitari Demand Gen.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Indica se questo elemento pubblicitario pubblicherà annunci politici dell'Unione Europea.

Se containsEuPoliticalAds è stato impostato su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING nell'inserzionista principale, a questo campo verrà assegnato DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, se non diversamente specificato. Questo campo può essere aggiornato utilizzando l'interfaccia utente, l'API o i file di dati strutturati.

Questo campo deve essere assegnato durante la creazione di un nuovo elemento pubblicitario. In caso contrario, la richiesta advertisers.lineItems.create non andrà a buon fine.
optimizeFixedBidding

boolean

Facoltativo. Indica se attivare l'ottimizzazione delle offerte di DV360 per gli elementi pubblicitari con offerta fissa.

Per impostazione predefinita, DV360 ottimizza l'offerta fissa riducendo automaticamente le offerte per le impressioni che hanno meno probabilità di avere un buon rendimento. Questa ottimizzazione è attiva per impostazione predefinita (il valore è true).

Quando questo campo è impostato su false, questa ottimizzazione viene disattivata e l'offerta non verrà ridotta per nessun motivo.

Questa impostazione si applica solo agli elementi pubblicitari con un biddingStrategy di tipo FIXED_BID.

LineItemType

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 una varietà di 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 una varietà di 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.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Annunci video di YouTube che promuovono le conversioni.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Annunci video di YouTube (fino a 15 secondi) che non possono essere saltati.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Annunci video di YouTube che raccontano una storia in una determinata sequenza utilizzando una combinazione di formati.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

Annunci audio di YouTube.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Annunci video di YouTube che ottimizzano la copertura di un maggior numero di utenti unici a un costo inferiore. Possono includere annunci bumper, annunci in-stream ignorabili o una combinazione di tipi.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Annunci video di YouTube predefiniti.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Annunci video di YouTube per TV connesse a internet (fino a 15 secondi) che non possono essere ignorati.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Annunci video di YouTube per TV connesse a internet che ottimizzano la copertura di un maggior numero di utenti unici a un costo inferiore. Possono includere annunci bumper, annunci in-stream ignorabili o una combinazione di tipi.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Annunci video di YouTube predefiniti per le TV connesse a internet. Includi solo il formato dell'annuncio in-stream.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

L'obiettivo di questo tipo di elemento pubblicitario è mostrare gli annunci di YouTube un numero di volte target alla stessa persona in un determinato periodo di tempo.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Annunci video di YouTube che mirano a ottenere più visualizzazioni con una varietà di formati dell'annuncio.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Annunci display pubblicati nell'inventario Out of Home digitale.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Annunci video pubblicati nell'inventario out of home digitale.

Gli elementi pubblicitari di questo tipo e il relativo targeting non possono essere creati o aggiornati utilizzando l'API.
LINE_ITEM_TYPE_DEMAND_GEN Annunci Demand Gen.

LineItemFlight

Impostazioni che controllano la durata attiva di un elemento pubblicitario.

Rappresentazione JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
Campi
flightDateType

enum (LineItemFlightDateType)

Obbligatorio. Il tipo di periodo di pubblicazione dell'elemento pubblicitario.
dateRange

object (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.

  • Obbligatorio quando flightDateType è LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. Solo output negli altri casi.
  • Quando crei un nuovo volo, sia startDate che endDate devono essere nel futuro.
  • Un volo esistente con un startDate nel passato ha un endDate modificabile, ma un startDate immutabile.
  • endDate deve essere startDate o una data successiva, entrambe precedenti all'anno 2037.

LineItemFlightDateType

Possibili tipi di periodi 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 un periodo di pubblicazione personalizzato.

LineItemBudget

Impostazioni che controllano la distribuzione del budget.

Rappresentazione JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Campi
budgetAllocationType

enum (LineItemBudgetAllocationType)

Obbligatorio. Il tipo di allocazione del budget.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC è applicabile solo quando l'allocazione automatica del budget è attivata per l'ordine di inserzione principale.

Questo campo deve essere impostato su LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED per gli elementi pubblicitari Demand Gen.
budgetUnit

enum (BudgetUnit)

Solo output. L'unità di budget specifica se il budget è basato sulla valuta o sulle impressioni. Questo valore viene ereditato dall'ordine di inserzione principale.
maxAmount

string (int64 format)

L'importo massimo del budget che verrà speso dall'elemento pubblicitario. Deve essere maggiore di 0.

Quando budgetAllocationType è:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, questo campo è immutabile e viene impostato dal sistema.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, se budgetUnit è:
    • BUDGET_UNIT_CURRENCY, questo campo rappresenta l'importo massimo del budget da spendere, in micro della valuta dell'inserzionista. Ad esempio, 1500000 rappresenta 1,5 unità standard della valuta.
    • BUDGET_UNIT_IMPRESSIONS, questo campo rappresenta il numero massimo di impressioni da pubblicare.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, questo campo non è applicabile e verrà ignorato dal sistema.

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 è attivata per l'elemento pubblicitario.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED All'elemento pubblicitario viene assegnato un importo di budget massimo fisso.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED All'elemento pubblicitario non viene applicato alcun limite di budget.

PartnerRevenueModel

Impostazioni che controllano il modo in cui vengono calcolate le entrate dei partner.

Rappresentazione JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Campi
markupType

enum (PartnerRevenueModelMarkupType)

Obbligatorio. Il tipo di ricarico del modello di entrate del partner.

Questo campo deve essere impostato su PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP per gli elementi pubblicitari Demand Gen.
markupAmount

string (int64 format)

Obbligatorio. L'importo del ricarico del modello di entrate del partner. Deve essere maggiore o uguale a 0.

  • Quando markupType è impostato su PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, questo campo rappresenta il ricarico del CPM in micro della valuta dell'inserzionista. Ad esempio, 1500000 rappresenta 1,5 unità standard della valuta.
  • Quando markupType è impostato su PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, questo campo rappresenta il markup percentuale del costo dei media in millesimi. Ad esempio, 100 rappresenta lo 0,1% (decimale 0,001).
  • Quando markupType è impostato su PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, questo campo rappresenta il ricarico percentuale del costo totale dei media in millesimi. Ad esempio, 100 rappresenta lo 0,1% (decimale 0,001).

PartnerRevenueModelMarkupType

Possibili tipi di ricarico 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 totale dei media, che include tutti i costi partner e i costi dei dati.

ConversionCountingConfig

Impostazioni che controllano il modo in cui vengono conteggiate le 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 (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
Campi
postViewCountPercentageMillis

string (int64 format)

La percentuale di conversioni post-visualizzazione da conteggiare, in millesimi (1/1000 di percentuale). Deve essere compreso tra 0 e 100.000 inclusi.

Ad esempio, per monitorare il 50% delle conversioni post-clic, imposta un valore pari a 50.000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Le configurazioni delle 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.

Questo campo non può essere aggiornato se all'elemento pubblicitario è assegnato un algoritmo delle offerte personalizzate. Se imposti questo campo e assegni un algoritmo di offerte personalizzate nella stessa richiesta, le attività Floodlight devono corrispondere a quelle utilizzate dall'algoritmo di offerte personalizzate.
primaryAttributionModelId

string (int64 format)

Facoltativo. Il modello di attribuzione da utilizzare per la misurazione delle conversioni. Questo modello di attribuzione determinerà il modo in cui vengono conteggiate le conversioni. Puoi impostare il modello principale per una configurazione o un gruppo Floodlight. Scopri di più qui.

Applicabile solo agli elementi pubblicitari Demand Gen.

TrackingFloodlightActivityConfig

Impostazioni che controllano il comportamento di una singola configurazione dell'attività Floodlight.

Rappresentazione JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
Campi
floodlightActivityId

string (int64 format)

Obbligatorio. L'ID dell'attività Floodlight.
postClickLookbackWindowDays

integer

Obbligatorio. Il numero di giorni dopo il clic su un annuncio in cui può essere conteggiata una conversione. Deve essere compreso tra 0 e 90 inclusi.
postViewLookbackWindowDays

integer

Obbligatorio. Il numero di giorni successivi alla visualizzazione di un annuncio durante i quali può essere conteggiata una conversione. Deve essere compreso tra 0 e 90 inclusi.

LineItemWarningMessage

I messaggi di avviso generati da un elemento pubblicitario. Questi tipi di avvisi non impediscono il salvataggio di un elemento pubblicitario, ma potrebbero impedirne la pubblicazione.

Enum
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Non specificato o sconosciuto.
INVALID_FLIGHT_DATES Questo elemento pubblicitario ha un periodo di pubblicazione non valido. L'elemento pubblicitario non verrà pubblicato.
EXPIRED La data di fine di questo elemento pubblicitario è nel passato.
PENDING_FLIGHT Questo elemento pubblicitario inizierà a essere pubblicato 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 Il targeting per app e URL di questo elemento pubblicitario non include app mobile. Il tipo di questo elemento pubblicitario richiede l'inclusione di app mobile nel targeting per canali, elenchi di siti o app. L'elemento pubblicitario non verrà pubblicato.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Questo elemento pubblicitario non ha come target utenti di dispositivi mobili. Il tipo di questo elemento pubblicitario richiede di scegliere come target un elenco di utenti con 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.

MobileApp

Un'app mobile promossa da un elemento pubblicitario per la promozione di app mobile.

Rappresentazione JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Campi
appId

string

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 com.google.android.gm.

Le app per iOS sono identificate da un ID app di nove cifre utilizzato dall'App Store di Apple, ad esempio 422689480.
platform

enum (Platform)

Solo output. La piattaforma dell'app.
displayName

string

Solo output. Il nome dell'app.
publisher

string

Solo output. Il publisher dell'app.

Piattaforma

Possibili piattaforme di app mobile.

Enum
PLATFORM_UNSPECIFIED La piattaforma non è specificata.
IOS Piattaforma iOS.
ANDROID Piattaforma Android.

YoutubeAndPartnersSettings

Impostazioni per gli elementi pubblicitari YouTube e partner.

Rappresentazione JSON 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Campi
viewFrequencyCap

object (FrequencyCap)

Le impostazioni della quota limite di visualizzazioni dell'elemento pubblicitario.

Se assegni un limite, devi utilizzare il campo maxViews in questo oggetto delle impostazioni.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Facoltativo. Le configurazioni di misurazione di terze parti dell'elemento pubblicitario.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Impostazioni che controllano gli inventari di YouTube e partner che verranno scelti come target dall'elemento pubblicitario.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Solo output. Il tipo di contenuti su cui verranno mostrati gli annunci YouTube e partner.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Solo output. La categoria di contenuti che viene applicata quando viene pubblicato l'elemento pubblicitario. Quando la categoria di contenuti è impostata sia nell'elemento pubblicitario sia nell'inserzionista, durante la pubblicazione dell'elemento pubblicitario verrà applicata quella più restrittiva.

I nuovi elementi pubblicitari erediteranno solo l'impostazione a livello di inserzionista.
targetFrequency

object (TargetFrequency)

Facoltativo. Il numero medio di volte in cui vuoi che gli annunci di questo elemento pubblicitario vengano mostrati alla stessa persona in un determinato periodo di tempo.
linkedMerchantId

string (int64 format)

Facoltativo. L'ID dell'account Merchant Center utilizzato per fornire un feed dei prodotti.

Questo account Merchant Center deve essere già collegato all'inserzionista.
relatedVideos[]

object (RelatedVideo)

Facoltativo. I video correlati per l'elemento pubblicitario. Questi video verranno visualizzati sotto l'annuncio video principale durante la riproduzione nell'app YouTube su dispositivi mobili.
leadFormId

string (int64 format)

Facoltativo. L'ID del modulo per generare lead.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Facoltativo. Le impostazioni relative a VideoAdSequence.
videoAdInventoryControl

object (VideoAdInventoryControl)

Facoltativo. Le impostazioni per controllare quale inventario è consentito per questo elemento pubblicitario.

ThirdPartyMeasurementConfigs

Impostazioni che controllano quali fornitori di terze parti misurano metriche specifiche degli elementi pubblicitari.

Rappresentazione JSON 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Campi
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

Facoltativo. I fornitori di terze parti che misurano la visibilità.

Sono applicabili i seguenti fornitori di terze parti:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

Facoltativo. I fornitori di terze parti che misurano la sicurezza del brand.

Sono applicabili i seguenti fornitori di terze parti:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Facoltativo. I fornitori di terze parti che misurano la copertura.

Sono applicabili i seguenti fornitori di terze parti:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Facoltativo. I fornitori di terze parti che misurano il brand lift.

Sono applicabili i seguenti fornitori di terze parti:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

Impostazioni che controllano la configurazione dei fornitori di servizi di misurazione di terze parti.

Rappresentazione JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Campi
vendor

enum (ThirdPartyVendor)

Il fornitore di servizi di misurazione di terze parti.
placementId

string

L'ID utilizzato dalla piattaforma del fornitore di terze parti per identificare l'elemento pubblicitario.

ThirdPartyVendor

Fornitori che eseguono misurazioni di terze parti.

Enum
THIRD_PARTY_VENDOR_UNSPECIFIED Fornitore di terze parti sconosciuto.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Telemetria.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN origine.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV iSpot.tv.
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

Impostazioni che controllano gli inventari correlati a YouTube che verranno scelti come target dall'elemento pubblicitario YouTube e partner.

Rappresentazione JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Campi
includeYoutube

boolean

Facoltativo. Indica se scegliere come target l'inventario su YouTube. Sono inclusi la ricerca, i canali e i video.
includeGoogleTv

boolean

Facoltativo. Se scegliere come target l'inventario nelle app video disponibili con Google TV.
includeYoutubeVideoPartners

boolean

Se scegliere come target l'inventario di una raccolta di siti e app partner che rispettano gli stessi standard in materia di sicurezza del brand di YouTube.

YoutubeAndPartnersContentCategory

Categorie di sicurezza del brand per i contenuti di YouTube e dei partner.

Enum
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED La categoria di contenuti non è specificata o è sconosciuta in questa versione.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Una categoria che comprende un'ampia gamma di contenuti adatti alla maggior parte dei brand. I contenuti si basano sulle linee guida sui contenuti idonei per gli inserzionisti di YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Una categoria che include tutti i contenuti di YouTube e dei partner video che soddisfano gli standard per la monetizzazione.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Una categoria costituita da una gamma ridotta di contenuti che soddisfano requisiti più stringenti, in particolare per quanto riguarda il linguaggio inappropriato e le allusioni sessuali.

TargetFrequency

Impostazione che controlla il numero medio di volte in cui gli annunci verranno mostrati alla stessa persona in un determinato periodo di tempo.

Rappresentazione JSON 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Campi
targetCount

string (int64 format)

Il numero target di volte, in media, in cui gli annunci verranno mostrati alla stessa persona nel periodo di tempo stabilito da timeUnit e timeUnitCount.
timeUnit

enum (TimeUnit)

L'unità di tempo in cui verrà applicata la frequenza target.

È applicabile la seguente unità di tempo:

  • TIME_UNIT_WEEKS
  • TIME_UNIT_MONTHS
timeUnitCount

integer

Il numero di timeUnit per cui durerà la frequenza target.

A seconda del valore di timeUnit, si applicano le seguenti limitazioni:

  • TIME_UNIT_WEEKS: deve essere 1
  • TIME_UNIT_MONTHS: deve essere 1

RelatedVideo

Rappresenta una voce di video correlato.

Rappresentazione JSON 
{
  "videoId": string,
  "videoAssetId": string
}
Campi
videoId

string

Solo output. L'ID video di YouTube del video correlato.
videoAssetId

string (int64 format)

Obbligatorio. adAssetId della risorsa AdAsset per il video di YouTube.

VideoAdSequenceSettings

Impostazioni relative a VideoAdSequence.

Rappresentazione JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Campi
minimumDuration

enum (VideoAdSequenceMinimumDuration)

L'intervallo di tempo minimo prima che lo stesso utente visualizzi di nuovo questa sequenza.
steps[]

object (VideoAdSequenceStep)

I passaggi che compongono la sequenza.

VideoAdSequenceMinimumDuration

L'enum per il possibile intervallo di tempo minimo prima che lo stesso utente visualizzi di nuovo la sequenza di annunci video.

Enum
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Non specificato o sconosciuto.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 giorni.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 giorni.

VideoAdSequenceStep

I dettagli di un singolo passaggio in una sequenza di annunci video.

Rappresentazione JSON 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Campi
stepId

string (int64 format)

L'ID del passaggio.
adGroupId

string (int64 format)

L'ID del gruppo di annunci corrispondente del passaggio.
previousStepId

string (int64 format)

L'ID del passaggio precedente. Il primo passaggio non ha un passaggio precedente.
interactionType

enum (InteractionType)

L'interazione nel passaggio precedente che porterà lo spettatore a questo passaggio. Il primo passaggio non ha interactionType.

InteractionType

I tipi di interazione in un passaggio.

Enum
INTERACTION_TYPE_UNSPECIFIED Non specificato o sconosciuto
INTERACTION_TYPE_PAID_VIEW Una visualizzazione a pagamento.
INTERACTION_TYPE_SKIP Ignorato dallo spettatore.
INTERACTION_TYPE_IMPRESSION Un'impressione dell'annuncio (visualizzata).
INTERACTION_TYPE_ENGAGED_IMPRESSION Un'impressione dell'annuncio che non è stata saltata immediatamente dallo spettatore, ma che non ha nemmeno raggiunto l'evento fatturabile.

VideoAdInventoryControl

Il controllo dell'inventario pubblicitario video utilizzato in determinati tipi di elementi pubblicitari YouTube.

Rappresentazione JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
Campi
allowInStream

boolean

Facoltativo. Se gli annunci possono essere pubblicati nel formato in-stream.
allowInFeed

boolean

Facoltativo. Se gli annunci possono essere pubblicati nel formato in-feed.
allowShorts

boolean

Facoltativo. Indica se gli annunci possono essere pubblicati nel formato di Shorts.
allowNonSkippableInStream

boolean

Facoltativo. Indica se gli annunci possono essere pubblicati nel formato in-stream non ignorabile.

DemandGenSettings

Impostazioni per gli elementi pubblicitari Demand Gen.

Rappresentazione JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
Campi
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Facoltativo. Le impostazioni di misurazione di terze parti per l'elemento pubblicitario Demand Gen.
linkedMerchantId

string (int64 format)

Facoltativo. L'ID dell'account Merchant Center utilizzato per fornire un feed dei prodotti.

Questo account Merchant Center deve essere già collegato all'inserzionista.
geoLanguageTargetingEnabled

boolean

Facoltativo. Immutabile. Indica se il targeting per località e lingua può essere impostato a livello di elemento pubblicitario. In caso contrario, i tipi di targeting pertinenti devono essere assegnati direttamente ai gruppi di annunci.

Metodi

bulkEditAssignedTargetingOptions

 Modifica collettivamente le opzioni di targeting in più elementi pubblicitari.

bulkListAssignedTargetingOptions

 Elenca le opzioni di targeting assegnate per più elementi pubblicitari in tutti i tipi di targeting.

bulkUpdate

 Aggiorna più elementi pubblicitari.

create

 Crea un nuovo elemento pubblicitario.

delete

 Elimina un elemento pubblicitario.

duplicate

 Duplica un elemento pubblicitario.

get

 Recupera un elemento pubblicitario.

list

 Elenca gli elementi pubblicitari di un inserzionista.

patch

 Aggiorna un elemento pubblicitario esistente.