AdWords API Workshops – All rights reserved
AdWords Scripts
Automatize sua gestão de Adwords com Javascript

André Barros, Google, Inc.

AdWords API Workshops – All r...
Agenda
● Introdução
● Primeiros Passos + Demo
● Referências e Suporte
● Dúvidas
● Recursos

AdWords API Workshops – All ri...
Introdução

AdWords API Workshops – All rights reserved
Introdução
● Mecanismo para acessar os dados do Adwords de forma
por programação
● Escreva seu código em JavaScript
● IDE ...
Casos de Uso Frequentes
● Soluções 'One-time', simples e rápidas
● Relatórios Customizados
● Alertas automáticos de conta
...
Requisitos
● Conhecimento básico de JavaScript
● Uma conta Adwords para criar seu primeiro script!

AdWords API Workshops ...
Funcionalidades
● Acessar os principais elementos do Adwords:
○ Campanhas, Grupos, Palavras-chave, Anúncios,
Extensões, Re...
Funcionalidades II
● IDE com autocomplete e syntax highlighting
● Execute diretamente ou em modo preview
○ O Modo Preview ...
Funcionalidades III
● Scripts podem executar automaticamente
○ Podem ser agendados e executar periodicamente
○ Tempo máxim...
Demo

AdWords API Workshops – All rights reserved
Criando seu primeiro script

AdWords API Workshops – All rights reserved
Criando seu primeiro script (cont’d)

