Tipos de anuncios

Google Ads admite una variedad de tipos de anuncios, como los de texto, con imágenes y para dispositivos móviles. En esta guía, se explica cómo crear, recuperar y generar informes sobre anuncios con secuencias de comandos de Google Ads. Para obtener una descripción general de todos los tipos de anuncios compatibles con Google Ads, consulta la guía de la API.

Nota: Los anuncios de display responsivos admiten varios recursos de texto, imagen y video en el mismo anuncio. Los anuncios de display responsivos heredados no son compatibles con estas funciones nuevas. Los anuncios nuevos y heredados seguirán publicándose de la forma habitual, pero la API para recuperar y manipular anuncios de display responsivos cambió. Consulta Cómo controlar los anuncios de display responsivos heredados.

Creación

Las secuencias de comandos pueden crear anuncios con el método newAd() en instancias de AdGroup. Esto muestra un AdBuilderSpace que crea compiladores para los tipos de anuncios admitidos.

En el siguiente fragmento, se muestra cómo crear un anuncio de texto expandido:

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

Inspección

Parte de la información asociada con todos los tipos de anuncios está disponible de inmediato desde un Ad, como el ID y el estado de aprobación de un anuncio. Además, cualquier anuncio se puede detener, habilitar o quitar.

Para acceder a campos específicos del tipo de un anuncio, como la descripción de un anuncio de texto expandido, usa el método asType() para crear un AdViewSpace. Esto proporciona acceso a una versión extendida de Ad que expone métodos específicos de un tipo.

En el siguiente fragmento, se obtiene la descripción de cada anuncio de texto expandido:

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

Ten en cuenta que la condición Type = EXPANDED_TEXT_AD garantiza que cada anuncio del iterador sea un anuncio de texto expandido. Si intentas ver un anuncio con un tipo incorrecto, se producirá un error que detendrá la ejecución de la secuencia de comandos, por lo que es importante ver los campos específicos del tipo solo cuando se conoce el tipo de un anuncio.

En el siguiente fragmento, se muestra cómo determinar si un anuncio es del tipo correcto mediante el método Ad.isType():

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

Informes

La vista ad_group_ad también se puede usar para consultar campos de anuncios específicos del tipo, además de las estadísticas normales, como ad_group_ad.expanded_text_ad.headline_part1. En el siguiente fragmento, se muestra cómo recuperar las estadísticas de todos los anuncios de texto expandidos que contengan "Ventas con descuento" en el título 1:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

Consulta la guía de informes para obtener más información sobre los informes en las secuencias de comandos.