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.