AdWords Reports

Description

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

Getting started

• You can install adwords_reports using pip:

$ pip install adwords_reports

or using git:

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

• 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
    
    credentialspath = "adwordscredentials.yaml"
    client = Client(credentials_path)

• 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.

• 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.