Universal SKAdnetwork Reporting API
The Universal SKAN Reporting API enables you to get a copy of the raw winning postbacks data from every network, directly from Apple.
Before you start, make sure you review our API introduction article.
How it works
- Pull the data (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 date
- The data for each date will be stored and available for 14 days
- For example, data for January 1 will be available until January 14th
- Each day, the data for the previous day becomes available at 02:00 PM UTC. You’ll need to make sure you only call the API after 02:00 PM UTC each day
- For example, the data for January 1 will only become available on January 2 after 02:00 PM UTC
API request for report URL
A valid API hit will return a link to the requested file. The file will be available to download for only 1 hour.
Authentication Type
Method
GET platform.ironsrc.com/partners/postback/v1?
Required Parameters
Name | Type | Description |
date | String | YYYY-MM-DD (UTC Timezone) |
Request Example URL
http://platform.ironsrc.com/partners/postback/v1?date=2021-08-31
Response Example URL
{ "urls": [ "https://postback-hub.s3.amazonaws.com/athena/raw_data_rtm_postback_hub_csv_file/outputs/athena/cf23fe03-cf05-4189-adda-d1cc009a9b59/3/output/companyid%123456/partition_date%3D2021-10-10/compaction_id%3D1/2021_10_11_00_00_output.csv?AWSAccessKeyId=ASIAQO6NX2IJOKSSQ34R&Expires=1633937977&Signature=um69g30FsSp%2BWENsxABotPnk0q8%3D&x-amz-security-token=IQoJb3JpZ2luX2VjEG4aCWV1LXdlc3QtMSJHMEUCIQDLBLHPC84Xb6rXqooco4iY%2BsBJWs4BlPS1H0b27SrKgQIgHNu1on2rw8%2BktL5lEoP3RYbalryBm3bbmHTjHZbIOw8qgwQI5v%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgwwMzIxMDY4NjEwNzQiDML7Dvs9adyo9dIx8yrXA5AtmSqdYTQnV0jgMywFD89FyN5Zgp72KCyvQVQr%2FqFcdkWovagJEICg%2BWAcLVAfU%2FNhgvcNV2h%2FIkdFt70rGGeTfyKr7viPo4wq9icnyc%2F12%2B5VYjrCEt8oPkdU6gmotTQ3qYChC2hlmhy1I5U6Jf%2FCSyZyFTIHSgvYH3OiepjOpIXuVxCTxBx6Snrq37w6ZScOZIZ5Emvf7Nl%2BzcNrr73cl5XOu%2FD7OmLrLMcIU%2FOLlndI2%2FbxS8r0EReV7ol1iq2QYsk%2FweiQa2BwHANl2GsZLogPNZ4GnJNS56TcUeAnZzHaHlAQ6wejyJ4VdPrE7OhIbJ6lj69zUIHJ8xFqqjFpAGdM39nxdWhcPAYkVI%2Bi8INCpcuwm7ceGFCtf6qMvN%2F%2F6MpRFkNYNMTez8843Lp2wp9lPuIcutliB6qF5tFUzohHRNuY4vNyOYX4Y5SNJ3JcHeqQxHR0svHTM8QZbfL7jDrNfGEzWsBmvyWcyy98FeKwTYvNkB55WngrNSSmAZs7u5%2Ba58EchbfMNtqEpT8TWhhHUn2hS%2FkVJ4m1SFHZTES6QspA2by3ubv1AWcB0nIASivErSe%2FjhZAF2xt5fXOybhjmhh2PsIFc49bzYv6UF3FybutkDC3j4%2BLBjqlAQqgV7JtYzWSt78TvnViUf%2Fn6Z8lHHhVTHzKekiFYj%2FMmp3nIpc2da5Z%2BYOv1HJg2NXzx%2BbtTTKH0WtU9qgJM%2Bj7Z%2F1w5WHIw4nTfIGhilvaXX0nRokJPjnQV8btnmQnWXmp9S6kfT13IoLqaxJQEw8kkY%2B7Isa6F%2BZeGqHtBausH4mlv5UPgfvUV15WVXG8YhAHA5OeKITkP4O9KrDePhX3Fd8SKg%3D%3D" ], "expiration": "2021-10-11 07:39:37" }
Understand the report
The report includes the following columns:
-
- Timestamp
- SKAN Version
- Ad Network ID
- Campaign ID
- Transaction ID
- App ID
- Attribution Signature
- Redownload
- Source App ID
- Fidelity Type
- Conversion Value
- Did Win
- Ad Network
- App
- Source App
- CV Manager D0 Revenue
Fields Definition
Field | Description | Example |
Timestamp | The exact date and hour of the impression in UTC | 2020-03-30 09:33:58 |
SKAN Version | SKAdNetwork version | 2.2 |
Ad Network ID | Apple’s ad network identifier | su67r6k2v3.skadnetwork |
Campaign ID | The campaign when displaying the ad | 9 |
Transaction ID | A unique value for this validation | 6aafb7a5-0170-41b5-bbe4-fe71dedf1e28 |
App ID | The item identifier of the advertised product | 525463029 |
Attribution Signature | Apple’s attribution signature | MEQCIE0nS32ZERP3oKRi/A8omsYq259wWJb7GIsW1/ULsEqoAiAQrBlTZTJNK25MtnGDRwoldRy1CwkFIEMXJAzLRchx0Q== |
Redownload | A Boolean flag that indicates that the customer re-downloaded and re-installed the app | TRUE |
Source App ID | The item identifier of the app that displayed the ad | 1234567891 |
Fidelity Type | A value of 0 indicates a view-through ad presentation; a value of 1 indicates a StoreKit-rendered ad | 1 |
Conversion Value | An unsigned 6-bit value (>=0 and <=63) that the installed app provided by calling updateConversionValue(_:) | 21 |
Did Win | Boolean value that’s true if the ad network won the attribution | TRUE |
Ad Network | Ad network name | ironSource |
App | Nname of the advertised app | Hide ‘N Seek! |
Source App | Name of the app that displayed the ad | |
CV Manager D0 Revenue | The ad revenue amount in USD, based on the conversion value mapping. Use the average value of the mapping (for example, if CV 1 = $0.40-$0.50, the value = $0.45) Note: available only if you use the ironSource conversion value manager |
0.05 |