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 buscar 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 imágenes. Los datos se proporcionan como un objeto de intercambio de datos Blob que pueden crear servicios como Drive o la recuperación de URL.

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 elementos HTML5, que 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();

Consulta de contenido multimedia

Se pueden consultar medios de cada tipo en las secuencias de comandos de Google Ads mediante un MediaSelector. Usa el predicado withCondition() para filtrar contenido multimedia por nombre, tipo y otros campos. Por ejemplo, con el siguiente fragmento, se encuentran todas las imágenes de una cuenta:

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

Crear anuncios con medios

Consulta nuestro artículo sobre anuncios para obtener algunos ejemplos de código para crear anuncios compatibles con medios adjuntos.