AwReporting tool introduction (Spanish)

AwReporting
Introducción a la herramienta

por Gustavo Moreira
+GustavoMenezes, Google Inc.

Agenda
● Qué es la herramienta
● Visión general
● ¿Por qué es importante?
● Primeros pasos
● Próximos pasos


Definiendo AwReporting
Qué es la herramienta


El Problema
● Gran número de cuentas
● Gran cantidad de información
● Difícicultad para crecer
● Información muy útil



La Solución
● Usar la API
● Descargar por la noche
● Almacenar localmente
● Utilizar como base



La Herramienta
● Descarga con múltiples hilos
● Almacenamiento en SQL BDs*
● Almacenamiento opcional en MongoDB
● Administración de los accesos a la API
● Expone objetos Java
● * Usa Hibernate para almacenar los objetos


La Herramienta
● ¡Código abierto!
● Diseño extensible
● Puede ser usada en línea de comandos
● Puede integrarse con tus sistemas



Visión General
Una explicación del entorno de la herramienta


¿Cómo funciona?

En la nube

Custom Java
code

AdWords
API

Java

AwReporting

Properties
file
Local file

Downloaders

AwReporting
Model

En la herramienta
Detalle interno
Específico usuario

DB

Custom
platform
Any language

Componentes
● Definiciones de informes
● Entity persisters
● AwReporting principal

Descarga los
archivos y
almacena en BD
Administración de
la franja de datos

Mapea los informes
en entidades

Local al usuário


AwReporting
main

Entity persisters

Report definitions

Database

Visión General

Definiciones de Informes
● Java Beans con annotations
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;


Visión General

Definiciones de Informes (cont.)
@CsvReport(value = AD_PERFORMANCE_REPORT)

● El nombre que está en la documentación:
○ https://developers.google.com/adwords/api/docs/appendix/reports *

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

● El display name, y el report field
* Enlaces al final de la presentación

Visión General

Definiciones de Informes (cont.)
AdWords
API

Report
(CSV)

Report
definition

Java
bean
AwReporting

Report
definition

Persister

Java
bean

Report
definition
DB
Combined

Visión General

Entity Persisters
● Interfaz para administrar entidades
● Posee métodos para guardar, borrar y listar
● Uselas para acceder la base de datos!
● Habla Java Bean!


Visión General

Entity Persisters (cont.)
● Administra las transacciones con la base de datos
● Administra los errores y fallos
● Type safe


Visión General

AwReporting Principal
● Coordina todo el proceso
● Administra el paralelismo
● Funciona en la línea de comandos
● Configuración flexible
● Usa OAuth 2.0 para autenticación (únicamente)


Visión General

● Configuración del archivo de propiedades
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,...


Visión General

● Línea de comandos
$ java -Xmx512m -jar aw-report-tool.jar
-startDate <some date>
-endDate <some date>
-file <properties-location>/configuration.properties

● startDate, endDate: yyyyMMdd
● file: el archivo de configuración


Visión General

Posibles Aplicaciones
Por qué la herramienta es importante


Reduciendo la Curva de Aprendizaje
● Solución lista para descargar informes
● Poco trabajo necesario para empezar
● Última versión de la API
● Fácil de extender



Siguiendo el Ejemplo
● Mejores praxis aplicadas al mundo real
● Buenos ejemplos ejecutables
● Los DAs invierten tiempo en su mantenimiento
● Más funcionalidades por venir



Punto de Partida
● Ahorrate el trabajo de procesar informes
● Los datos locales son más fáciles de administrar
● Primer paso para la automatización
● Se pueden generar informes de forma automática para
los clientes



Dónde Empezar
Los primeros pasos


Compilando la herramienta
● Descargue el código fuente:
○

http://goo.gl/TQxIdN *

● Siga el guia para compilar la herramienta
● Todo es open source

* Enlaces al final de la presentación

Dónde Empezar

Demostración


Accediendo al Código Fuente
● Formato estándar de proyecto Maven
● $ mvn eclipse:eclipse
● Puedes editar, y compilar tu mismo!
● Hay dos módulos/proyectos diferentes


Dónde Empezar

Prerrequisitos del Sistema
● AdWords developer token
● Base de datos (MySQL)
● Java 6


Dónde Empezar

Prerrequisitos de Conocimiento (programar)
● Java 6 - Annotations, Generics, etc.
● Maven - build
● Spring framework, Hibernate - beans and database


Dónde Empezar

Modificar la Herramienta
● Añadir un nuevo informe creando una nueva definición
● Administrar las descargas en el archivo de configuración
● Campos de la base de datos por annotations
● Entity persister para acceder los datos


Dónde Empezar

Dando el Próximo Paso
¿Y ahora qué?


Los Datos son Suyos!
● Cree sus informes
● Optimice sus cuentas de clientes
● Autogenere informes en PDF
● Integre con otros sistemas internos



La Herramienta como Complemento
● La herramienta funciona bien con otras plataformas
● Defina su propia base de datos
● No necesitas conocimiento de Java
● Siga las mejores praxis, cree su propia herramienta!



Buscando la Automatización Completa
● Necesitas datos para automatizar
● Administración de campaigns, ads, keywords, etc.
● Feedback para optimización
● Historial de servicio



Enlaces
AwReporting - https://github.com/googleads/aw-reporting
Report documentation - https://developers.google.
com/adwords/api/docs/appendix/reports


¿Preguntas?
¡Muchas gracias!


AwReporting tool introduction (Spanish)

Más contenido relacionado

Similar a AwReporting tool introduction (Spanish) (20)

Más de marcwan (19)

Último (20)

AwReporting tool introduction (Spanish)