Tipos de anuncios

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

Creación

Las secuencias de comandos pueden crear anuncios con el newAd() método activado AdGroup individuales. Esto muestra un AdBuilderSpace que crea compiladores para 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 en un Ad, como una el ID del anuncio y el estado de aprobación. Además, todos los anuncios se pueden detener, habilitar o quitarse.

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

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 todos los anuncios de iterador es un anuncio de texto expandido. Intentar ver un anuncio con una generará un error que detendrá la ejecución de la secuencia de comandos, así que es importante ver los campos específicos de cada tipo solo cuando el tipo de un anuncio es conocido.

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

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 para consultar campos de anuncios de un tipo específico, además de las estadísticas habituales, como ad_group_ad.expanded_text_ad.headline_part1 El siguiente fragmento 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 la generación de informes en secuencias de comandos.