SKAdNetwork postback integration reference
Integrate SKAdNetwork postbacks by configuring your MMP endpoint to receive detailed JSON event data from Unity Ads, enabling accurate campaign attribution and measurement for your iOS app installs.
Read time 2 minutesLast updated 4 days ago
Refer to the table below for the JSON fields used in a SKAdNetwork postback integration for Mobile Measurement Partners (MMPs) that have registered their endpoint with Unity. Upon receiving the postback from a device, Unity uses the following postback integration process:
- Unity ensures that the signature is valid, then translates the SKAdNetwork field back to the internal campaign ID.
campaign-id - Unity sends a JSON document to the respective MMP in a POST HTTP request, with the fields referenced in the table below.
JSON document fields
Unity sends the following information to your MMP in a SKAdNetowrk postback JSON document:JSON field name | Type | Description |
|---|---|---|
| String | The IPv4 or IPv6 address of the device sending the postback Refer to the following example: |
| String | The SKAdNetwork version Refer to the following example: |
| Integer | The target app ID |
| Integer | The SKAdNetwork campaign ID Refer to the following example: |
| String | The SKAdNetwork source identifier Note: the |
| String | The SKAdNetwork coarse conversion value set in the advertised app. Note: This field might not appear due to privacy requirements. |
| Integer | Indicates the conversion window in which the postback is sent. |
| String | Unity’s internal campaign ID. |
| String | Unity’s internal campaign name. |
| String | The ad network ID. Refer to the following example: |
| String | Unity's internal Source App ID. Note: This is only available if |
| Integer | The publisher Source App ID. Note:This is only available if |
| String | The SKAdNetwork postback transaction ID. |
| Integer | A SKAdNetwork postback fidelity type Note: This postback is available for SKAd version 2.2 and later. Use the following values for |
| String | The attribution signature. |
| Boolean | When |
| Integer | The SKAdNetwork conversion value (CV) set in the advertised app Important: This field might not be present depending on privacy requirements. |
| String | The time that Unity received the SKAdNetwork postback Important: Use the 10-digit Unix format for all timestamps. Refer to the following example of correct Unix formatting: August 4, 2020, 07:25 UTC: |
SKAdNetwork Postback example
The following example HTTP illustrates a request being sent for an MMP registered with “https://mmp.example.com/skadnetwork-postbackPOST /skadnetwork-postback HTTP/1.1Host: mmp.example.comContent-Type: application/jsonContent-Length: 577{ "ip": "198.51.100.1", "version": "4.0", "app-id": 1234567890, "campaign-id": 23, "source-identifier": "2a3b", "coarse-conversion-value": "medium", "postback-sequence-index": 0, "ad-network-campaign-id": "546b9257365399e0031572bd", "ad-network-campaign-name": "Summer Launch Campaign", "ad-network-id": "1232", "ad-network-source-app-id": "com.unity.source.app", "source-app-id": 987654321, "transaction-id": "abcd1234-ef56-7890-gh12-ijkl3456mnop", "fidelity-type": 1, "attribution-signature": "MEYCIQDW...snip...i7XjFg==", "redownload": false, "conversion-value": 5, "timestamp": "1596525944"}