AdWords API Workshops – All rights reserved
Exemplo - buscar todas as campanhas
function main() {
// Get all campaigns.
var campaignIterator = AdWordsApp.campaigns()....
Buscar e atualizar objetos
function main() {
// Retrieve campaign by name using AWQL.
var demoCampaign = AdWordsApp.campai...
Relatórios
function main() {

AW SCRIPT

// Run an account performance report
var report = AdWordsApp.report("SELECT Click...
Relatórios II
// Export the report to spreadsheet
report.exportToSheet(sheet);
// Send out an email with the spreadsheet l...
Referências e Suporte

AdWords API Workshops – All rights reserved
Documentação e exemplos
● Documentação disponível em:
○ https://developers.google.com/adwords/scripts/

● Exemplos de códi...
Tire suas dúvidas no forum!
● Tire suas dúvidas no forum
○ https://groups.google.com/forum/#!forum/adwords-scripts
○ Dúvid...
Soluções completas
● Soluções completas e prontas para uso
○
○
○
○

https://developers.google.com/adwords/scripts/docs/sol...
Dúvidas?

AdWords API Workshops – All rights reserved
Recursos
Documentação: http://goo.gl/77ACP
Forum: http://goo.gl/QsxCz5

AdWords API Workshops – All rights reserved
AdWords API Workshops – All rights reserved
Apêndice 1 - Criar SiteLinks
var sitelink = AdWordsApp.extensions()
.newSitelinkBuilder()
.withLinkText("Hello world")
.wi...
Apêndice 2 - Leitura de AdParams
//interator on keywords
var kwIter = AdWordsApp.keywords().get(); //this is long, select ...
Upcoming SlideShare
Loading in...5
×

AdWords Scripts

327

Published on

São Paulo AdWords API Workshops

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
327
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
6
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

AdWords Scripts

  1. 1. AdWords API Workshops – All rights reserved
  2. 2. AdWords Scripts Automatize sua gestão de Adwords com Javascript André Barros, Google, Inc. AdWords API Workshops – All rights reserved
  3. 3. Agenda ● Introdução ● Primeiros Passos + Demo ● Referências e Suporte ● Dúvidas ● Recursos AdWords API Workshops – All rights reserved
  4. 4. Introdução AdWords API Workshops – All rights reserved
  5. 5. Introdução ● Mecanismo para acessar os dados do Adwords de forma por programação ● Escreva seu código em JavaScript ● IDE integrada diretamente na UI do AdWords AdWords API Workshops – All rights reserved
  6. 6. Casos de Uso Frequentes ● Soluções 'One-time', simples e rápidas ● Relatórios Customizados ● Alertas automáticos de conta ● Integração com feeds externos AdWords API Workshops – All rights reserved
  7. 7. Requisitos ● Conhecimento básico de JavaScript ● Uma conta Adwords para criar seu primeiro script! AdWords API Workshops – All rights reserved
  8. 8. Funcionalidades ● Acessar os principais elementos do Adwords: ○ Campanhas, Grupos, Palavras-chave, Anúncios, Extensões, Relatórios… ● Elementos específicos da API ○ Ad Params ● Elementos ainda não disponíveis na API do Adwords ○ Labels ● Sem limitações de Beta, como na API AdWords API Workshops – All rights reserved
  9. 9. Funcionalidades II ● IDE com autocomplete e syntax highlighting ● Execute diretamente ou em modo preview ○ O Modo Preview não faz alterações nas contas ○ Mas executa ações como disparo de emails, atualização de planilhas, etc. ● Utiliza OAuth 2.0 para autenticação ○ Limite de 250 scripts por email de login. AdWords API Workshops – All rights reserved
  10. 10. Funcionalidades III ● Scripts podem executar automaticamente ○ Podem ser agendados e executar periodicamente ○ Tempo máximo de execução: 30 minutos ○ Frequência máxima: 1x por hora ● Comunicação com fontes externas de dados ○ ○ ○ ○ Download the URLs arbitrárias Integração com Google Drive Integração com Google Spreadsheets Envio de emails AdWords API Workshops – All rights reserved
  11. 11. Demo AdWords API Workshops – All rights reserved
  12. 12. Criando seu primeiro script AdWords API Workshops – All rights reserved
  13. 13. Criando seu primeiro script (cont’d) AdWords API Workshops – All rights reserved
  14. 14. Exemplo - buscar todas as campanhas function main() { // Get all campaigns. var campaignIterator = AdWordsApp.campaigns().get(); // iterate the list and print names to logger window. while (campaignIterator.hasNext()) { var campaign = campaignIterator.next(); Logger.log(campaign.getName()); } } AdWords API Workshops – All rights reserved AW SCRIPT
  15. 15. Buscar e atualizar objetos function main() { // Retrieve campaign by name using AWQL. var demoCampaign = AdWordsApp.campaigns(). withCondition("Name='Demo campaign'").get().next(); // Retrieve child adgroup using AWQL. var demoAdGroup = demoCampaign.adGroups(). withCondition("Name='Demo adgroup'").get().next(); // Modify the adgroup properties. demoAdGroup.setKeywordMaxCpc(1.2); } AdWords API Workshops – All rights reserved AW SCRIPT
  16. 16. Relatórios function main() { AW SCRIPT // Run an account performance report var report = AdWordsApp.report("SELECT Clicks, Impressions, " + "Cost, AverageCpc, Date FROM ACCOUNT_PERFORMANCE_REPORT " + "DURING LAST_WEEK"); // Retrieve the spreadsheet to export values to. var SPREADSHEET_URL = "xxx"; var spreadsheet = SpreadsheetApp.openByUrl(SPREADSHEET_URL); var sheet = spreadsheet.getSheetByName( "Account performance report"); AdWords API Workshops – All rights reserved
  17. 17. Relatórios II // Export the report to spreadsheet report.exportToSheet(sheet); // Send out an email with the spreadsheet link MailApp.sendEmail("john_hancock@google.com", "Account performance report is ready!", "Access it at " + SPREADSHEET_URL); } AdWords API Workshops – All rights reserved AW SCRIPT
  18. 18. Referências e Suporte AdWords API Workshops – All rights reserved
  19. 19. Documentação e exemplos ● Documentação disponível em: ○ https://developers.google.com/adwords/scripts/ ● Exemplos de código: ○ Disponíveis diretamente no IDE (Adwords UI) ○ Também disponiveis no site acima AdWords API Workshops – All rights reserved
  20. 20. Tire suas dúvidas no forum! ● Tire suas dúvidas no forum ○ https://groups.google.com/forum/#!forum/adwords-scripts ○ Dúvidas em geral, exemplos de códigos, feature requests… ○ Diversos desenvolvedores prontos para ajudar, além de integrantes do time de Scripts! AdWords API Workshops – All rights reserved
  21. 21. Soluções completas ● Soluções completas e prontas para uso ○ ○ ○ ○ https://developers.google.com/adwords/scripts/docs/solutions/ Podem ser utilizadas diretamente, sem alterações ou customizadas, se necessário Organizadas por categoria de solução - Relatórios customizados, soluções de bid… ● Repositório com Scripts de terceiros: ○ http://www.freeadwordsscripts.com/ AdWords API Workshops – All rights reserved
  22. 22. Dúvidas? AdWords API Workshops – All rights reserved
  23. 23. Recursos Documentação: http://goo.gl/77ACP Forum: http://goo.gl/QsxCz5 AdWords API Workshops – All rights reserved
  24. 24. AdWords API Workshops – All rights reserved
  25. 25. Apêndice 1 - Criar SiteLinks var sitelink = AdWordsApp.extensions() .newSitelinkBuilder() .withLinkText("Hello world") .withLinkUrl("http://www.example.com") .create(); AdWordsApp.campaigns() .withIds(['178532656']) .get().next() .addSitelink(sitelink); AdWords API Workshops – All rights reserved AW SCRIPT
  26. 26. Apêndice 2 - Leitura de AdParams //interator on keywords var kwIter = AdWordsApp.keywords().get(); //this is long, select campaign first while (kwIter.hasNext()) { //iterator on parameter of the current keyword var adParamIter = kwIter.next().adParams().get(); while (adParamIter.hasNext()) { var adParam = adParamIter.next(); Logger.log("campaign="+ adParam.getAdGroup().getCampaign().getName()+ " AdGroup="+ adParam.getAdGroup().getName()+ " KW=" + adParam.getKeyword().getText() + " idx=" + adParam.getIndex() + " value=" + adParam.getInsertionText()); } } AdWords API Workshops – All rights reserved AW SCRIPT
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×