Puoi recuperare gli elementi pubblicitari YouTube e partner, i relativi gruppi di annunci e le risorse pubblicitarie, nonché il targeting pertinente per la pubblicazione di annunci YouTube e partner utilizzando l'API Display & Video 360. Le risorse e il targeting di YouTube e partner possono essere creati o aggiornati solo tramite l'interfaccia utente.
Questa pagina descrive come utilizzare l'API Display & Video 360 per identificare le risorse YouTube e partner e recuperare il targeting pertinente, nonché come creare e aggiornare collettivamente le risorse YouTube e partner utilizzando i file di dati strutturati (SDF) nell'interfaccia utente.
Identificare le risorse YouTube e partner
Le risorse YouTube e partner sono costituite da determinati tipi di elementi pubblicitari, gruppi di annunci e annunci.
Elementi pubblicitari
Gli elementi pubblicitari con i seguenti valori LineItemType
sono elementi pubblicitari YouTube e partner e non possono essere creati o aggiornati:
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
Le impostazioni specifiche per gli elementi pubblicitari YouTube e partner possono essere recuperate dal campo
youtubeAndPartnersSettings
della risorsa
LineItem
.
Annunci e gruppi di annunci di YouTube
I gruppi di annunci e gli annunci di YouTube sono risorse secondarie degli elementi pubblicitari YouTube e partner che consentono ulteriori specificazioni.
Un elemento pubblicitario YouTube e partner può contenere più risorse
AdGroup
, ognuna con il proprio targeting aggiuntivo e la propria strategia di offerta. Sotto ogni
risorsa AdGroup
possono essere presenti più risorse AdGroupAd
dello stesso formato dell'annuncio, ciascuna con le proprie informazioni sulla creatività e un elenco di URL di monitoraggio aggiuntivi.
Recuperare il targeting
Il targeting utilizzato per pubblicare gli annunci YouTube e partner viene assegnato a livello di inserzionista, di elemento pubblicitario e di gruppo di annunci.
Il targeting YouTube e partner ereditato dalle risorse principali non viene riportato nelle impostazioni di targeting delle risorse secondarie, come è standard per le risorse non YouTube e partner.
Per recuperare tutto il targeting pertinente alla pubblicazione di un annuncio di YouTube e partner, devi:
- recuperare il targeting assegnato all'inserzionista principale utilizzando
advertisers.listAssignedTargetingOptions
, - recupera il targeting assegnato all'elemento pubblicitario principale utilizzando
advertisers.lineItems.bulkListAssignedTargetingOptions
. - e recuperare il targeting assegnato al gruppo di annunci principale utilizzando
advertisers.adGroups.bulkListAssignedTargetingOptions
.
Tentativo di modificare il targeting di YouTube
Come per le risorse YouTube e partner, non puoi modificare il targeting YouTube e partner utilizzando l'API Display & Video 360. Qualsiasi tentativo di modificare il seguente targeting restituirà un errore:
- Targeting assegnato a qualsiasi livello dei seguenti tipi di targeting:
TARGETING_TYPE_SESSION_POSITION
,TARGETING_TYPE_YOUTUBE_CHANNEL
eTARGETING_TYPE_YOUTUBE_VIDEO
. - Targeting assegnato alle risorse degli elementi pubblicitari YouTube e partner.
- Targeting assegnato alle risorse
AdGroup
.
Creare e aggiornare utilizzando il caricamento dell'interfaccia utente SDF
Anche se non puoi creare o aggiornare le risorse di YouTube e dei partner utilizzando l'API Display & Video 360, puoi creare o aggiornare collettivamente elementi pubblicitari, gruppi di annunci e elementi pubblicitari di YouTube e dei partner utilizzando il caricamento di file di dati strutturati (SDF) tramite l'interfaccia utente di Display & Video 360.
Queste risorse sono rappresentate in SDF tramite i formati di file Elemento pubblicitario, Gruppo di annunci di YouTube e Annuncio di YouTube.
Puoi generare e scaricare file di dati strutturati utilizzando l'API Display & Video 360. Modifica le righe esistenti per apportare modifiche alle risorse esistenti o aggiungi nuove righe per creare nuove risorse e carica i file aggiornati tramite l'interfaccia utente di Display & Video 360.