Author: Connor McArthur ([email protected])
This is a Singer tap that produces JSON-formatted data following the Singer spec.
This tap:
- Pulls raw data from Taboola's Backstage API
- Extracts the following resources:
- Campaigns
- Campaign Reports, specifically the
campaign_day_breakdown
report
- Outputs the schema for each resource
- Incrementally pulls data based on the input state
-
Install
> git clone [email protected]:fishtown-analytics/tap-taboola.git > cd tap-taboola > pip install .
-
Get credentials from Taboola:
You'll need:
- Your account id (if you aren't sure, contact your account manager)
- A Taboola username and password with access to the API
- A client ID and secret for the API (your account manager can give you these)
-
Create the config file.
There is a template you can use at
config.json.example
, just copy it toconfig.json
in the repo root and insert your credentials.account_id
, your Taboola account ID (looks liketaboolademoadvertiser
).username
, your Taboola username -- used to generate an API access key.password
, the Taboola password to go along withusername
.client_id
, your Taboola client ID. You should reach out to your account manager to get this.client_secret
, your Taboola client secret. You should reach out to your account manager to get this.start_date
, the date from which you want to sync data, in the format2017-03-10
.
-
Run the application.
tap-taboola --config config.json
campaigns
: Taboola pushesnull
forstart_date
and9999-12-31
forend_date
sometimes. This tap convertsnull
dates to9999-12-31
for consistency. I don't know what that signifies at present. - @cmcarthur
Copyright © 2017 Stitch