Tipos de anuncios

Google Ads admite diversos 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 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 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 los heredados seguirán publicándose de la forma habitual, pero Se modificó la API para recuperar y manipular anuncios de display responsivos. Por favor, Consulte Cómo administrar los anuncios de display responsivos heredados Anuncios.

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

Ten en cuenta que la condición Type = EXPANDED_TEXT_AD garantiza que todos los anuncios de iterador es 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.

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 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.