AdWords adapter

Classes in the ppc_robot_lib.adwords module wraps the official googleads library and provides more developer-friendly API. These classes contains report definitions for all reports and are able to normalize the values into values directly usable in Python and Pandas.

The report definitions are currently valid against the v201809 API version.

The report reference can be found in the official AdWords documentation.

Values in the downloaded report are converted to proper internal representation. For instance, all enumerables are converted to Python enums, and all money values are converted from “micros” to base units (e.g. EUR).

The same conversion applies to values sent to the API, which means that you can simply specify value in EUR when filtering by Cost.

The reports definitions can be re-generated using the following command:

ppc_robot adwords_generate_report_classes --out ppc_robot_lib/adwords/reports

Contents:

• Querying the AdWords Reporting API
  • Query class
  • Conditions and predicates
  • During Clause