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. Neste guia, mostramos 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.

Criação

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

O snippet a seguir demonstra como criar um anúncio responsivo de pesquisa:

let adOperation = adGroup.newAd().responsiveSearchAdBuilder()
    .withHeadlines(["Headline 1", "Headline 2", "Headline 3"])
    .withDescriptions(["Description 1", "Description 2"])
    .withFinalUrl("http://www.example.com")
    .withPath1("path1")
    .withPath2("path2")
    .build();

Inspeção

Algumas informações associadas a todos os tipos de anúncio 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 os títulos de um anúncio responsivo de pesquisa, 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 de tipo.

O snippet a seguir mostra os títulos de todos os anúncios responsivos de pesquisa:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
}

Observe que a condição Type = RESPONSIVE_SEARCH_AD garante que todos os anúncios do iterador sejam anúncios responsivos de pesquisa. Tentar visualizar um anúncio com um tipo incorreto resulta em um erro que interrompe a execução do script. Por isso, é importante visualizar campos específicos de tipo somente quando o tipo de um anúncio é conhecido.

O snippet a seguir mostra como determinar se um anúncio é do tipo correto usando o método Ad.isType():

if (ad.isType().responsiveSearchAd()) {
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  let descriptions = responsiveSearchAd.getDescriptions();
}

Embora não seja possível filtrar anúncios por texto de título usando seletores padrão, você pode filtrá-los em JavaScript depois de recuperá-los:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  // Filter for ads containing a specific headline.
  if (headlines.some(h => h.getText().includes("Special Offer"))) {
    console.log(`Found ad with ID ${ad.getId()}`);
  }
}

Relatórios

A visualização ad_group_ad pode ser usada para consultar campos de anúncios, além de estatísticas regulares. Por exemplo, é possível filtrar por tipo de anúncio usando ad_group_ad.ad.type. O snippet a seguir mostra como recuperar as estatísticas de todos os anúncios responsivos de pesquisa:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.ad.id, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost " +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let clicks = row.metrics.clicks;
  ...
}

Como filtrar por conteúdo do recurso

Para filtrar anúncios responsivos de pesquisa pelo conteúdo dos títulos ou das descrições em grande escala, use o recurso ad_group_ad_asset_view. Essa visualização trata cada título e descrição como uma linha separada, permitindo que você filtre o texto do recurso.

O snippet a seguir recupera estatísticas de todos os anúncios responsivos de pesquisa que contêm um título específico:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad.id, " +
          "asset.text_asset.text, " +
          "metrics.clicks, " +
          "metrics.impressions " +
  "FROM ad_group_ad_asset_view " +
  "WHERE asset.text_asset.text LIKE '%Special Offer%' " +
    "AND ad_group_ad_asset_view.field_type = 'HEADLINE'");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let text = row.asset.textAsset.text;
  let clicks = row.metrics.clicks;
  console.log(`Ad ID ${adId} with headline "${text}" had ${clicks} clicks.`);
}

Consulte o guia de relatórios para mais informações sobre relatórios em scripts.