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

Bearer API authentication

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 Instagram
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