O Google Ads é compatível com vários tipos de anúncio, como anúncios gráficos, de texto e para dispositivos móveis. Este guia explica como criar, recuperar e gerar um relatório sobre anúncios usando scripts do Google Ads. Para ter uma visão geral de todos os tipos de anúncio compatíveis com o Google Ads, consulte o guia de API.
com base em trends
Os scripts podem criar anúncios usando o método
newAd()
em
instâncias de
AdGroup
. Isso retorna um
AdBuilderSpace
que cria criadores para
tipos de anúncios com suporte.
O snippet a seguir mostra como criar um anúncio 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();
Inspeção
Algumas informações associadas a todos os tipos de anúncio ficam disponíveis imediatamente em um
Ad
, como o
ID e o status de aprovação de um anúncio. Além disso, qualquer anúncio pode ser pausado, ativado ou
removido.
Para acessar campos específicos do tipo de um anúncio, como a descrição de um anúncio de texto expandido, use o método asType()
para criar uma AdViewSpace
.
Isso fornece acesso a uma versão estendida do
Ad
que expõe
métodos específicos de tipo.
O snippet a seguir mostra a descrição de cada anúncio 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();
}
A condição Type = EXPANDED_TEXT_AD
garante que todos os anúncios do iterador sejam anúncios de texto expandidos. A tentativa de visualizar um anúncio com um tipo incorreto resultará em um erro que interrompe a execução do seu script. Por isso, é importante visualizar os campos específicos do tipo somente quando o tipo de um anúncio for conhecido.
O snippet a seguir mostra como determinar se um anúncio é do tipo correto
usando o
método
Ad.isType()
:
if (ad.isType().expandedTextAd()) {
let expandedTextAd = ad.asType().expandedTextAd();
let headlinePart1 = expandedTextAd.getHeadlinePart1();
let headlinePart2 = expandedTextAd.getHeadlinePart2();
}
Relatórios
A visualização ad_group_ad
também pode ser
usada para consultar campos de anúncios específicos de tipo, além de estatísticas regulares, como
ad_group_ad.expanded_text_ad.headline_part1
.
O snippet a seguir mostra como recuperar as estatísticas de todos os anúncios de texto expandidos que contêm "Vendas com desconto" no 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;
...
}
Consulte o guia de relatórios para mais informações sobre a geração de relatórios com scripts.