AdWords Scripts

AdWords API Workshops – All rights reserved


AdWords ScriptsAutomatize sua gestão de Adwords com Javascript

André Barros, Google, Inc.


● Introdução

● Primeiros Passos + Demo

● Referências e Suporte

● Dúvidas

● Recursos

Agenda


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

Introdução


● 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


● Conhecimento básico de JavaScript

● Uma conta Adwords para criar seu primeiro script!

Requisitos


● 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


● 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


● 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


Demo


Criando seu primeiro script


Criando seu primeiro script (cont’d)

AW SCRIPT


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


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


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


// Export the report to spreadsheet

report.exportToSheet(sheet);

// Send out an email with the spreadsheet link

MailApp.sendEmail("[email protected]",

"Account performance report is ready!",

"Access it at " + SPREADSHEET_URL);

}

Relatórios II


Referências e Suporte


● 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

https://developers.google.com/adwords/scripts/

https://developers.google.com/adwords/scripts/


● 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!

https://groups.google.com/forum/#!forum/adwords-scripts

https://groups.google.com/forum/#!forum/adwords-scripts


● 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

https://developers.google.com/adwords/scripts/docs/solutions/

https://developers.google.com/adwords/scripts/docs/solutions/

http://www.google.com/url?q=http%3A%2F%2Fwww.freeadwordsscripts.com%2F&sa=D&sntz=1&usg=AFQjCNGF5tktI3-dGikV6HqFdCv2s54FHw

http://www.google.com/url?q=http%3A%2F%2Fwww.freeadwordsscripts.com%2F&sa=D&sntz=1&usg=AFQjCNGF5tktI3-dGikV6HqFdCv2s54FHw


Dúvidas?


Recursos

Documentação: http://goo.gl/77ACPForum: http://goo.gl/QsxCz5


AW SCRIPT


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


//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

Technology

AdWords Scripts