Elemento multimediale dell'annuncio

Alcuni tipi di annunci, come ImageAd e ResponsiveDisplayAd, contengono immagini e altri elementi multimediali. Questa guida descrive come caricare ed eseguire query su contenuti multimediali utilizzando gli script Google Ads.

Caricamento delle immagini in corso

Le immagini possono essere caricate utilizzando la classe ImageBuilder, che accetta un nome e i dati dell'immagine. I dati vengono forniti come oggetto di interscambio di dati di Blob che può essere creato da servizi come Drive o il recupero degli URL.

Lo snippet seguente mostra come caricare un'immagine da un URL esterno:

let imageUrl = "http://www.example.com/example.png";
let imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

In alternativa, il blob immagine può essere caricato da Google Drive:

let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Caricamento di bundle multimediali

I bundle multimediali sono archivi ZIP contenenti asset HTML5 che possono essere utilizzati per creare annunci HTML5. Carica bundle multimediali con la classe MediaBundleBuilder, che prende un nome e i dati del file. Come per le immagini, i dati vengono forniti come oggetto di interscambio di dati Blob.

Il seguente snippet mostra come caricare un bundle multimediale da un URL esterno:

let mediaBundleUrl = "http://www.example.com/example.zip";
let mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

Eseguire query sui contenuti multimediali

È possibile eseguire query su contenuti multimediali di ogni tipo negli script Google Ads utilizzando un MediaSelector. Utilizza il predicato withCondition() per filtrare i contenuti multimediali per nome, tipo o altri campi. Ad esempio, il seguente snippet trova tutte le immagini di un account:

let mediaIterator = AdsApp.adMedia().media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  let image = mediaIterator.next();
}

Creare annunci con i contenuti multimediali

Consulta il nostro articolo sugli annunci per alcuni esempi di codice per la creazione di annunci supportati con contenuti multimediali allegati.