REST Resource: advertisers.lineItems

{
  "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)
  }
}

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

Obbligatorio. Il nome visualizzato dell'elemento pubblicitario.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.

enum (LineItemType)

Obbligatorio. Immutabile. Il tipo di elemento pubblicitario.

enum (EntityStatus)

Obbligatorio. Controlla se l'elemento pubblicitario può spendere il 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.
• Non è possibile riportare un elemento pubblicitario 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.

string (Timestamp format)

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: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (PartnerCost)

I costi partner associati all'elemento pubblicitario.

Se non è presente o è vuota nel metodo lineItems.create, l'elemento pubblicitario appena creato erediterà i costi partner dall'ordine di inserzione principale.

object (LineItemFlight)

Obbligatorio. L'ora di inizio e di fine del periodo di pubblicazione dell'elemento pubblicitario.

object (LineItemBudget)

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

object (Pacing)

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

object (FrequencyCap)

Obbligatorio. Le impostazioni della quota limite delle impressioni dell'elemento pubblicitario.

Il campo maxImpressions in questo oggetto di impostazioni deve essere utilizzato se si assegna un limite limitato.

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

L'impostazione del monitoraggio delle conversioni dell'elemento pubblicitario.

string (int64 format)

Gli ID delle creatività associate all'elemento pubblicitario.

object (BiddingStrategy)

Obbligatorio. La strategia di offerta dell'elemento pubblicitario.

object (IntegrationDetails)

Dettagli di integrazione dell'elemento pubblicitario.

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.

enum (LineItemWarningMessage)

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.

object (MobileApp)

L'app mobile promossa dall'elemento pubblicitario.

Questo si applica solo quando lineItemType è LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL o LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

enum (ReservationType)

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

boolean

Indica se escludere le nuove piattaforme di scambio dal targeting automatico dell'elemento pubblicitario. Per impostazione predefinita, questo campo è impostato su false.

object (YoutubeAndPartnersSettings)

Solo output. Impostazioni specifiche per gli elementi pubblicitari YouTube e partner.

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

enum (LineItemFlightDateType)

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

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. Output solo negli altri casi.
• Quando crei un nuovo periodo di pubblicazione, sia startDate sia endDate devono essere nel futuro.
• Un volo esistente con un startDate in passato ha un endDate modificabile, ma un startDate immutabile.
• endDate deve essere startDate o successiva, entrambe prima dell'anno 2037.

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

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.

enum (BudgetUnit)

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

string (int64 format)

L'importo massimo del budget che l'elemento pubblicitario spenderà. Deve essere maggiore di 0.

Quando budgetAllocationType è:

• LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, questo campo è immutabile ed è 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.

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

enum (PartnerRevenueModelMarkupType)

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

string (int64 format)

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

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

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string (int64 format)

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.

object (TrackingFloodlightActivityConfig)

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.

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string (int64 format)

Obbligatorio. L'ID dell'attività Floodlight.

integer

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).

integer

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).

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

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.

enum (Platform)

Solo output. La piattaforma dell'app.

string

Solo output. Il nome dell'app.

string

Solo output. Il publisher dell'app.

{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}

object (FrequencyCap)

Visualizza le impostazioni della quota limite dell'elemento pubblicitario.

Il campo maxViews in questo oggetto di impostazioni deve essere utilizzato se si assegna un limite limitato.

object (ThirdPartyMeasurementConfigs)

(Facoltativo) Le configurazioni della misurazione di terze parti dell'elemento pubblicitario.

object (YoutubeAndPartnersInventorySourceConfig)

Impostazioni che controllano quali inventari YouTube e partner sceglieranno come target l'elemento pubblicitario.

enum (YoutubeAndPartnersContentCategory)

Il tipo di contenuti su cui verranno visualizzati gli annunci di YouTube e dei partner.

enum (YoutubeAndPartnersContentCategory)

Solo output. La categoria di contenuti che ha effetto durante la pubblicazione dell'elemento pubblicitario. Se la categoria di contenuti è impostata sia nell'elemento pubblicitario che nell'inserzionista, quella più restrittiva avrà effetto durante la pubblicazione dell'elemento pubblicitario.

object (TargetFrequency)

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.

string (int64 format)

L'ID del commerciante collegato all'elemento pubblicitario per il feed dei prodotti.

string

Gli ID dei video vengono visualizzati sotto l'annuncio video principale quando questo viene riprodotto nell'app YouTube sui dispositivi mobili.

string (int64 format)

L'ID del modulo per generare lead.

object (VideoAdSequenceSettings)

Le impostazioni relative a VideoAdSequence.

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

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

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_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

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

object (ThirdPartyVendorConfig)

(Facoltativo) I fornitori di terze parti che misurano l'impatto del brand.

Sono applicabili i seguenti fornitori di terze parti:

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

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

enum (ThirdPartyVendor)

Il fornitore di servizi di misurazione di terze parti.

string

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

{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

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

boolean

(Facoltativo) Indica se scegliere come target l'inventario nelle app video disponibili con Google TV.

boolean

Indica se scegliere come target l'inventario su una raccolta di app e siti partner che rispettano gli stessi standard di sicurezza del brand di YouTube.

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

string (int64 format)

Il numero di volte target, in media, gli annunci verranno mostrati alla stessa persona nell'intervallo di tempo dettato da timeUnit e timeUnitCount.

enum (TimeUnit)

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

È applicabile la seguente unità di tempo:

• TIME_UNIT_WEEKS

integer

Il numero di timeUnit che durerà la frequenza target.

In base al valore dell'attributo timeUnit, si applicano le seguenti limitazioni:

• TIME_UNIT_WEEKS - deve essere 1

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

enum (VideoAdSequenceMinimumDuration)

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

object (VideoAdSequenceStep)

I passaggi da cui è composta la sequenza.

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

string (int64 format)

L'ID del passaggio.

string (int64 format)

L'ID del gruppo di annunci corrispondente del passaggio.

string (int64 format)

L'ID del passaggio precedente. Il primo passaggio non comprende quello precedente.

enum (InteractionType)

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