Skip to main content

RTB House SDK

Project description

Overview

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.

API docs: https://panel.rtbhouse.com/api/docs

Installation

RTB House SDK can be installed with pip:

$ pip install rtbhouse_sdk

Usage example

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 datetime import date, timedelta
from operator import itemgetter

from rtbhouse_sdk.reports_api import Conversions, ReportsApiSession
from tabulate import tabulate

from config import PASSWORD, USERNAME

if __name__ == "__main__":
    api = ReportsApiSession(USERNAME, PASSWORD)
    advertisers = api.get_advertisers()
    day_to = date.today()
    day_from = day_to - timedelta(days=30)
    group_by = ["day"]
    metrics = ["impsCount", "clicksCount", "campaignCost", "conversionsCount", "ctr"]
    stats = api.get_rtb_stats(
        advertisers[0]["hash"],
        day_from,
        day_to,
        group_by,
        metrics,
        count_convention=Conversions.ATTRIBUTED_POST_CLICK,
    )
    columns = group_by + metrics
    data_frame = [
        [row[c] for c in columns]
        for row in reversed(sorted(stats, key=itemgetter("day")))
    ]
    print(tabulate(data_frame, headers=columns))

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rtbhouse-sdk, version 6.0.2
Filename, size File type Python version Upload date Hashes
Filename, size rtbhouse_sdk-6.0.2.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page