SKAdNetwork Reporting API

This new API method enables advertisers to call the Liftoff Direct API and fetch a complete record of all of the Apple SKAdNetwork conversion postbacks that Liftoff has received for their campaigns. The API is for client reporting, and can also be shared with MMP partners for aggregated reporting within their platforms. Refer to our SKAdNetwork for iOS article to learn more about SKAdNetwork attribution.

Key points:

  • Data availability: SKAdNetwork postback data is available as soon as Liftoff servers receive the data sent by Apple.
  • SKAdNetwork campaign mapping: The campaign IDs within these requests are the SKAdNetwork campaign IDs and must be mapped to Liftoff Direct campaign IDs to reconcile with the reporting and performance metrics in the Liftoff Direct Dashboard and in MMP dashboards.
  • Parameters in postbacks: The API response detailed below includes the SKAdNetwork postbacks with parameters exactly as defined by and sent by Apple. The Liftoff Direct API passes these parameters just as we receive them, with no changes.

 

SKAdNetwork Reporting Method

 

Endpoint

https://postbacks.api.vungle.com/v1/sk-ad-network/installs

Request Example

All request parameters are required:

curl --compressed -H 'Accept-Encoding: deflate, gzip' -H 'Accept: application/json' -H 'Authorization: Bearer a_valid_api_token' 'https://postbacks.api.vungle.com/v1/sk-ad-network/installs?start=2020-08-23&end=2020-08-23&app_id=525463029'

Response Format Example

[
  {
    "version": "2",
    "transaction-id": "4e4b0c3f-9479-455d-9bec-4bcdd10002ba",
    "app-id": 525463029,
    "campaign-id": 44,
    "ad-network-id": "com.example",
    "source-app-id": 1234567891,
    "redownload": true,
    "conversion-value": 20,
    "attribution-signature": "MDYCGQCsQ4y8d4BlYU9b8Qb9BPWPi+ixk/OiRysCGQDZZ8fpJnuqs9my8iSQVbJO/oU1AXUROYU=",
    "vungle_app_id": "5727cbb4630ae51d400000cf",
    "vungle_campaign_id": "5c6e163797dc95000149cffb",
    "vungle_creative_id": "5c6e1637f2f3de0001a8212f"
  },
  // ...
]

Response Parameter Definitions

Parameter Name Format Definition
ad-network-id string Liftoff's SKAdNetwork ad network ID.
app-id string The app store ID of the installed app.
attribution-signature string Apple’s attribution signature for verification.
campaign-id String The SKAdNetwork campaign ID (0-100) that maps to a Liftoff campaign ID.
conversion-value String A string representing advertiser configured post install conversion event values sent to Apple.
country String The two-letter ISO Country Code for the country associated with the IP address that was sent with the postback.
device_ip String The IP address of the device.
received_timestamp String Timestamp in which the SKAdNetwork postback was received (for example, '2020-07-23T01:59:08.000Z').
redownload boolean Boolean indicator for whether download was for an app previously downloaded for user’s Apple ID. true or false. true = redownload.
source-app-id string The app store ID of the app where the ad that drove install was show. Subject to Apple’s privacy threshold.
transaction-id string A unique value for this validation; use for deduplicating install validation messages.
version integer Indicates SKAdNetwork version generating postback. 

Filters

Response data can be filtered by the following parameters:

  • app_id
  • start (required)
  • end (required)

Refer to the request example above for syntax.

See also:

Questions?

Need further assistance, feel free to reach out to us, we’re here to help!

Was this article helpful?