Tipos de anúncio

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 relatórios sobre anúncios usando os 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.

Observação: os anúncios responsivos de display agora aceitam vários recursos de texto, imagem e vídeo no mesmo anúncio. Os anúncios responsivos de display legados não são compatíveis com esses novos recursos. Os anúncios novos e legados vão continuar sendo veiculados normalmente, mas a API para recuperar e manipular anúncios responsivos de display mudou. Consulte Como processar anúncios responsivos de display legados.

Criação

Os scripts podem criar anúncios usando o método newAd() em instâncias AdGroup. Isso retorna um AdBuilderSpace que cria builders para tipos de anúncios compatíveis.

O snippet a seguir demonstra como criar um anúncio de texto expandido: javascript 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úncios estão 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 de um tipo de anúncio, como a descrição de um anúncio de texto expandido, use o método asType() para criar um AdViewSpace. Isso fornece acesso a uma versão estendida do Ad que expõe métodos específicos do tipo.

O snippet a seguir recebe a descrição de todos os anúncios de texto expandidos:

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 script. Por isso, é importante visualizar 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 do 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 relatórios em scripts.