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 contenido multimedia con las 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 URL Fetch.

En el siguiente fragmento, se muestra cómo subir una imagen desde 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 la 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, los cuales se pueden usar para crear anuncios HTML5. Sube paquetes de medios 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 sobre los medios de todo tipo en las secuencias de comandos de Google Ads con un objeto MediaSelector. Usa el predicado withCondition(condition) para filtrar los medios 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 medios adjuntos.