Tipos de anuncios

Google Ads admite una variedad de tipos de anuncios, como los anuncios 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 mediante 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. Tanto los anuncios nuevos como los heredados seguirán publicándose de la forma habitual, pero cambió la API para recuperar y manipular los anuncios de display responsivos. Consulta Cómo administrar anuncios de display responsivos heredados.

Creación

Las secuencias de comandos pueden crear anuncios con el método newAd() en instancias de AdGroup. Se mostrará un AdBuilderSpace que crea compiladores para los tipos de anuncios compatibles.

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.

Si deseas acceder a los campos específicos de un tipo de 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 del Ad que expone métodos específicos de cada 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();
}

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 tanto, es importante ver los campos específicos para cada tipo solo si se conoce el tipo de 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 de un tipo específico, además de 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 "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 informes en secuencias de comandos.