Ad Revenue Measurement API
Description
Use this API to get device level ad revenue data for ironSource and your mediated ad networks. The revenue per device is calculated based on the eCPM of each impression, according to the app, day, network, country, and instance.
Before you start, make sure you review our API introduction article.
Notes:
- Pulling Ad Revenue Measurement data is done in 2 steps:
- Make an API request which returns a URL link to download the report
- Download the report by clicking on the provided link
- Each API call must be made for a single app and single date.
- The data for each date is stored and available for only 14 days.
- Example: Data for January 1st will be available only until January 14th
- Each day, the data for yesterday is available starting 02:00 PM UTC. Make sure to only call the API after 02:00 PM UTC each day.
- Example: The data for January 1st is only available on January 2nd, after 02:00 PM UTC
- Each day, we update the data for yesterday and the day before yesterday. The data will not change after 2 days.
- Example: The data for January 1st will update on January 2nd and January 3rd. After January 3rd, the data will not change
API request for report URL
Note: A valid API hit returns a link to the requested file. The file will be available to download for one hour only.
Authentication Type
Method
GET platform.ironsrc.com/partners/userAdRevenue/v3?
Required Parameters
Name | Type | Description |
date | String | YYYY-MM-DD (UTC Timezone) |
appKey | String | Application Key (as seen on our platform) |
reportType | Integer | Supporting different report types. At the moment, should always set to 1 |
Request Example URL
https://platform.ironsrc.com/partners/userAdRevenue/v3?appKey=12345678&date=2018-12-15&reportType=1
Response Example URL
https://user-ad-revenue.s3.amazonaws.com/data/bi_databases/uar/tables/network/report_version%3Dv1/publisher_id%3D138101/application_id%3D100411/day%3D2018-07-13/000000.gz?AWSAccessKeyId=AKIAILCCGIXP5G2XNXBA&Expires=1532524582&Signature=1U%2FbrLmb%2F7TwXXdoHtb%2F%2FQjrmz0%3D
Download the report
Simply click the URL to download the report
Understand the report
The report includes the following columns:
- Ad Unit
- Advertising ID
- Advertising ID Type
- User ID
- Segment (if applicable)
- Placement
- Ad Network
- A/B Testing (if applicable)
- Impressions
- Revenue
Note: Country breakdown is not included in the report in order to minimize tracking discrepancies with the attribution partners.
Fields Definition
Field | Description | Example |
Ad Unit | The ad unit from which the revenue was generate from | rewarded_video |
Advertising ID | The unique ID of the user’s device | 21d0e51a-772d-4b23-9fc4-296126b4f123 |
Advertising ID Type | The unique ID type of the user’s device |
IDFA/IDFV/GAID |
User ID | The user ID being set by the developer | 135920 |
Segment | The segment the user is related to as defined on the platform | Tier 1 |
Placement | The placement the user is related to as defined on the platform | Home_Screen |
Ad Network | The ad network name |
Admob |
A/B Testing | A/B testing group the user was allocated to (can be ‘A’ or ‘B’) | ‘A’ |
Impressions | The number of ads displayed to the user | 1000 |
Revenue | The Revenue generated by the user (USD) | 0.5 |
* Date & App Key aren’t included as they are unique per report (file)