Tipos de anúncio

O Google AdWords é 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 AdWords. Para ter uma visão geral de todos os tipos de anúncio compatíveis com o Google AdWords, consulte o guia de API.

Criação

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

O snippet a seguir mostra como criar um anúncio de texto expandido:

var 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 são disponibilizadas imediatamente por um Ad, como o ID do anúncio e o status de aprovação. Além disso, qualquer anúncio pode ser pausado, ativado ou removido.

Para acessar campos específicos ao tipo do anúncio, como a descrição de um anúncio de texto expandido, use o método asType() para criar um AdViewSpace. Esse processo fornece acesso a uma versão estendida do Ad que expõe métodos específicos de cada tipo.

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

var iterator = AdWordsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  var ad = iterator.next();
  var expandedTextAd = ad.asType().expandedTextAd();
  var description = expandedTextAd.getDescription();
}

A condição Type = EXPANDED_TEXT_AD garante que todo anúncio do iterador seja um anúncio de texto expandido. A tentativa de visualizar um anúncio com um tipo incorreto resulta em um erro que interrompe a execução do seu script. Por isso, é importante visualizar os campos específicos do tipo do anúncio somente quando ele 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()) {
  var expandedTextAd = ad.asType().expandedTextAd();
  var headlinePart1 = expandedTextAd.getHeadlinePart1();
  var headlinePart2 = expandedTextAd.getHeadlinePart2();
}

Relatórios

O AD_PERFORMANCE_REPORT também pode ser usado para consultar campos específicos do tipo de anúncio além das estatísticas comuns, como os campos do anúncio de texto expandido. 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:

var report = AdWordsApp.report(
    "SELECT AdGroupId, Id, HeadlinePart1, HeadlinePart2, Clicks, Impressions, Cost " +
    "FROM   AD_PERFORMANCE_REPORT " +
    "WHERE HeadlinePart1 CONTAINS 'Discount Sales' " +
    "DURING LAST_7_DAYS");

var rows = report.rows();
while (rows.hasNext()) {
  var row = rows.next();
  var headlinePart1 = row["HeadlinePart1"];
  var headlinePart2 = row["HeadlinePart2"];
  ...
}

Consulte o guia de relatórios para ver mais informações sobre a geração de relatórios com scripts.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.