AdWords API Workshops – All rights reserved
AdWords API Workshops – All rights reserved
AwReportingIntroducción a la herramienta
por Gustavo Moreira+GustavoMenezes, Google Inc.
AdWords API Workshops – All rights reserved
● Qué es la herramienta
● Visión general
● ¿Por qué es importante?
● Primeros pasos
● Próximos pasos
Agenda
AdWords API Workshops – All rights reserved
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
AdWords API Workshops – All rights reserved
● Usar la API
● Descargar por la noche
● Almacenar localmente
● Utilizar como base
La Solución
Definiendo AwReporting
AdWords API Workshops – All rights reserved
● 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
Definiendo AwReporting
AdWords API Workshops – All rights reserved
● ¡Código abierto!
● Diseño extensible
● Puede ser usada en línea de comandos
● Puede integrarse con tus sistemas
La Herramienta
Definiendo AwReporting
AdWords API Workshops – All rights reserved
Visión GeneralUna explicación del entorno de la herramienta
AdWords API Workshops – All rights reserved
¿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
AdWords API Workshops – All rights reserved
● 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
AdWords API Workshops – All rights reserved
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
AdWords API Workshops – All rights reserved
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
AdWords API Workshops – All rights reserved
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
AdWords API Workshops – All rights reserved
● 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
AdWords API Workshops – All rights reserved
● Administra las transacciones con la base de datos
● Administra los errores y fallos
● Type safe
Entity Persisters (cont.)
Visión General
AdWords API Workshops – All rights reserved
● 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
AdWords API Workshops – All rights reserved
● Configuración del archivo de propiedades
AwReporting Principal
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
AdWords API Workshops – All rights reserved
● Línea de comandos
AwReporting Principal
$ 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
AdWords API Workshops – All rights reserved
Posibles AplicacionesPor qué la herramienta es importante
AdWords API Workshops – All rights reserved
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
AdWords API Workshops – All rights reserved
● Mejores praxis aplicadas al mundo real
● Buenos ejemplos ejecutables
● Los DAs invierten tiempo en su mantenimiento
● Más funcionalidades por venir
Siguiendo el Ejemplo
Posibles Aplicaciones
AdWords API Workshops – All rights reserved
● 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
Posibles Aplicaciones
AdWords API Workshops – All rights reserved
Dónde EmpezarLos primeros pasos
AdWords API Workshops – All rights reserved
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
AdWords API Workshops – All rights reserved
Demostración
AdWords API Workshops – All rights reserved
● 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
AdWords API Workshops – All rights reserved
Demostración
AdWords API Workshops – All rights reserved
● AdWords developer token
● Base de datos (MySQL)
● Java 6
Prerrequisitos del Sistema
Dónde Empezar
AdWords API Workshops – All rights reserved
● Java 6 - Annotations, Generics, etc.
● Maven - build
● Spring framework, Hibernate - beans and database
Prerrequisitos de Conocimiento (programar)
Dónde Empezar
AdWords API Workshops – All rights reserved
● 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
AdWords API Workshops – All rights reserved
Demostración
AdWords API Workshops – All rights reserved
Dando el Próximo Paso¿Y ahora qué?
AdWords API Workshops – All rights reserved
AdWords API Workshops – All rights reserved
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
AdWords API Workshops – All rights reserved
● 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
Dando el Próximo Paso
AdWords API Workshops – All rights reserved
● Necesitas datos para automatizar
● Administración de campaigns, ads, keywords, etc.
● Feedback para optimización
● Historial de servicio
Buscando la Automatización Completa
Dando el Próximo Paso
AdWords API Workshops – All rights reserved
EnlacesAwReporting - https://github.com/googleads/aw-reporting
Report documentation - https://developers.google.com/adwords/api/docs/appendix/reports
AdWords API Workshops – All rights reserved
¿Preguntas?¡Muchas gracias!
AdWords API Workshops – All rights reserved
Top Related