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 anuncios, recuperarlos y generar informes sobre ellos con las 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 ahora admiten varios recursos de texto, imagen y video en el mismo anuncio. Los anuncios de display responsivos heredados no admiten estas funciones nuevas. Los anuncios nuevos y heredados seguirán publicándose como de costumbre, pero la API para recuperar y manipular los 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. Devuelve 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 a todos los tipos de anuncios está disponible de inmediato en un Ad, como el ID y el estado de aprobación de un anuncio. Además, se puede detener, habilitar o quitar cualquier anuncio.

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

El siguiente fragmento 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();
}

Observa 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 tu secuencia de comandos, por lo que es importante ver los campos específicos del tipo solo cuando se conoce el tipo de anuncio.

En el siguiente fragmento, se muestra cómo determinar si un anuncio es del tipo correcto con 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 expandido que contienen "Discount Sales" 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 secuencias de comandos.