Ad Revenue
We are providing a download link for a file even before it is available. Download the report from the api response when ready.
If you are getting 202 http response status when making the request, your request is accepted and proccessing. Please wait a while and try to download the prepared file again.
If you are getting 404 http response status when trying to download the file. The file is not prepared yet. Please wait a while and try again.
The download file name is generated with appID, date and timestamp
- :appID:_:date:_:timestamp:.tar.gz
- Extracted file format: csv
Allows only a request per minute per application id
By default, when a request is made twice for the same day, it returns the previously created csv file. After 4 hours, the API clear the previously created csv file. So if you want to get a new calculated csv file. you can make a rew request after 4 hours.
If you are using attribution partner like Adjust/Appsflyer. You can increase your match score using the
attribution_partner
parameter. With this parameter you can get attribution partner device id asAttributionPartnerDeviceID
in csv file.You can get the admost application id using by Admost Publisher Applications API
Authentication: Bearer Token authentication.
Method: GET
URL: https://partners.admost.com/v3/adrevenue/userbase
Request Parameters:
Name | Type | Description |
---|---|---|
date | string | YYYY-MM-DD |
app_id | string | Application admost id |
attribution_partner | string | Optional. Publisher attribution partner name. values: adjust, appsflyer, airbridge |
Request Example URL:
https://partners.admost.com/v3/adrevenue/userbase?app_id={application_id}&date={date}
Response Example URL:
https://partners.admost.com/download/report/c9e86d87-453e-0d9a-3d00-56adc9ec4dc3_2019-04-01_1554291219.tar.gz
Response Status Codes:
Code | Description |
---|---|
200 | OK. The request has succeeded. Returns with a link to download the report |
400 | BAD REQUEST. The request must belong to two days before etc. |
401 | UNAUTHORIZED |
429 | TOO MANY REQUESTS. The user has sent too many requests in a given amount of time (“rate limiting”). |
500 | INTERNAL SERVER ERROR |
Report Column Description
- The report is generated with columns titles.
Name | Description |
---|---|
UserID | Admost user id |
LaunchedAt | User first session time ( UTC ) |
Country | User country |
IDFA | User resettable advertising ID found on iOS devices |
IDFV | Vendor ID provided by iOS |
GAID | Google Advertising ID. |
AttributionPartnerDeviceID | A unique ID generated by attribution partner SDK |
AdRevenue | User ad revenue |
IAPRevenue | User in-app revenue |
SessionCount | User session count |
SessionLength | User session length ( second ) |
InterstitialImpCount | Number of interstitials seen by user |
RewardedImpCount | Number of rewarded seen by user |
OfferwallImpCount | Number of offerwall seen by user |
NativeInterstitialImpCount | Number of native interstitial seen by user |
BannerImpCount | Number of banner seen by user |
NativeImpCount | Number of native banner seen by user |
InterstitialClickCount | Number of total interstitial click by user |
RewardedClickCount | Number of total rewarded click by user |
OfferwallClickCount | Number of total offer click by user |
NativeInterstitialClickCount | Number of total native interstitial click by user |
BannerClickCount | Number of banner click by user |
NativeClickCount | Number of native click by user |
PublisherApplicationUserID | Publisher’s custom user ID/IDs. They are separated with “##” if a publisher sent multiple ids for this user with Admost SDK |
InterstitialRevenue | User interstitials Revenue |
RewardedRevenue | User rewarded revenue |
NativeInterstitialRevenue | User native interstitial revenue |
OfferwallRevenue | User offerwall revenue |
BannerRevenue | User banner revenue |
NativeRevenue | User native revenue |
CampaignNetwork | Campaign Network name if exists |
CampaignName | Campaign name if exists |
CampaignAdgroup | Campaign adgroup if exists |
CampaignCreative | Campaign creative if exists |
AppVersion | Application version |
AdmostSDKVersion | Admost SDK Version in application |
OSVersion | User’s device OS version |
DeviceBrand | User’s device brand |
DeviceModel | User’s device model |
DeviceType | User’s device type |
UserExperimentGroup | User’s A/B test experiment group name |
UserExperimentName | User’s A/B test experiment name |
DataDate | Requested data date |
ApplicationName | Application name |
PackageName | Application package name |
OS | Application operation name ( android / ios ) |
AppStore | The package name of the installer application (com.android.vending etc.) |
AppsetID | Vendor ID provided by Android |