Reporting Metrics API

Version 2.1.0

Introduction

Pull your Tenjin Data Exporter metrics through the API: user acquisition, ad revenue and SKAN reports, and the saved reports that store their settings. The Metric Definitions page lists the metrics you can report on.

Access to the API

The API is served from https://api.tenjin.com, and every path starts with the API version, for example https://api.tenjin.com/v2/reports/spend.

Rate limiting

Each access token can make up to 100 report requests (paths under /v2/reports) per minute. A request over the limit gets status 429, and its X-Retry-After header gives the length of the limit period in seconds.

Authentication

Generate an access token on the Access Tokens page of the Tenjin dashboard and send it as Authorization: Bearer <access token>. API access tokens explains them.

Operations

Reporting Metrics

Pull an SKAdNetwork report from AdNetwork postbacks GET /v2/reports/skan_ad_network
Pull an SKAdNetwork report from AdNetwork postbacks GET /v2/reports/sk_ad_network
Pull an SKAdNetwork report from Apple postbacks GET /v2/reports/skan_apple
Pull a spend report GET /v2/reports/spend
Pull an ad revenue report GET /v2/reports/ad_revenue
Pull data from a saved report GET /v2/reports/{id}

Saved Reports

List saved reports GET /v2/saved_reports
Create a saved report POST /v2/saved_reports
Get a saved report GET /v2/saved_reports/{id}
Update a saved report PATCH /v2/saved_reports/{id}
Delete a saved report DELETE /v2/saved_reports/{id}