Elemento multimediale dell'annuncio

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

Caricamento delle immagini in corso

Le immagini possono essere caricate utilizzando ImageBuilder che prende un nome e i dati di un'immagine. I dati vengono forniti come oggetto di scambio 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();

Caricare bundle multimediali

I bundle multimediali sono archivi ZIP che contengono asset HTML5, utilizzabili per: Creare annunci HTML5. Carica i pacchetti multimediali con la classe MediaBundleBuilder, che accetta un nome e i dati del file. Come per le immagini, i dati vengono forniti un 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 sui media di ogni tipo negli script Google Ads utilizzando un MediaSelector. Utilizza la withCondition() predicato per filtrare i contenuti multimediali per nome, tipo o altri campi. Ad esempio, il seguente snippet 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.