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: