Per una spiegazione del formato, consulta la panoramica.
| Campo | Obbligatorio | Tipo | Scrivibile | Descrizione |
|---|---|---|---|---|
| ID annuncio | Obbligatorio solo quando vengono modificati gli annunci esistenti | integer | No | Valore dell'ID numerico dell'annuncio del gruppo di annunci. Se il campo viene lasciato vuoto, verrà creato un nuovo annuncio e verrà assegnato un ID univoco. |
| ID gruppo di annunci | Sì | integer | No | Valore dell'ID numerico del gruppo di annunci principale. Puoi specificare un identificatore personalizzato (ad esempio, "ext[ID gruppo di annunci personalizzato]") per un gruppo di annunci che stai creando contemporaneamente a questo annuncio. |
| Nome gruppo di annunci | No | stringa | No | Nome gruppo di annunci |
| Nome | Sì | stringa | Sì | Il nome della voce. |
| Stato | Sì | stringa | Sì | L'impostazione dello stato per la voce.
|
| Tipo di annuncio | Obbligatorio per gli annunci di YouTube e Demand Gen | stringa | Sì | Il formato dell'annuncio. Gli annunci video in-stream e in-feed sono tipi di annunci video di YouTube venduti su base CPV. Gli annunci bumper sono annunci video di YouTube di 6 secondi o meno venduti su base CPM. Gli annunci video non ignorabili sono annunci in-stream di YouTube di durata compresa tra 6 e 15 secondi venduti su base CPM. Gli annunci audio di YouTube sono annunci audio di YouTube. Gli annunci video adattabili sono tipi di annunci di YouTube che vengono pubblicati in più formati. Gli annunci di copertura efficace verranno pubblicati come bumper di YouTube se il video è abbastanza breve e come annunci in-stream di YouTube in caso contrario. Gli annunci video Demand Gen vengono pubblicati in più formati, inclusi, a titolo esemplificativo, YouTube. Gli annunci illustrati Demand Gen mostrano immagini. Gli annunci carosello Demand Gen mostrano schede. Gli annunci di prodotto Demand Gen mostrano i prodotti. Seleziona uno dei seguenti valori:
|
| ID video | Obbligatorio per gli annunci video di YouTube e Demand Gen | stringa | Sì | L'ID video di YouTube |
| URL di visualizzazione | Sì per gli annunci in-stream e bumper | stringa | Sì | L'URL di visualizzazione dell'annuncio |
| URL pagina di destinazione | Obbligatorio per gli annunci in-stream, bumper e Demand Gen | stringa | Sì | L'URL pagina di destinazione dell'annuncio |
| Monitoraggio DCM - ID posizionamento | Obbligatorio solo quando viene aggiornato l'annuncio di monitoraggio DCM | integer | Sì | Valore dell'ID numerico del posizionamento DCM per l'annuncio di monitoraggio corrispondente. Per rimuovere un annuncio di monitoraggio DCM, lascia vuote le tre colonne ID posizionamento monitoraggio DCM, ID annuncio monitoraggio DCM e ID creatività monitoraggio DCM. |
| Monitoraggio DCM - ID annuncio | Obbligatorio solo quando viene aggiornato l'annuncio di monitoraggio DCM | integer | Sì | Valore dell'ID numerico dell'annuncio DCM per l'annuncio di monitoraggio corrispondente.Per rimuovere un annuncio di monitoraggio DCM, lascia vuote le tre colonne ID posizionamento monitoraggio DCM, ID annuncio monitoraggio DCM e ID creatività monitoraggio DCM. |
| Monitoraggio DCM - ID creatività | Obbligatorio solo quando viene aggiornato l'annuncio di monitoraggio DCM | integer | Sì | Valore dell'ID numerico della creatività per l'annuncio di monitoraggio corrispondente.Per rimuovere un annuncio di monitoraggio DCM, lascia vuote le tre colonne ID posizionamento monitoraggio DCM, ID annuncio monitoraggio DCM e ID creatività monitoraggio DCM. |
| URL tracker dei clic | No | string | Sì | L'URL click tracker dell'annuncio |
| Parametri dell'URL click tracker | No | stringa, elenco di elenchi | Sì | I parametri personalizzati dell'URL click tracker. Formato = (nome1; valore1;); (nome2; valore2;); ecc. |
| Invito all'azione | Obbligatorio quando l'elemento pubblicitario principale è un elemento pubblicitario video per azione di YouTube, il campo "Titolo" non è vuoto o il campo "Tipo di annuncio" è "Video Demand Gen", "Immagine Demand Gen" o "Carosello Demand Gen" | stringa | Sì | Etichetta per il pulsante di invito all'azione (1 riga con un massimo di 10 caratteri). |
| Titolo | Obbligatorio per gli annunci Demand Gen | stringa | Sì | Titolo per la sovrapposizione dell'invito all'azione (1 riga con un massimo di 15 caratteri). |
| Percorso dell'URL di visualizzazione 1 | No | string | Sì | Percorso dell'URL di visualizzazione 1 |
| Percorso dell'URL di visualizzazione 2 | No | string | Sì | Percorso dell'URL di visualizzazione 2 |
| Miniatura del video in-feed | Sì per i video in-feed | stringa | Sì | La miniatura del video da utilizzare per gli annunci video discovery
|
| Titolo del video annuncio in-feed | Obbligatorio per gli annunci video in-feed e Demand Gen | stringa | Sì | Il testo del titolo per un annuncio discovery o adattabile oppure il titolo lungo per gli annunci Demand Gen. |
| Descrizione 1 | Obbligatorio per gli annunci video in-feed e Demand Gen | stringa | Sì | Il testo della descrizione 1 dell'annuncio discovery o della descrizione dell'annuncio adattabile |
| Descrizione 2 | Obbligatorio per i video in-feed | stringa | Sì | Il testo della descrizione 2 dell'annuncio discovery |
| Pagina di destinazione del video in-feed | Sì per i video in-feed | stringa | Sì | La pagina di destinazione dell'annuncio discovery |
| URL pagina di destinazione per dispositivi mobili | No | string | Sì | L'URL pagina di destinazione dell'annuncio per i dispositivi mobili |
| Nome dell'attività | Obbligatorio per gli annunci Demand Gen | stringa | Sì | Il nome dell'attività pubblicizzata A partire dal 13 luglio 2026, questa colonna potrà essere impostata per gli annunci adattabili oltre che per gli annunci Demand Gen e, se non viene impostata, erediterà il valore predefinito dall'inserzionista principale. Se non viene impostato un valore predefinito, la colonna rimarrà vuota. Questa colonna non sarà più obbligatoria per gli annunci Demand Gen se viene impostato un valore predefinito a livello di inserzionista. |
| Suffisso dell'URL pagina di destinazione | No | string | Sì | Il suffisso per l'URL pagina di destinazione |
| ID asset logo | Obbligatorio per gli annunci Demand Gen | stringa, elenco | Sì | L'elenco degli ID asset per i loghi. Questo elenco viene generato in ordine numerico crescente. A partire dal 13 luglio 2026, questa colonna potrà essere impostata per gli annunci adattabili oltre che per gli annunci Demand Gen e, se non viene impostata, erediterà il valore predefinito dall'inserzionista principale. Se non viene impostato un valore predefinito, la colonna rimarrà vuota. Questa colonna non sarà più obbligatoria per gli annunci Demand Gen se viene impostato un valore predefinito a livello di inserzionista. |
| ID asset immagine di marketing | Obbligatorio quando il campo "Tipo di annuncio" è "Immagine Demand Gen" | stringa, elenco | Sì | L'elenco degli ID asset per le immagini di marketing. Questo elenco viene generato in ordine crescente. |
| Schede Demand Gen | Obbligatorio quando il campo "Tipo di annuncio" è "Carosello Demand Gen" | stringa, elenco di elenchi | Sì | Definisce un elenco di schede nel seguente formato: (URL finale; URL mobile finale; URL; titolo; testo dell'invito all'azione; ID asset immagine di marketing; ID asset di marketing aggiuntivi...). Ad esempio: (google.com; mobile.google.com; Titolo; Fai clic qui; 10020; 20020; 30020).Ogni asset di marketing deve avere proporzioni uniche. Se una scheda di un annuncio ha un'immagine di marketing quadrata, tutte le schede dell'annuncio devono avere un'immagine di marketing quadrata (questo vale anche per le altre proporzioni). |
| ID asset banner companion | No | stringa, elenco | Sì | L'elenco degli ID asset per i banner companion. Questo elenco viene generato in ordine numerico crescente. Questo formato è supportato per gli annunci video per la performance, video Demand Gen, in-stream, bumper e non ignorabili. Formato elenco = 100; 200; |