Post on 21-Jan-2015
description
AdWords API Workshops – All rights reserved
AdWords API Workshops – All rights reserved
AdWords ScriptsAutomatize sua gestão de Adwords com Javascript
André Barros, Google, Inc.
AdWords API Workshops – All rights reserved
● Introdução
● Primeiros Passos + Demo
● Referências e Suporte
● Dúvidas
● Recursos
Agenda
AdWords API Workshops – All rights reserved
Introdução
AdWords API Workshops – All rights reserved
● 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
Introdução
AdWords API Workshops – All rights reserved
● Soluções 'One-time', simples e rápidas
● Relatórios Customizados
● Alertas automáticos de conta
● Integração com feeds externos
Casos de Uso Frequentes
AdWords API Workshops – All rights reserved
● Conhecimento básico de JavaScript
● Uma conta Adwords para criar seu primeiro script!
Requisitos
AdWords API Workshops – All rights reserved
● 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
Funcionalidades
AdWords API Workshops – All rights reserved
● 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.
Funcionalidades II
AdWords API Workshops – All rights reserved
● 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
Funcionalidades III
AdWords API Workshops – All rights reserved
Demo
AdWords API Workshops – All rights reserved
Criando seu primeiro script
AdWords API Workshops – All rights reserved
Criando seu primeiro script (cont’d)
AW SCRIPT
AdWords API Workshops – All rights reserved
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());
}
}
Exemplo - buscar todas as campanhas
AW SCRIPT
AdWords API Workshops – All rights reserved
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);
}
Buscar e atualizar objetos
AW SCRIPT
AdWords API Workshops – All rights reserved
function main() {
// 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");
Relatórios
AW SCRIPT
AdWords API Workshops – All rights reserved
// 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);
}
Relatórios II
AdWords API Workshops – All rights reserved
Referências e Suporte
AdWords API Workshops – All rights reserved
● 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
Documentação e exemplos
AdWords API Workshops – All rights reserved
● 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!
Tire suas dúvidas no forum!
AdWords API Workshops – All rights reserved
● 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/
Soluções completas
AdWords API Workshops – All rights reserved
Dúvidas?
AdWords API Workshops – All rights reserved
Recursos
Documentação: http://goo.gl/77ACPForum: http://goo.gl/QsxCz5
AdWords API Workshops – All rights reserved
AW SCRIPT
AdWords API Workshops – All rights reserved
var sitelink = AdWordsApp.extensions()
.newSitelinkBuilder()
.withLinkText("Hello world")
.withLinkUrl("http://www.example.com")
.create();
AdWordsApp.campaigns()
.withIds(['178532656'])
.get().next()
.addSitelink(sitelink);
Apêndice 1 - Criar SiteLinks
AW SCRIPT
AdWords API Workshops – All rights reserved
//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());
}
}
Apêndice 2 - Leitura de AdParams