AdWords Reports

Description

adwords_reports is a library to quickly and easily receive cross-account reports from Google AdWords.

Getting started

1. You can install adwords_reports using pip:

   $ pip install adwords_reports

or using git:

`$ pip install git+https://github.com/SaturnFromTitan/adwords_reports.git`

1. Get access to AdWords API and cache all credential information in a .yaml file.

   • Google's tutorial for authenticating with their API
   • Google's client library for python
   • You'll need to pass the path to this file to the Client for authentication:

   from adwords_reports import Client
   
   credentials_path = "adwords_credentials.yaml"
   client = Client(credentials_path)
   

2. Try to run the code in examples/account_hierarchy.py to see if everything is working.

   • Have a look at the other examples as well. This is the best place to get you up to speed.

3. For more detailed information on report types, available fields etc. please refer to the Google's official documentation.

Technology

• The library currently supports Python 2.7 and 3.5+
• All reports are returned as pandas DataFrames - the standard tool to analyse data in Python
• Tests are written with pytest.

Who do I talk to?

The project was launched and is currently maintained by me, Martin Winkel.

Contribute

Contributors are very welcome! Just file an issue or pull request.