This library provides an easy-to-use Python interface to RTB House API. It allows you to read and manage you campaigns settings, browse offers, download statistics etc.
RTB House SDK can be installed with pip:
$ pip install rtbhouse_sdk
Let's write a script which fetches campaign stats (imps, clicks, postclicks) and shows the result as a table (using tabulate
library).
First, create config.py
file with your credentials:
USERNAME = 'jdoe' PASSWORD = 'abcd1234'
Set up virtualenv and install requirements:
$ pip install rtbhouse_sdk tabulate
from operator import itemgetter
from tabulate import tabulate
from config import USERNAME, PASSWORD
from rtbhouse_sdk.reports_api import ReportsApiSession
if __name__ == '__main__':
api = ReportsApiSession(USERNAME, PASSWORD)
advertisers = api.get_advertisers()
stats = api.get_campaign_stats_total(advertisers[0]['hash'], '2017-10-01', '2017-10-31', 'day')
columns = ['day', 'impsCount', 'clicksCount', 'ctr', 'campaignCost', 'conversionsCount', 'conversionsRate', 'cpc', 'ecc', 'roas', 'conversionsValue']
data_frame = [[row[c] for c in columns] for row in reversed(sorted(stats, key=itemgetter('day')))]
print(tabulate(data_frame, headers=columns))