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 sui 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 scambio di dati Blob che può essere creato da servizi come Drive o Recupero 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 dell'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 di contenuti multimediali con la classe MediaBundleBuilder, che accetta un nome e i dati del file. Come per le immagini, i dati vengono forniti come oggetto di scambio 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();

Esecuzione di query sui contenuti multimediali

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

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

Creare annunci con contenuti multimediali

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