User-Level Revenue API

Use this API to get your user level ad revenue report with OpenMediation and your mediated ad networks. The response will include the following breakdowns: User Device ID, User Device type, Ad Network, Clicks, Impressions, Revenue.

Before you start

• Each API call is per app per day and the data is stored and available for 14 days.
• The data for yesterday is available starting today 16:00 UTC.
• The data is updated for previous three days (T-3, T-2, T-1).
• The User Ad Impression equals to 0 when the Device ID is not retrieved.
• Up to 28 requests per app per day.

How to Get your Authentication

• TOKEN - The Token is unique for your OpenMediation account. To retrieve it, navigate to Account-> Preport API. Click on 'COPY API '.

• APP KEY - To get your APP KEY, navigate to the 'APPS' -> 'Apps'. Click on 'APP KEY'.

Download the report

Method

GET  http://[API domain]/publisher/user/ad/revenue?token=[token]&appKey=[appkey]&date=[YYYYMMDD]&zone=[zone]

(For example: http://sdk.adtimingapi.com/publisher/user/ad/revenue?token=vmZlWg5pHf2ATYm123aag3475xOvByQX&appKey=jII0DMD53mIDzO123VFXIF6iRrWK8bBQ&date=20200220&zone=E08)

Parameters

E08: UTC+0800

Understanding the report

Successful response returns a zip file containing multiple CSV files, with each CSV file's size up to 256MB. The zip file's name is in the format of [AppID]-[date]-[zone].zip (For example: 1372837999-20200220-UTC.zip)

The columns titles and order is as follows:

• device_id
• device_type
• ad_network
• impression
• click
• revenue
• user_id

Fields Definition