Elemento multimediale dell'annuncio

Alcuni tipi di annunci, ad esempio ImageAd e ResponsiveDisplayAd, contengono immagini e altri elementi multimediali. Questa guida descrive come caricare e interrogare i contenuti multimediali 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 sotto forma di Blob oggetto di interscambio di dati che può essere creati da servizi come Drive o Recupero URL.

Il seguente snippet 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 bundle multimediali con MediaBundleBuilder , che prende 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();

Esecuzione di query sui contenuti multimediali

È possibile eseguire query su contenuti multimediali di ogni tipo negli script Google Ads utilizzando una 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 l'articolo sugli annunci per conoscere il codice esempi di creazione di annunci supportati con contenuti multimediali allegati.