AwReporting Tool

AW Reports to DB
Introdução a ferramenta

by Gustavo Moreira
+GustavoMenezes, Google, Inc.

Agenda
● O que é a ferramenta
● Visão geral
● Porque é important?
● Como começar
● Próximos passos


Definindo AW Reports to DB
O que a ferramenta faz


O Problema
● Grande número de contas
● Muita informação disponível
● Difícil de escalar
● Muita informação útil


Defining AwReporting

A Solução
● Use a API
● Download noturno
● Persiste localmente
● Desenvolva com
base nos dados



A Ferramenta
● Download multi-thread
● Persiste em SQL DBs*
● Persiste também em MongoDB
● Lida com todo acessa a API
● Expõe objetos Java
● * Hibernate é utilizado para gerenciar a persistência


A Ferramenta
● É open source!
● Criada para ser extendida
● Pode ser rodada da linha de comando
● Pode ser integrada em sua plataforma



Uma Visão Geral
Uma visão macro da ferramenta


Como Que Funciona?

In the cloud

Custom Java
code

AdWords
API

Java

AwReporting

Properties
file
Local file

Downloaders

AwReporting
Model

Part of the tool
Internal to the tool
User-specific

DB

Custom
platform
Any language

Componentes
● Report definitions
● Entity persisters
● AwReporting main

Executes the
download and
persistence
Handles the
persistence layer

Entity persisters

Map the reports to
entities

Report definitions

Local to the user


AwReporting
main

Database

A Quick Overview

Report Definitions
● Java Beans com anotações
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;


A Quick Overview

Report Definitions
@CsvReport(value = AD_PERFORMANCE_REPORT)

● O mesmo nome que é encontrado na documentação
○ https://developers.google.com/adwords/api/docs/appendix/reports *

@CsvField(value = "Ad ID", reportField = "Id")

● Display name, e report field também da documentação
* Links estão disponíveis no fim da apresentação

A Quick Overview

Report Definitions
AdWords
API

Report
(CSV)

Report
definition

Java
bean
AwReporting

Report
definition

Persister

Java
bean

Report
definition
DB
Combined

A Quick Overview

Entity Persisters
● Interface para gerenciar as entidades
● Já possui os métodos de save, delete e get
● Use-os para acessar o BD!
● Conversam Java Bean com a aplicação


A Quick Overview

Entity Persisters
● Toma conta das transações de banco
● Trata as exceções
● Type safe


A Quick Overview

AwReporting Main
● Coordena todos os módulos
● Cuida do paralelismo
● Roda como standalone na linha de comando
● Configuração flexível
● Usa OAuth 2.0 para autenticação (APENAS)


A Quick Overview

AwReporting Main
● Configuração toda em arquivo properties
Properties
mccAccountId=<MCC>
developerToken=<Developer Token>
...
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,...


A Quick Overview

AwReporting Main
● Standalone na linha de comando:
$ java -Xmx512m -jar aw-report-tool.jar
-startDate <some date>
-endDate <some date>
-file <properties-location>/configuration.properties

● startDate, endDate: yyyyMMdd format
● file: arquivo properties


A Quick Overview

Possíveis Casos de Uso
Porque a ferramenta é importante


Reduzindo tempo de adoção da API
● Solução out of the box para relatórios
● Muito pouco tempo de desenvolvimento necessário
● Última versão da API
● Fácil de extender


Possible Applications

Siga o Exemplo
● Boas práticas aplicadas ao mundo real
● Exemplos executáveis muito bons
● Os DAs investem tempo na ferramenta!
● Mais funcionalidades vão surgir



Ponto de Início
● Relatórios não vão ser mais problema
● Mais fácil lidar com dados locais
● Primeiro passo para automação
● Geração de relatórios automáticos para clientes?



Como Começar
Take my money!


Building the Tool
● Comece baixando o código:
○

http://goo.gl/TQxIdN *

● Siga as instruções para fazer o build
● Lembre-se que tudo é open source

* Resources will be available in the final slides

Getting Started

Demo


Acessando o Código Fonte
● Formato padrão Maven de projeto
● $ mvn eclipse:eclipse
● Você pode editar, e criar sua própria versão!
● Dois módulos/projetos diferentes


Getting Started

System Requirements
● AdWords developer token
● Banco de Dados (MySQL/MongoDB/SQL*)
● Java 6


Getting Started

Knowledge Requirements (para programar)
● Java 6 - Annotations, Generics, etc.
● Maven - build
● Spring framework, Hibernate - beans e banco de dados


Getting Started

Customizando a Ferramenta
● Adicione um novo relatório, com um novo definition
● Gerencie os downloads pelo arquivo properties
● Campos do banco por anotações
● Entity persister para acessar os dados


Getting Started

Dando o Próximo Passo
E agora?


Os Dados são Todos seus!
● Crie seus próprios relatórios
● Otimize baseado nos valores dos relatórios
● Auto-criação de relatórios em PDF
● Integre com seus sistemas internos


Taking the Extra Step

Aplicação não Exclusiva
● Pode ser usada em conjunto com outras plataformas
● Defina sua própria base de dados
● Não é necessário desenvolver em Java
● Siga as boas práticas mostradas, crie sua própria!



Buscando Automação Completa
● Dados são essenciais para automação
● Gerencie campanhas, ads, palavras-chave, etc.
● Feedback para melhor otimização
● Histórico de performance



Links
AW Reports to DB - https://github.com/googleads/aw-reporting
Documentação de relatórios - https://developers.google.
com/adwords/api/docs/appendix/reports


Perguntas?
Muito obrigado!


AwReporting Tool

Recommandé

Recommandé

Contenu connexe

Similaire à AwReporting Tool

Similaire à AwReporting Tool (20)

Plus de marcwan

Plus de marcwan (20)

AwReporting Tool