Google Inc. - All Rights Reserved

What’s New In AwReporting

Mark R. Bowyer, Google, Inc.

Agenda

● Introduction● Getting Reports Out of AwReporting● So How Do I Do That?● Doing Maths With Report Data● Other New Features● Summary

Google Inc. - All Rights Reserved

● An Open Source tool to download AdWords reports via the API

● Built and maintained by Google Developer Advocates

● An easy way to scale your business and save development time

Introduction

Google Inc. - All Rights Reserved

● Download, Build, Install, Configure○ See the Github site for detailed instructions○ You’ll need Java, Maven and an SQL database

● Use AwReporting to populate your database○ Create your properties file for the data you want○ Run AwReporting to download that data

■ (the PDF generator run doesn’t do any downloading)

Getting Reports out of AwReporting

Google Inc. - All Rights Reserved

● Use AwReporting to generate your Reports○ You can use the same properties file○ Create or reuse a template○ Then add the -generatePdf arguments to the

command line

And...

Getting Reports Out Of AwReporting

Google Inc. - All Rights Reserved

An Example Account Report

Google Inc. - All Rights Reserved

So How Do I Do That?Creating your own Reports from AwReporting data

Google Inc. - All Rights Reserved

● Check out the supplied example properties files

○ aw-reporting/src/main/resources

● Check out the supplied example templates

○ aw-reporting/src/main/resources/templates

● Configure the properties to meet your needs

● Change the template to fit your style

● Run the command line

So How Do I Do That?

HTML

Google Inc. - All Rights Reserved

The Properties FilemccAccountId=developerToken=clientId=clientSecret=

# DB configuration# The options are: SQL, MONGODBaw.report.model.db.type=SQL

# MySQL config properties :

aw.report.exporter.reportwritertype=FileSystemWriteraw.report.exporter.reportwritertype.drive.peraccountfolder=trueaw.report.exporter.writeHtml=falseaw.report.exporter.writePdf=trueaw.report.exporter.writeDriveDoc=false

TEXT

HTML

Google Inc. - All Rights Reserved

The Properties File (cont.) TEXT

# Accounts Performance for PDF GenerationACCOUNT_PERFORMANCE_REPORT=ExternalCustomerId,AccountDescriptiveName,Month,Cost,Clicks,Impressions,AverageCpc,AverageCpm,Ctr,ContentBudgetLostImpressionShare,ContentRankLostImpressionShare,ContentImpressionShare,CostPerConversion,Conversions,AccountCurrencyCode,SearchRankLostImpressionShare,SearchBudgetLostImpressionShare,SearchImpressionShare

# Campaigns Performance for PDF GenerationCAMPAIGN_PERFORMANCE_REPORT=Month,Cost,Clicks,Impressions,AverageCpc,AverageCpm,CampaignId,CampaignName,Status

# Placeholder Feed Item for Ad Extensions for PDF GenerationPLACEHOLDER_FEED_ITEM_REPORT=ExternalCustomerId,AccountDescriptiveName,CampaignId,CampaignName,AdGroupId,AdGroupName,Status,AdId,FeedId,FeedItemId,Clicks,Impressions,ClickType,AverageCpc,AverageCpm,AveragePosition,ConversionRate,ConversionRateManyPerClick,Month,Day

HTML

Google Inc. - All Rights Reserved

The Template File<table WIDTH="100%"> <tbody> <tr>

<th>Campaign Name</th><th>CampaignId</th><th>Month</th><th>Cost</th><th>Impressions</th><th>Clicks</th><th>AvgCPC</th><th>AvgCPM</th>

</tr>{{#CAMPAIGN_PERFORMANCE_REPORT}}<tr>

<td>{{CampaignName}}</td><td style="text-align: right; background: #E1EEF4; color: #00496B;" >{{CampaignId}}</td><td style="text-align: right;" >{{month}}</td><td style="text-align: right; background: #E1EEF4; color: #00496B;" >{{cost}}</td><td style="text-align: right;" >{{impressions}}</td><td style="text-align: right; background: #E1EEF4; color: #00496B;" >{{clicks}}</td><td style="text-align: right;" >{{avgCpc}}</td><td style="text-align: right; background: #E1EEF4; color: #00496B;" >{{avgCpm}}</td>

</tr>{{/CAMPAIGN_PERFORMANCE_REPORT}}

</tbody> </table>

HTML

Google Inc. - All Rights Reserved

Doing Maths With Report Data

{{#ADEXTENSIONS}}<tr><td style="text-align: left; background: #E1EEF4; color: #00496B;">{{clickType}}</td><td style="text-align: right;">{{impressions}}</td><td style="text-align: right; background: #E1EEF4; color: #00496B;">{{clicks}}</td></tr>{{/ADEXTENSIONS}}

command line argument added: -sumAdExtensionscode added to: ReportExporter.java

Google Inc. - All Rights Reserved

Generates lots of files like:ACCOUNT_FULL_PERFORMANCE_REPORT_AccountId_20140301_20140331.pdf

The Command Line

$ java -Xmx1G -jar aw-report-tool.jar \ -startDate <some date YYYYMMDD> \-endDate <some date YYYYMMDD> \-file <properties-location>/configuration.properties \-generatePdf <htmlTemplateFile> <outputDirectory> \[-sumAdExtension]

Google Inc. - All Rights Reserved

New Features and Summary

Google Inc. - All Rights Reserved

● Google Drive Support● ReportProcessorOnMemory● More settings to control threads● AdWords API v201402● Better Logging, added -debug & -verbose● Many fixes from GitHub’s issues● More report types coming soon...

Other New Features

Google Inc. - All Rights Reserved

Summary

● Introduced and improved PDF/HTML generation

● Better Memory/Processing options

● Google Drive Integration

● Please report issues and feature requests

Google Inc. - All Rights Reserved

Resources

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

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

Google Inc. - All Rights Reserved

Questions?

Google Inc. - All Rights Reserved