Universal SKAdnetwork Reporting API

Use the Universal SKAN API to retrieve and analyze SKAdNetwork attribution data from multiple ad networks in one place.

Read time 4 minutes

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
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
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
Authentication type

Bearer API authentication

Method
Method

GET platform.ironsrc.com/partners/postback/v1?

Required parameters
Required parameters

NameTypeDescription
date
StringYYYY-MM-DD (UTC Timezone)

Request example URL
Request example URL

http://platform.ironsrc.com/partners/postback/v1?date=2021-08-31

Response example URL
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
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 definitions
Fields definitions

FieldDescriptionExample
Timestamp
The exact date and hour of the impression in UTC2020-03-30 09:33:58
SKAN Version
SKAdNetwork version2.2
Ad Network ID
Apple's ad network identifiersu67r6k2v3.skadnetwork
Campaign ID
The campaign when displaying the ad9
Transaction ID
A unique value for this validation6aafb7a5-0170-41b5-bbe4-fe71dedf1e28
App ID
The item identifier of the advertised product525463029
Attribution Signature
Apple's attribution signatureMEQCIE0nS32ZERP3oKRi/A8omsYq259wWJb7GIsW1/ULsEqoAiAQrBlTZTJNK25MtnGDRwoldRy1CwkFIEMXJAzLRchx0Q==
Redownload
A Boolean flag that indicates that the customer re-downloaded and re-installed the appTRUE
Source App ID
The item identifier of the app that displayed the ad1234567891
Fidelity Type
A value of 0 indicates a view-through ad presentation; a value of 1 indicates a StoreKit-rendered ad1
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 attributionTRUE
Ad Network
Ad network nameironSource
`AppNname of the advertised appHide 'N Seek!
Source App
Name of the app that displayed the adInstagram
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 manager0.05