1. AdWords API Workshops All rights reserved

2. AW Reports to DB Introduo a ferramentaby Gustavo Moreira +GustavoMenezes, Google, Inc. AdWords API Workshops All rights reserved 3. Agenda O que a ferramenta Viso geral Porque important? Como comear Prximos passosAdWords API Workshops All rights reserved 4. Definindo AW Reports to DB O que a ferramenta fazAdWords API Workshops All rights reserved 5. O Problema Grande nmero de contas Muita informao disponvel Difcil de escalar Muita informao tilAdWords API Workshops All rights reservedDefining AwReporting 6. A Soluo Use a API Download noturno Persiste localmente Desenvolva com base nos dadosAdWords API Workshops All rights reservedDefining AwReporting 7. A Ferramenta Download multi-thread Persiste em SQL DBs* Persiste tambm em MongoDB Lida com todo acessa a API Expe objetos Java * Hibernate utilizado para gerenciar a persistncia AdWords API Workshops All rights reservedDefining AwReporting 8. A Ferramenta open source! Criada para ser extendida Pode ser rodada da linha de comando Pode ser integrada em sua plataformaAdWords API Workshops All rights reservedDefining AwReporting 9. Uma Viso Geral Uma viso macro da ferramentaAdWords API Workshops All rights reserved 10. Como Que Funciona?In the cloudCustom Java codeAdWords APIJavaAwReportingProperties file Local file AdWords API Workshops All rights reservedDownloadersAwReporting ModelPart of the tool Internal to the tool User-specificDBCustom platform Any language 11. Componentes Report definitions Entity persisters AwReporting mainExecutes the download and persistence Handles the persistence layerEntity persistersMap the reports to entitiesReport definitionsLocal to the userAdWords API Workshops All rights reservedAwReporting mainDatabaseA Quick Overview 12. Report Definitions Java Beans com anotaes Java@Entity @Table(name = "AW_ReportAd") @CsvReport(value = AD_PERFORMANCE_REPORT) // CSV Report public class ReportAd extends Report { // Field annotations @Column(name = "AD_ID") @CsvField(value = "Ad ID", reportField = "Id") public Long adId;AdWords API Workshops All rights reservedA Quick Overview 13. Report Definitions @CsvReport(value = AD_PERFORMANCE_REPORT) O mesmo nome que encontrado na documentao https://developers.google.com/adwords/api/docs/appendix/reports *@CsvField(value = "Ad ID", reportField = "Id") Display name, e report field tambm da documentao * Links esto disponveis no fim da apresentao AdWords API Workshops All rights reservedA Quick Overview 14. Report Definitions AdWords APIReport (CSV)Report definitionJava bean AwReportingReport definitionPersisterJava beanReport definition DB Combined AdWords API Workshops All rights reservedA Quick Overview 15. Entity Persisters Interface para gerenciar as entidades J possui os mtodos de save, delete e get Use-os para acessar o BD! Conversam Java Bean com a aplicaoAdWords API Workshops All rights reservedA Quick Overview 16. Entity Persisters Toma conta das transaes de banco Trata as excees Type safeAdWords API Workshops All rights reservedA Quick Overview 17. AwReporting Main Coordena todos os mdulos Cuida do paralelismo Roda como standalone na linha de comando Configurao flexvel Usa OAuth 2.0 para autenticao (APENAS)AdWords API Workshops All rights reservedA Quick Overview 18. AwReporting Main Configurao toda em arquivo properties Properties mccAccountId= developerToken= ... aw.report.model.db.mysql.driver=com.mysql.jdbc.Driver ... aw.report.downloader.num.threads=20 ... // Define the reports fields to be selected KEYWORDS_PERFORMANCE_REPORT=ExternalCustomerId,Date,...AdWords API Workshops All rights reservedA Quick Overview 19. AwReporting Main Standalone na linha de comando: $ java -Xmx512m -jar aw-report-tool.jar -startDate -endDate -file /configuration.properties startDate, endDate: yyyyMMdd format file: arquivo propertiesAdWords API Workshops All rights reservedA Quick Overview 20. Possveis Casos de Uso Porque a ferramenta importanteAdWords API Workshops All rights reserved 21. Reduzindo tempo de adoo da API Soluo out of the box para relatrios Muito pouco tempo de desenvolvimento necessrio ltima verso da API Fcil de extenderAdWords API Workshops All rights reservedPossible Applications 22. Siga o Exemplo Boas prticas aplicadas ao mundo real Exemplos executveis muito bons Os DAs investem tempo na ferramenta! Mais funcionalidades vo surgirAdWords API Workshops All rights reservedPossible Applications 23. Ponto de Incio Relatrios no vo ser mais problema Mais fcil lidar com dados locais Primeiro passo para automao Gerao de relatrios automticos para clientes?AdWords API Workshops All rights reservedPossible Applications 24. Como Comear Take my money!AdWords API Workshops All rights reserved 25. Building the Tool Comece baixando o cdigo: http://goo.gl/TQxIdN * Siga as instrues para fazer o build Lembre-se que tudo open source* Resources will be available in the final slides AdWords API Workshops All rights reservedGetting Started 26. DemoAdWords API Workshops All rights reserved 27. Acessando o Cdigo Fonte Formato padro Maven de projeto $ mvn eclipse:eclipse Voc pode editar, e criar sua prpria verso! Dois mdulos/projetos diferentesAdWords API Workshops All rights reservedGetting Started 28. DemoAdWords API Workshops All rights reserved 29. System Requirements AdWords developer token Banco de Dados (MySQL/MongoDB/SQL*) Java 6AdWords API Workshops All rights reservedGetting Started 30. Knowledge Requirements (para programar) Java 6 - Annotations, Generics, etc. Maven - build Spring framework, Hibernate - beans e banco de dadosAdWords API Workshops All rights reservedGetting Started 31. Customizando a Ferramenta Adicione um novo relatrio, com um novo definition Gerencie os downloads pelo arquivo properties Campos do banco por anotaes Entity persister para acessar os dadosAdWords API Workshops All rights reservedGetting Started 32. DemoAdWords API Workshops All rights reserved 33. Dando o Prximo Passo E agora?AdWords API Workshops All rights reserved 34. Os Dados so Todos seus! Crie seus prprios relatrios Otimize baseado nos valores dos relatrios Auto-criao de relatrios em PDF Integre com seus sistemas internosAdWords API Workshops All rights reservedTaking the Extra Step 35. Aplicao no Exclusiva Pode ser usada em conjunto com outras plataformas Defina sua prpria base de dados No necessrio desenvolver em Java Siga as boas prticas mostradas, crie sua prpria!AdWords API Workshops All rights reservedTaking the Extra Step 36. Buscando Automao Completa Dados so essenciais para automao Gerencie campanhas, ads, palavras-chave, etc. Feedback para melhor otimizao Histrico de performanceAdWords API Workshops All rights reservedTaking the Extra Step 37. Links AW Reports to DB - https://github.com/googleads/aw-reporting Documentao de relatrios - https://developers.google. com/adwords/api/docs/appendix/reportsAdWords API Workshops All rights reserved 38. Perguntas? Muito obrigado!AdWords API Workshops All rights reserved 39. AdWords API Workshops All rights reserved