Intro AwReporting Tool Persist AdWords Data

AW Reports to DB
An introduction to the tool

by Gustavo Moreira
<SPEAKER>, Google, Inc.

Agenda
● What is the tool
● Overview
● Why is it important?
● How to get started
● Next steps


Defining AW Reports to DB
What the tool actually does


The Problem
● Big number of accounts
● A lot of performance information
● Hard to scale
● Very useful information


Defining AwReporting

The Solution
● Use the API
● Download overnight
● Persist locally
● Build on top of it



The Tool
● Multi-threaded download
● Persists to SQL DBs*
● Also persists to MongoDB
● Handles all the API access
● Expose Java objects
● * Uses Hibernate to do the persistence


The Tool
● It is open source!
● Designed to be extended
● Can run as a command line
● Can be part of your platform



A Quick Overview
Bird’s eye view on the tool


How does it work?

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

Components
Local to the user

Database

● Report definitions
● Entity persisters
● AwReporting main

Map the reports to
entities

Report definitions

Handles the
persistence layer

Entity persisters

Executes the
download and
persistence

AwReporting
main

A Quick Overview

Report Definitions
● Java Beans with 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;


A Quick Overview

Report Definitions
@CsvReport(value = AD_PERFORMANCE_REPORT)

● The name found in the documentation:
○ https://developers.google.com/adwords/api/docs/appendix/reports *

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

● The display name, and the report field name
* Resources will be available in the final slides

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 to handle entities
● Contains methods to save, delete and get
● Use it to access the database!
● It talks Java Bean


A Quick Overview

Entity Persisters
● Takes care of the transaction
● Handles the exceptions
● Type safe


A Quick Overview

AwReporting Main
● Coordinates all the parts
● Handles parallelism
● Standalone command line program
● Flexible configuration
● Uses OAuth 2.0 to authenticate (ONLY)


A Quick Overview

AwReporting Main
● Configuration in a properties file
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
● Command line standalone
$ java -Xmx512m -jar aw-report-tool.jar
-startDate <some date>
-endDate <some date>
-file <properties-location>/configuration.properties

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


A Quick Overview

Possible Applications
Why the tool is important


Reducing API Adoption Time
● Out of the box solution to reports
● Very small work time required
● Latest API version
● Easy to extend



Follow the Example
● Best practices applied to the real world
● Very good executable examples
● The DAs invest time on it
● More features to come



Starting Point
● Remove reports out of the way
● Local data is easier to handle
● First step towards automation
● Automated report generation to clients?



Getting Started
Take my money!


Building the Tool
● Start by downloading the source code:
○

http://goo.gl/TQxIdN *

● Follow the guide to build the tool
● Everything is open source

* Resources will be available in the final slides

Getting Started

Demo


Accessing the Source Code
● Default Maven project format
● $ mvn eclipse:eclipse
● You can edit, and build yourself!
● Two different modules/projects


Getting Started

System Requirements
● AdWords developer token
● Database (MySQL)
● Java 6


Getting Started

Knowledge Requirements (to code)
● Java 6 - Annotations, Generics, etc.
● Maven - build
● Spring framework, Hibernate - beans and database


Getting Started

Customizing the Tool
● Add a new report by creating a new definition
● Manage the downloads via the properties file
● Database fields via annotations
● Entity persister to access the data


Getting Started

Taking the Extra Step
Now what?


The Data is Yours!
● Create your own reports
● Optimize for the report values
● Auto-generate PDF reports
● Integrate with internal systems



Non Exclusive Application
● The tool goes well with other platforms
● Define your own database
● No need to use Java
● Follow the best practices, implement your own!



Seeking Complete Automation
● You need data to automate
● Management of campaigns, ads, keywords, etc.
● Feedback for optimization
● Performance history



Resources
AW Reports to DB - https://github.com/googleads/aw-reporting
Report documentation - https://developers.google.
com/adwords/api/docs/appendix/reports


Questions?
Thank you!


Intro AwReporting Tool Persist AdWords Data

Recommended

Recommended

More Related Content

What's hot

What's hot (19)

Similar to Intro AwReporting Tool Persist AdWords Data

Similar to Intro AwReporting Tool Persist AdWords Data (20)

More from marcwan

More from marcwan (20)

Recently uploaded

Recently uploaded (20)

Intro AwReporting Tool Persist AdWords Data