Gerenciando e Otimizando Campanhas de Links Patrocinados com a API do Google AdWords

Transcrição

1 a r t i g o Eric Gomes (ericgomes@octavarium.com.br): é formado em Ciências da Computação pela PUC-SP e atua na área de desenvolvimento de software há 13 anos. Atualmente trabalha com integração e arquitetura de sistemas através da consultoria SysMap Solutions. É responsável pela empresa Octavarium Tecnologia, especializada no gerenciamento e otimização de campanhas de links patrocinados do Google AdWords para clientes. O programa de publicidade do Google disponibiliza uma poderosa API para o controle total de campanhas publicitárias no Google AdWords. Neste artigo, veremos como utilizar a API do AdWords para desenvolver um software que gerencia uma campanha de publicidade fictícia no Google AdWords baseada no fluxo de vendas de produtos de uma loja também fictícia. Gerenciando e Otimizando Campanhas de Links Patrocinados com a API do Google AdWords Aumente a audiência do seu site com a poderosa API de publicidade do Google A Internet já revolucionou vários aspectos da vida das pessoas. Isso também é verdade quando falamos da forma como as empresas divulgam seus produtos e serviços através da publicidade. Atualmente, as principais questões, como análise de mercado, estimativas de retorno sobre investimento, mensuração de resultados levam apenas minutos para serem respondidas. Já as campanhas nas chamadas mídias tradicionais, como rádio, televisão, jornal e revista, dificilmente atingem tamanha precisão e menos ainda velocidade comparável. Entretanto, a publicidade utilizando a Internet como mídia também passa por uma revolução. Ainda existe uma grande parte de anúncios em páginas web mensurada através da relação custo por exibição, ou seja, o anunciante paga de acordo com o número de vezes que o anúncio foi exibido. Geralmente existe um custo fixo a cada mil exibições. Por isso, esta métrica leva o nome de CPM: custo por mil. As campanhas que utilizam a métrica CPC funcionam de forma diferente. O cliente só paga quando alguém realmente vê e clica no seu anúncio. Por isso esta métrica leva o nome de CPC: custo por clique. Isto representa uma enorme diferença. Com a publicidade CPC, o anunciante consegue mensurar de forma mais precisa se o investimento está ou não valendo à pena. O custo para o anunciante só acontece quando realmente conseguiu atrair um visitante para o domínio do seu website (blog ou qualquer outra página na Internet). Vale notar que mesmo para as campanhas baseadas em CPC, é possível calcular-se a CPM equivalente. Este artigo apresenta a poderosa API disponibilizada pelo Google para otimizar campanhas de links patrocinados do Google AdWords. Primeiramente veremos alguns benefícios da publicidade on-line em relação às mídias tradicionais e como mensurar os investimentos nesta mídia, através das métricas CPM e CPC. Em seguida, vamos ver a importante participação do Google neste mercado e apresentar o seu programa de publicidade na Internet: o Google AdWords. Então chegamos ao assunto principal deste artigo que é apresentar a API do Google AdWords e mostrar como podemos utilizá-la para gerenciar e otimizar campanhas de links patrocinados do Google AdWords. O artigo é acompanhado de um software simples que exemplifica a utilização da API para a otimização de uma campanha de links patrocinados para uma loja. 58

