awreporting tool introduction (spanish)


AwReportingIntroducción a la herramienta

por Gustavo Moreira+GustavoMenezes, Google Inc.


● Qué es la herramienta

● Visión general

● ¿Por qué es importante?

● Primeros pasos

● Próximos pasos

Agenda


Definiendo AwReportingQué es la herramienta

AdWords API Workshops – All rights reserved Definiendo AwReporting

● Gran número de cuentas

● Gran cantidad de información

● Difícicultad para crecer

● Información muy útil

El Problema


● Usar la API

● Descargar por la noche

● Almacenar localmente

● Utilizar como base

La Solución

Definiendo AwReporting


● 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

La Herramienta



Visión GeneralUna explicación del entorno de la herramienta


¿Cómo funciona?

Properties file

AwReporting

Downloaders

DBAwReporting

Model

AdWords API

Custom platform

Custom Java code

En la nube

En la herramienta

Detalle interno

Específico usuario

Local file

Java

Any language


● Definiciones de informes

● Entity persisters

● AwReporting principal

Componentes

DatabaseLocal al usuário

Report definitionsMapea los informes en entidades

Entity persistersAdministración de la franja de datos

AwReporting main

Descarga los archivos y almacena en BD

Visión General


Definiciones de Informes

@Entity @Table(name = "AW_ReportAd")

@CsvReport(value = AD_PERFORMANCE_REPORT) // CSV Reportpublic class ReportAd extends Report {

// Field annotations@Column(name = "AD_ID")

@CsvField(value = "Ad ID", reportField = "Id") public Long adId;

Java

● Java Beans con annotations

Visión General


Definiciones de Informes (cont.)

@CsvReport(value = AD_PERFORMANCE_REPORT)

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

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

* Enlaces al final de la presentación

● El display name, y el report field

Visión General

https://developers.google.com/adwords/api/docs/appendix/reports



Definiciones de Informes (cont.)

AdWords API

Report (CSV) AwReporting

Report definition

DB

Java bean

Report definition

Persister

Combined

Java bean

Report definition

Visión General


● Interfaz para administrar entidades

● Posee métodos para guardar, borrar y listar

● Uselas para acceder la base de datos!

● Habla Java Bean!

Entity Persisters

Visión General


● Administra las transacciones con la base de datos

● Administra los errores y fallos

● Type safe

Entity Persisters (cont.)

Visión General


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

AwReporting Principal

Visión General


● Configuración del archivo de propiedades


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 selectedKEYWORDS_PERFORMANCE_REPORT=ExternalCustomerId,Date,...

Properties

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

Posibles Aplicaciones


● Mejores praxis aplicadas al mundo real

● Buenos ejemplos ejecutables

● Los DAs invierten tiempo en su mantenimiento

● Más funcionalidades por venir

Siguiendo el Ejemplo



● 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

Punto de Partida



Dónde EmpezarLos 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ónDónde Empezar

http://goo.gl/TQxIdN

http://goo.gl/TQxIdN


Demostración


● Formato estándar de proyecto Maven

● $ mvn eclipse:eclipse

● Puedes editar, y compilar tu mismo!

● Hay dos módulos/proyectos diferentes

Accediendo al Código Fuente

Dónde Empezar


Demostración


● AdWords developer token

● Base de datos (MySQL)

● Java 6

Prerrequisitos del Sistema

Dónde Empezar


● Java 6 - Annotations, Generics, etc.

● Maven - build

● Spring framework, Hibernate - beans and database

Prerrequisitos de Conocimiento (programar)

Dónde Empezar


● 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

Modificar la Herramienta

Dónde Empezar


Demostración


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

Dando el Próximo Paso


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

La Herramienta como Complemento



● Necesitas datos para automatizar

● Administración de campaigns, ads, keywords, etc.

● Feedback para optimización

● Historial de servicio

Buscando la Automatización Completa



EnlacesAwReporting - https://github.com/googleads/aw-reporting

Report documentation - https://developers.google.com/adwords/api/docs/appendix/reports

https://www.google.com/url?q=https%3A%2F%2Fgithub.com%2Fgoogleads%2Faw-reporting&sa=D&sntz=1&usg=AFQjCNG0zh4PwTAo2SIWmkHZcxcrRiUVpg





¿Preguntas?¡Muchas gracias!

awreporting tool introduction (spanish)

Technology

awreporting qu

herramienta visin general

awreporting introduccin

report field

annotations java

objetos java

extends report

report csv report public