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 richiede un nome e dati di immagine. I dati vengono forniti come oggetto di interscambio dati di 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 di 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 richiede un nome e dati del file. Come per le immagini, i dati vengono forniti come oggetto di scambio dati Blob.

Lo snippet seguente 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 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 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 della creazione di annunci supportati con contenuti multimediali allegati.