2. What’s New In AwReporting
Mark R. Bowyer, Google, Inc.
3. Agenda
● Introduction
● Getting Reports Out of AwReporting
● So How Do I Do That?
● Doing Maths With Report Data
● Other New Features
● Summary
4. 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
5. 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
6. 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
7. Google Inc. - All Rights Reserved
An Example Account Report
8. Google Inc. - All Rights Reserved
So How Do I Do That?
Creating your own Reports from AwReporting data
9. 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?
10. HTML
Google Inc. - All Rights Reserved
The Properties File
mccAccountId=
developerToken=
clientId=
clientSecret=
# DB configuration
# The options are: SQL, MONGODB
aw.report.model.db.type=SQL
# MySQL config properties
:
aw.report.exporter.reportwritertype=FileSystemWriter
aw.report.exporter.reportwritertype.drive.peraccountfolder=true
aw.report.exporter.writeHtml=false
aw.report.exporter.writePdf=true
aw.report.exporter.writeDriveDoc=false
TEXT
11. HTML
Google Inc. - All Rights Reserved
The Properties File (cont.)
TEXT
# Accounts Performance for PDF Generation
ACCOUNT_PERFORMANCE_REPORT=ExternalCustomerId,AccountDescriptiveName,Month,Cost,Clicks,
Impressions,AverageCpc,AverageCpm,Ctr,ContentBudgetLostImpressionShare,
ContentRankLostImpressionShare,ContentImpressionShare,CostPerConversion,Conversions,
AccountCurrencyCode,SearchRankLostImpressionShare,SearchBudgetLostImpressionShare,
SearchImpressionShare
# Campaigns Performance for PDF Generation
CAMPAIGN_PERFORMANCE_REPORT=Month,Cost,Clicks,Impressions,AverageCpc,AverageCpm,
CampaignId,CampaignName,Status
# Placeholder Feed Item for Ad Extensions for PDF Generation
PLACEHOLDER_FEED_ITEM_REPORT=ExternalCustomerId,AccountDescriptiveName,CampaignId,
CampaignName,AdGroupId,AdGroupName,Status,AdId,FeedId,FeedItemId,Clicks,Impressions,
ClickType,AverageCpc,AverageCpm,AveragePosition,ConversionRate,
ConversionRateManyPerClick,Month,Day
13. 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: -sumAdExtensions
code added to: ReportExporter.java
14. 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]
15. Google Inc. - All Rights Reserved
New Features and Summary
16. 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
17. 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
18. Google Inc. - All Rights Reserved
Resources
AwReporting:
https://github.com/googleads/aw-reporting
Report Types:
https://developers.google.com/adwords/api/docs/appendix/reports