Medios publicitarios

Algunos tipos de anuncios, como ImageAd y ResponsiveDisplayAd, contienen imágenes y otros elementos multimedia. En esta guía, se describe cómo subir y consultar medios con secuencias de comandos de Google Ads.

Subiendo imágenes

Las imágenes se pueden subir con la clase ImageBuilder, que toma un nombre y datos de imagen. Los datos se proporcionan como un objeto de intercambio de datos Blob que pueden crear servicios como Drive o la recuperación de URLs.

En el siguiente fragmento, se muestra cómo subir una imagen de una URL externa:

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();

Como alternativa, el blob de imagen se puede cargar desde Google Drive:

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

Cómo subir paquetes de medios

Los paquetes de medios son archivos ZIP que contienen recursos HTML5, que se pueden usar para crear anuncios HTML5. Sube paquetes de contenido multimedia con la clase MediaBundleBuilder, que toma un nombre y datos de archivo. Al igual que con las imágenes, los datos se proporcionan como un objeto de intercambio de datos Blob.

En el siguiente fragmento, se muestra cómo subir un paquete de medios desde una URL externa:

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();

Cómo consultar contenido multimedia

Se puede consultar contenido multimedia de todo tipo en las secuencias de comandos de Google Ads con un MediaSelector. Usa el predicado withCondition() para filtrar el contenido multimedia por nombre, tipo o cualquier otro campo. Por ejemplo, el siguiente fragmento encuentra todas las imágenes de una cuenta:

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

Crea anuncios con contenido multimedia

Consulta nuestro artículo sobre anuncios para ver algunos ejemplos de código para crear anuncios compatibles con contenido multimedia adjunto.