2 Google O Google iniciou suas operações há 11 anos e, desde então, aperfeiçoa constantemente o seu principal sistema: o melhor sistema de buscas do mundo. A combinação perfeita entre hardware e software (denominada por alguns como Googleware), a capacidade de manipular um imenso volume de informações e apresentar indicações de websites ordenados por relevância em milésimos de segundos para milhões de pessoas ao mesmo tempo garante hoje ao Google 78% de participação no mercado global de buscas na Internet. Isso significa que, além da melhor search engine, o Google é o site mais acessado e utilizado na Internet em muitos países no mundo todo. O Google sabe lucrar com essa imensa audiência: através do seu programa de publicidade on-line denominado Google AdWords. O lucro obtido da sua engine de busca financia muitos outros serviços que a empresa mantém (ainda que gerando prejuízos em alguns casos, como o YouTube, por exemplo). Mas o Google vem mudando isso, introduzindo também a sua publicidade em todos os seus serviços, como Orkut, Gmail, YouTube, Earth, Maps e Blogger. As mesmas campanhas de publicidade preparadas para a busca do Google agora também permeiam estes serviços, o que traz benefícios não só ao próprio Google, mas também aos anunciantes. Além disso, o Google também disponibiliza outro programa relacionado aos links patrocinados denominado Google AdSense, no qual o Google paga aos donos de sites que aceitam veicular a publicidade on-line do Google em suas páginas. Os anúncios exibidos sempre estão relacionados ao conteúdo e context da página. O Google apresenta muitos links como resultado de cada busca feita (281 milhões em oito décimos de segundos para a busca por Java no Google Brasil, por exemplo) e garantir que determinado website esteja posicionado entre os 10 primeiros da lista, para que seja exibido logo na primeira página (ou próximo disso), é algo bastante difícil em alguns casos. Basicamente existem duas formas de posicionar seu website na cobiçada primeira página de resultados de busca: SEO e SEM.O SEO significa Search Engine Optimization (otimização para sistemas de busca) e consiste em técnicas para otimizar um website para atingir melhores posições nas buscas. Não é possível pagar ao Google para estar bem posicionado nos resultados de sua busca normal. Por outro lado, o SEM, que significa Search Engine Marketing (marketing para sistemas de busca), é um programa de publicidade e envolve investimentos em publicidade através da comercialização de anúncios. Este artigo trata do AdWords, que é o SEM aplicado ao Google. O Google AdWords possibilita justamente isso: que você consiga que seu website seja exibido na primeira página (ou próximo disso), desde que você aceite pagar por isso. A disputa pelas melhores posições com o menor investimento é um dos objetivos no gerenciamento e otimização das campanhas de links patrocinados. O importante, acima de tudo, é atrair visitantes interessados nos produtos e serviços oferecidos pelo site, de forma a torná-los clientes além de visitantes. Google AdWords O Google vende espaço publicitário na Internet através do seu programa de publicidade on-line denominado AdWords. Para sua utilização, o Google disponibiliza ao anunciante, um sistema com interface web para administração de todos os aspectos relacionados às campanhas publicitárias. Além da interface web (em o Google oferece o software Google AdWords Editor (figura 1) que pode ser baixado e instalado no computador e também a Google AdWords API que permite que sejam desenvolvidos softwares customizados integrados ao AdWords. É especificamente sobre esta API que trata este artigo. As campanhas de publicidade do Google seguem uma estrutura hierárquica simples, como segue: Um gerente de conta administra várias contas de clientes, que por sua vez possuem diversas campanhas. Toda campanha possui anúncios e palavras-chave que são agrupados em grupos de anúncios. Atualmente existem diversos formatos de anúncio, por exemplo, anúncios para celular, gráficos e de vídeo, porém apenas os anúncios de texto são exibidos nas páginas de resultado de buscas do Google. Neste tutorial sobre a AdWords API, utilizamos apenas anúncios de texto. O Google apresenta os anúncios pagos do AdWords em duas áreas das páginas de resultado de busca: na lateral direita da tela e em alguns casos acima dos resultados da busca gratuita na lateral esquerda (também conhecida como busca orgânica). De acordo com a palavra-chave utilizada na busca, o Google seleciona os anúncios dos anunciantes interessados por esta palavra-chave e posiciona os anúncios na página. Para garantir um bom posicionamento, o anunciante deve levar em conta dois aspectos básicos: estar disposto a pagar um valor adequado em relação ao valor que os anunciantes concorrentes estão pagando e garantir que os anúncios sejam relevantes, isto é, que seus textos despertem o interesse ao clique do internauta que acabou de realizar a busca. A disputa pelas melhores posições é uma das metas dos anunciantes no jogo do AdWords. Google AdWords API Após adquirir um maior grau de experiência gerenciando e otimizando campanhas de links patrocinados do Google AdWords e entender realmente a dinâmica de funcionamento do Google AdWords, o anunciante 59

3 (ou a empresa responsável por este trabalho para o anunciante) notavelmente percebe que existem diversas etapas e processos que podem ser automatizados. A Google AdWords API foi criada justamente para suprir esta necessidade. Através desta API, o anunciante pode elencar seus requisitos e regras de negócio e desenvolver softwares integrados ao sistema AdWords. Isto pode gerar grande vantagem competitiva em relação a anunciantes concorrentes que não dispõem deste recurso no auxílio ao gerenciamento de suas campanhas. Google AdWords API Visão técnica A Google AdWords API é composta por uma série de Web Services. A integração entre a API e o software desenvolvido normalmente acontece através da troca de arquivos XMLs sobre o protocolo HTTP. Basicamente o software faz uma pergunta ou ordena uma ação à API do AdWords. Esta requisição (request) então trafega pela Internet de forma segura até o servidor do Google, que por sua vez processa, executa a solicitação e responde com um novo arquivo XML de resposta (response). As funcionalidades do AdWords, disponibilizadas aos anunciantes, estão agrupadas em diferentes Web Services, sendo que cada um disponibiliza operações relacionadas ao seu escopo específico e corresponde a uma estrutura do AdWords, permitindo acesso, alteração e criação dos dados que compõem a estrutura. A tabela 1 apresenta os Web Services, as estruturas com as quais se relacionam no AdWords, seus endpoints (onde podemos baixar os WSDLs) e as principais classes Java para manipulação. Cada operação de um Web Service contém parâmetros de entrada e saída específicos. Estas estruturas de dados são específicas para cada Web Service e é através da manipulação destes dados que o software é capaz de executar as regras de negócio necessárias. Cabeçalho SOAP O cabeçalho SOAP para a comunicação com o Web Services do AdWords é mostrado a seguir e contém as seguintes informações: ção para o Google; vedor para o Google; <soapenv:header xmlns:soapenv=" > <v13:applicationtoken>zyxwvu-tsr123_456abcde</v13:applicationtoken> <v13:developertoken>abcdefgh93kl-nopq_stuv</v13:developertoken> <v13:client ></v13:client > <v13: >ericgomes@octavarium.com.br</v13: > <v13:password> </v13:password> <v13:useragent>opcional</v13:useragent> </soapenv:header> WEB SERVICES ESTRUTURAS WSDL CampaignService AdGroupService Campanhas Grupos de anúncios CampaignService?wsdl AdGroupService?wsdl AdService Anúncios AdService?wsdl CriterionService AccountService Palavras-chave ou canais Contas de gerentes e clientes CriterionService?wsdl AccountService?wsdl InfoService API do AdWords InfoService?wsdl KeywordTool- Service SiteSuggestion- Service TrafficEstimator- Service Ferramenta de palavras-chave Sugestão de sites Estimativa de tráfego KeywordToolService?wsdl SiteSuggestionService?wsdl TrafficEstimatorService?wsdl ReportService Relatórios ReportService?wsdl Consumo com Java Este tutorial utiliza a implementação Apache Axis do protocolo SOAP. Esta API facilita e padroniza a comunicação entre aplicações Java e Web Services. Através da classe WSDL2Java do Axis, foram geradas todas as classes e interfaces Java a partir dos Web Services do AdWords, disponibilizados pelo Google, necessárias para a integração. Para o Web Service CampaignService, por exemplo, foram geradas as classes Java Campaign, CampaignBudget, CampaignStatus, CampaignService e CampaignServiceLocator, entre outras. Os WSDLs estão disponíveis na Internet e suas urls estão na tabela 1 deste artigo. A Listagem 1 mostra uma requisição (ou request) e a respectiva resposta (ou response) da chamada para a operação getalladwordscampaigns do Web Service Campaign- Service. 60

4 Listagem 1. Exemplo de request e response da operação getalladwordscampaigns do Web Service CampaignService. <soapenv:envelope xmlns:soapenv=" envelope/" xmlns:v13="com/api/adwords/v13"> <soapenv:header> <v13:applicationtoken></v13:applicationtoken> <v13:developertoken>ericgomes@octavarium.com.br++brl </v13:developertoken> <v13:client >client_1+ ericgomes@octavarium.com.br </v13:client > <v13: > ericgomes@octavarium.com.br </v13: > <v13:password>------</v13:password> <v13:useragent>x</v13:useragent> </soapenv:header> <soapenv:body> <v13:getalladwordscampaigns> <v13:dummy>0</v13:dummy> </v13:getalladwordscampaigns> </soapenv:body> </soapenv:envelope> <soapenv:envelope xmlns:soapenv=" soap/envelope/" xmlns:xsd=" xmlns:xsi=" <soapenv:header> <responsetime soapenv:actor=" soapenv:mustunderstand="0" xmlns= "com/api/adwords/v13">268</responsetime> <operations soapenv:actor=" soapenv:mustunderstand="0" xmlns= "com/api/adwords/v13">2</operations> <units soapenv:actor=" soapenv:mustunderstand="0" xmlns= "com/api/adwords/v13">2</units> <requestid soapenv:actor=" soapenv:mustunderstand="0" xmlns= "com/api/adwords/v13"> d1b24a1edb8dc4b068d16a1d9e6d128e</requestid> </soapenv:header> <soapenv:body> <getalladwordscampaignsresponse xmlns= "com/api/adwords/v13"> <getalladwordscampaignsreturn> <budgetamount> </budgetamount> <budgetoptimizersettings> <enabled>false</enabled> </budgetoptimizersettings> <budgetperiod>daily</budgetperiod> <contenttargeting>allplacements</contenttargeting> <conversionoptimizersettings> <enabled>false</enabled> </conversionoptimizersettings> <endday> :00</endday> <geotargeting> <targetall>true</targetall> <countrytargets xsi:nil="true"/> <regiontargets xsi:nil="true"/> <metrotargets xsi:nil="true"/> <citytargets xsi:nil="true"/> <proximitytargets xsi:nil="true"/> </geotargeting>

5 <id>9560</id> <languagetargeting xsi:nil="true"/> <name>campanha Teste 1</name> <networktargeting> <networktypes>searchnetwork</networktypes> <networktypes>contentnetwork</networktypes> </networktargeting> <schedule> <status>disabled</status> </schedule> <startday> :00</startday> <status>deleted</status> </getalladwordscampaignsreturn> <getalladwordscampaignsreturn> <budgetamount> </budgetamount> <budgetoptimizersettings> <enabled>false</enabled> </budgetoptimizersettings> <budgetperiod>daily</budgetperiod> <contenttargeting>allplacements</contenttargeting> <conversionoptimizersettings> <enabled>false</enabled> </conversionoptimizersettings> <endday> :00</endday> <geotargeting> <targetall>true</targetall> <countrytargets xsi:nil="true"/> <regiontargets xsi:nil="true"/> <metrotargets xsi:nil="true"/> <citytargets xsi:nil="true"/> <proximitytargets xsi:nil="true"/> </geotargeting> <id>9570</id> <languagetargeting xsi:nil="true"/> <name>campanha Loja Mundoj</name> <networktargeting> <networktypes>searchnetwork</networktypes> <networktypes>contentnetwork</networktypes> </networktargeting> <schedule> <status>disabled</status> </schedule> <startday> :00</startday> <status>active</status> </getalladwordscampaignsreturn> </getalladwordscampaignsresponse> </soapenv:body> </soapenv:envelope> A linguagem de programação Java foi escolhida para o código deste tutorial, porém, como a Google AdWords API baseia-se no protocolo SOAP, qualquer linguagem que ofereça suporte a esta tecnologia pode ser utilizada, como Python, DotNet, Ruby, PHP, ou até mesmo Perl, OCaml e ColdFusion. Custos e Sandbox A API do Google AdWords tem um custo para o anunciante, pois o Google cobra por sua utilização. Cada funcionalidade está associada a uma quantidade diferente de unidades de API. Cada unidades de API custam U$0,25 (dólares norte-americanos), ou seja, cada unidade custa U$0,00025 As funcionalidades de leitura de estruturas básicas, como campanhas, anúncios, palavras-chave, geralmente custam apenas 1 unidade (ou U$0,00025), porém as funcionalidades que envolvem alteração ou criação de dados, leitura de processamentos de relatórios, estimativas de palavras-chave, sugestão de sites podem chegar a 20 unidades por requisição. Todas as taxas de solicitações de cada operação da API do AdWords estão detalhadas no site da AdWords API. Cada chamada está associada a uma funcionalidade e custa uma quantidade específica de unidades de API. Para permitir que o anunciante só pague pela utilização da API quando o software estiver realmente pronto, o Google disponibiliza gratuitamente um ambiente de testes chamado sandbox. O anunciante não paga durante o desenvolvimento e testes do software no ambiente sandbox. Este ambiente simula o comportamento encontrado no ambiente de produção. Existem duas alterações a serem feitas para se utilizar o sandbox: cabeçalho soap e url dos webservices. 1. A url muda de para 2. O cabeçalho muda e deve ser preenchido desta forma: moeda da campanha; sendo que o da primeira conta é client_1+ericgomes@octavarium.com.br, e assim por diante até client_5+ericgomes@octavarium. com.br; <soapenv:header xmlns:soapenv=" > <v13:applicationtoken></v13:applicationtoken> <v13:developertoken>ericgomes@octavarium.com.br++brl </v13:developertoken> <v13:client >client_1+ericgomes@octavarium.com.br</v13:client > <v13: >ericgomes@octavarium.com.br</v13: > <v13:password>xxxxxxx</v13:password> <v13:useragent>opcional</v13:useragent> </soapenv:header> Todo o comportamento das campanhas pode ser analisado através de relatórios customizados. De acordo com o foco, podem ser gerados relatórios de abordagem específica sobre campanhas, grupos de anúncios, palavras-chave e métricas detalhadas sobre taxa de cliques, número de impressões, médias de posicionamento, taxa de conversões, custos, entre outras. Através do Web Service ReportService, é possível agendar e gerar relatórios customizados através da API. 62

6 Implementação Vamos ver agora um exemplo prático de utilização da API do Google AdWords. A aplicação Java que acompanha este artigo utiliza a API para gerenciar e otimizar uma campanha de links patrocinados do Google AdWords. Através do acompanhamento da oscilação da quantidade de produtos em estoque de uma loja fictícia, a aplicação determina quais palavras-chave devem ser utilizadas para ativar o anúncio da campanha on-line da loja no Google. Todos os produtos que estão em estoque precisam ser vendidos. Por isso os nomes dos produtos são utilizados como palavras-chave ativas. Por outro lado, os produtos que já foram vendidos não são utilizados como palavras-chave. A classe que inicia esta aplicação é AdWordsMundoj. Esta classe é responsável por iniciar a loja, colocá-la em funcionamento e anunciar seus produtos no Google AdWords, conforme Listagem 3. Para rodar a aplicação Java que acompanha este artigo, você precisa de uma conta no Google. Abra e edite o arquivo adwords-mundoj.properties na raiz do projeto e substitua as informações dos campos , password e client pelos dados da sua conta no Google (geralmente seu nome@gmail.com), conforme Listagem 2. Listagem 2. Arquivo de configuração adwords-mundoj.properties. #google adwords api namespace=com/api/adwords/v13 #google adwords authentication & autorization =ericgomes@octavarium.com.br password=xxxxxxxx developertoken=ericgomes@octavarium.com.br++brl client =client_1+ericgomes@octavarium.com.br useragent=octavarium Tecnologia - Google AdWords - Revista Mundoj applicationtoken= O trecho a seguir exemplifica o funcionamento da aplicação apresentando o log de execução. Repare que para este artigo foi definido que o ciclo principal rodará duas vezes. O número exato deve ser ajustado, caso a caso, em um ambiente real. LOJA AdWords API Mundoj 48 produtos EM ESTOQUE 52 produtos VENDIDOS Loja funcionando... Produtos são comprados e vendidos LOJA AdWords API Mundoj 23 produtos EM ESTOQUE 77 produtos VENDIDOS Listagem 3. Exemplo do ciclo de vida de uma loja. Loja loja = new Loja("AdWords API Mundoj", PRODUCTS_FILE_PATH); loja.report(); for (int i=0; i<2; i++) { loja.funciona(); loja.report();loja.anuncia(); A relação dos produtos comercializados pela loja fictícia está no arquivo XML thinkgeek-liquidacao.xml na raiz do projeto, conforme Listagem 4. Este XML é o RSS de produtos da seção de liquidação da ThinkGeek. A versão sempre atualizada dos produtos em liquidação da ThinkGeek. com está disponível no site da loja. A biblioteca Rome é utilizada para fazer o parse do arquivo xml, carregar os dados para a memória e popular a lista de produtos da loja, conforme Listagem 5. Esta biblioteca realmente cumpre o que promote: " ending syndication feed confusion by supporting all of 'em" - acabando com a confusão de feeds e rss dando suporte a todos eles. Listagem 4. Produtos comercializados pela loja. <channel> <title>thinkgeek :: Clearance Products</title> <link> <description>stuff for Smart Masses - Clearance Items</description> <language>en-us</language> <pubdate>thu, 27 Aug :25:48 GMT</pubDate> <lastbuilddate>sat, 29 Aug :00:29 GMT</lastBuildDate> <docs> <generator>thinkgeek, Inc. - Sphorb 6.0.0r4854</generator> <managingeditor>code@thinkgeek.com</managingeditor> <item> <title>26-piece PC Repair Tool Kit</title> <link> <guid> <description><img src=" products/thumb/large/26_piece_tool_kit.jpg" width="120" height="85" border="0" align="right"> 26-Piece PC Repair Tool Kit <p>price: <b>$17.99</b></p></description> <category>clearance</category> <pubdate>thu, 27 Aug :25:48 GMT</pubDate> </item> <item> <title>roadside Assistance Safety Kit</title> <link> <guid> <description><img src=" products/thumb/large/bf5e_roadside_assistance_safety_kit.jpg" width="95" height="130" border="0" align="right"> Roadside Assistance Safety Kit <p>price: <b>$17.99</b></p></ description> <category>clearance</category> <pubdate>thu, 27 Aug :22:23 GMT</pubDate> </item> </channel> Listagem 5. Leitura dos produtos. List<SyndEntryImpl> feeds = fullfeed.getentries(); for (SyndEntryImpl feed : feeds) { ProdutoVO produto = new ProdutoVO(feed.getUri(), feed.gettitle(), feed.getdescription().getvalue()); loja.setproduto(produto); Em seguida, a aplicação apresenta a situação inicial da loja: as quantidades de produtos que estão em estoque e que foram vendidos. A partir disso, a aplicação inicia a simulação principal do comportamento da loja, repetindo o mesmo procedimento duas vezes. O comportamento da loja é entrar em funcionamento, quan- 63

7 do acontece a oscilação aleatória do estoque com produtos sendo vendidos e recomprados para reposição de estoque; seguido pela reapresentação da situação do estoque e então a atualização automática da campanha de links patrocinados do Google AdWords, de acordo com o estoque. A aplicação contém uma package criada através do Apache Axis, para a comunicação com os WebServices do AdWords, e mais quatro packages específicas. O package business contém o código responsável pela implementação das regras de negócio, como o comportamento aleatório da venda e compra de produtos da loja, e da criação de campanha, grupo de anúncio, anúncio e palavras-chave no AdWords. O package dao contém as classes que fazem a ligação entre as classes do package business e as classes do package da API do AdWords. O package vo contém as classes que representam Loja e Produto, conforme Listagem 6. E por último a package útil contém classes utilitárias para parse de XML, log da aplicação, leitor de properties e criação do cabeçalho (header) da comunicação SOAP exigido pela API do AdWords. Toda vez que a loja entra em funcionamento, acontece o sorteio que determina se um produto foi comprado ou vendido. Se um produto foi vendido, este produto sai do estoque e vai para a condição de vendido. Caso contrário, se um produto foi comprado, este produto sai da condição de vendido e entra para o estoque. Quando a loja anuncia no AdWords, o comportamento é composto de três etapas. A primeira é a chamada ao método getclientsaccounts da AccountInterface, o que garante que o Google criará caso ainda não tenha criado cinco contas de clientes fictícios para testes na sandbox. Para esta aplicação, utilizamos apenas um cliente. As etapas seguintes são responsáveis pela obtenção e criação, caso ainda não existam, do anúncio de texto, do grupo de anúncio e da campanha do cliente. Por fim, as palavras-chave são ativadas e desativadas (pause true/false) de acordo com os produtos em estoque, no momento. A Listagem 7 apresenta o trecho de código executado toda vez que a loja anuncia seus produtos no Google AdWords e a Listagem 8 mostra o código Java para obtenção dos grupos de anúncio da campanha do cliente. Listagem 6. Classes para Produto e Loja. Listagem 7. Loja anunciando produtos no Google AdWords. public void anuncia() throws InvalidGoogleAdWordsAPIException { //cria clientes no sandbox Google caso não existam new Cliente().getClientes(); try { this.client = Properties.getProperty("client "); catch (IOException e) { throw new InvalidGoogleAdWordsAPIException(e.getMessage(), e); //recupera campanhas do cliente Campanha campanha = new Campanha(client ); for (Campaign campaign : campanha.getcampaigns()) { campanha.report(campaign); //recupera grupos de anúncios da campanha GrupoAnuncio grupoanuncio = new GrupoAnuncio(campaign.getId(), client ); for (AdGroup adgroup : grupoanuncio.getadgroups()) { grupoanuncio.report(adgroup); //recupera anúncios do grupo de anúncio AnuncioTexto anunciotexto = new AnuncioTexto(adGroup.getId(), client ); for (Ad ad : anunciotexto.getads()) { anunciotexto.report(ad); public class LojaVO { private String nome; private List<ProdutoVO> emestoque; private List<ProdutoVO> vendidos;... public class ProdutoVO { private String guid; private String titulo; private String descricao;... //atualizar palavras-chave do grupo de anúncio Logger.getLogger().info(" \natualizando palavras-chave do GOOGLE ADWORDS..."); PalavraChave palavrachave = new PalavraChave(adGroup.getId(), client ); palavrachave.resetcriteria(); palavrachave.setkeywords(loja.getemestoque(), false); palavrachave.setkeywords(loja.getvendidos(), true); 64

8 Listagem 8. Obtenção dos grupos de anúncios de uma campanha do AdWords private void initadgroupservice() throws InvalidGoogleAdWordsAPIException { try { adgroupservice = new AdGroupServiceLocator().getAdGroupService(); RemoteService.getService(adGroupService, client ); catch (ServiceException e) { throw new InvalidGoogleAdWordsAPIException( InvalidGoogleAdWordsAPIException.SERVICE_EXCEPTION_MSG, e); catch (IOException e) { throw new InvalidGoogleAdWordsAPIException(e.getMessage(), e); public AdGroup[] getadgroups() throws InvalidGoogleAdWordsAPIException { if (campaignid <= 0) return null; try { if (this.adgroupservice==null) { this.initadgroupservice(); adgroups = adgroupservice.getactiveadgroups(campaignid); catch (ApiException e) { throw new InvalidGoogleAdWordsAPIException( InvalidGoogleAdWordsAPIException.API_EXCEPTION_MSG, e); catch (RemoteException e) { throw new InvalidGoogleAdWordsAPIException( InvalidGoogleAdWordsAPIException.REMOTE_EXCEPTION_MSG, e); if (adgroups == null) { Logger.getLogger().info("\nGrupos de Anúncios inexistentes"); return adgroups; O volume de informações sobre o AdWords disponibilizado na própria Internet é enorme. No final deste artigo, você encontra uma lista dos principais sites, caso você tenha interesse em se aprofundar no assunto. O Google AdWords também movimenta o mundo dos negócios e gera empregos. Atualmente existem muitas empresas especializadas no gerenciamento e otimização de campanhas de links patrocinados do Google AdWords. Para garantir que o anunciante esteja sendo atendido por profissionais que realmente entendem do assunto, o Google criou o exame para certificação Google AdWords, que assegura a qualidade dos serviços prestados. O programa Google AdWords Professionals também oferece créditos promocionais, para serem utilizados em novas campanhas no AdWords, como bonificação para profissionais e empresas certificados. Versões da AdWords API O Google AdWords está em constante evolução. Por isso, a API também evolui. A equipe técnica responsável pela API trabalha constantemente na evolução da API garantindo que todas as funcionalidades do AdWords estejam também disponíveis na API. A versão apresentada neste artigo é a v13 da API. A v13 é a versão estável em produção e traz a garantia de ótimo funcionamento. Uma nova versão da API, batizada de v2009, está sendo desenvolvida pelo Google atualmente e promete novas funcionalidades, mais rapidez e um custo menor. A nova API v2009 não oferece compatibilidade com a v13, já que é uma reestruturação da API, expõe novos Web Services e traz um mecanismo diferente de utilização. A versão v ainda encontra-se em beta e por isso este artigo focou-se na versão v13. A tabela 2 apresenta uma visão macro entre as diferenças entre os Web Services das versões v13 e v2009. A lista de referências deste artigo o site para informações detalhadas sobre a nova versão v2009. Versão v13 CampaignService part of CriterionService part of CampaignService AdGroupService AdService CriterionService Considerações finais Versão v2009 CampaignService CampaignCriterionService CampaignTargetService AdGroupService AdGroupAdService AdGroupCriterionService O objetivo deste artigo foi apresentar um exemplo simples de utilização da Google AdWords API. Como já dito, a API disponibiliza todas as funcionalidades que já existem na interface web do sistema; portanto qualquer atividade feita pela interface web pode ser migrada para um software customizado e integrado ao AdWords através da API. O intuito é garantir o funcionamento 24 horas por dia sem interrupções e sem erros, economizar tempo e aumentar a lucratividade dos investimentos em publicidade on-line; aliás, é isso o que todas as empresas buscam para crescerem e continuarem fortes em seus mercados, não é mesmo? Referências O livro e os sites citados a seguir fazem parte da rotina de acompanhamento permanente sobre publicidade no Google e foram utilizados para a criação deste artigo. html - docs/ 65