iOS14 update: SKAdNetwork Set up Guide

For the detail of iOS 14, please see the following articles.

• iOS 14 Update(1): What is going to change?
• iOS 14 Update(2): Changes of Adbrix SDK

iOS 14 update, SKAdNetwork Postback Report

Apple directly measures attribution of campaigns using SKAdNetwork. SKAdNetwork can be the most precise attribution tool because it is supported by Apple itself.

SKAdNetwork Campaign Process

1. A user installs an app through the SKAdNetwork campaign
2. The user runs the app
3. iOS send attribution data to the ad network that contributed app install(up to 24~48 hours delay)
   1. attribution postback does not include device identifier at all
4. Adnetwork sends raw postback data of the previous step 
5. Adbrix makes a SKAdNetwork report

SKAdNetworks Campaign Performance Postback

SKAdNetwork directly sends attribution postback to the ad network that contributed to the app install.

Each ad network can make its report, after processing postbacks received from SKAdNetwork.

The advertisers have to access every single ad network to see the performance report. This situation leads all the main members of ad network to ineffectiveness.

Adbrix Solution: Integrated Report

To prevent this situation, adbrix provides a solution integrating all the ad networks' SKAdNetwork reports in one.

The only thing to do for ad networks is just to deliver SKAdNetwork postback to adbrix.

Go to adbrix partner console first. Follow the instructions below to set up the SKAdNetwork postback protocol.

How to Set up

1. In the partner console, go Settings > SKAdNetwork Settings. (You can go straight to this page on the left sidebar)

2. Turn on the SKAdNetwork postback toggle. And click the blue button on the bottom to generate a token for protocol.

You should enter the generated token at the Header.

Send Data

You should put JSON from SKAdNetwork at Body and send it.

[sample request - Basic]

POST - https://event-qa.adbrix.io/api/v1/skadn/postback

Header 
{
   "ABX-TOKEN" : "hsL1rk37pYXHaznL0Axd2xjOHn7%2b3EzB4gDXfa0wF8dHKLLJyccFC0T3BhPFRnxW2yEvUWak4LQeQhuAZAywDVsvjgNO95tWXkVbJd2DgzyZsb6A0IKzqpCcAEK%2bvFJz4GQ6gKMwfNbwdEcyt3qlMSPpvS%2bGtpzj6UZWy7j0ucVK0v3wMsBjt4IrYLHPEM6skrLLrROMZukkm2PTC3E1v5Dt9wdCk9gah46p16UWoDQ%3d"
}

Body
{
   "version" : "2.2",
   "ad-network-id" : "com.example",
   "campaign-id" : 42,
   "transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
   "app-id" : 525463029,
   "attribution-signature" : "MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY/AOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9/sY",
   "redownload": true,
   "source-app-id": 1234567891,
   "fidelity-type": 1,
   "conversion-value": 20
}

If you want to send additional parameters with basic SKAdNetwork data, you can put any data at "custom field". See the sample code.

[sample request - Advanced]

POST - https://event.adbrix.io/api/v1/skadn/postback

Header 
{
   "ABX-TOKEN" : "hsL1rk37pYXHaznL0Axd2xjOHn7%2b3EzB4gDXfa0wF8dHKLLJyccFC0T3BhPFRnxW2yEvUWak4LQeQhuAZAywDVsvjgNO95tWXkVbJd2DgzyZsb6A0IKzqpCcAEK%2bvFJz4GQ6gKMwfNbwdEcyt3qlMSPpvS%2bGtpzj6UZWy7j0ucVK0v3wMsBjt4IrYLHPEM6skrLLrROMZukkm2PTC3E1v5Dt9wdCk9gah46p16UWoDQ%3d"
}

Body
{
   "version" : "2.2",
   "ad-network-id" : "com.example",
   "campaign-id" : 42,
   "transaction-id" : "6aafb7a5-0170-41b5-bbe4-fe71dedf1e28",
   "app-id" : 525463029,
   "attribution-signature" : "MEYCIQDTuQ1Z4Tpy9D3aEKbxLl5J5iKiTumcqZikuY/AOD2U7QIhAJAaiAv89AoquHXJffcieEQXdWHpcV8ZgbKN0EwV9/sY",
   "redownload": true,
   "source-app-id": 1234567891,
   "fidelity-type": 1,
   "conversion-value": 20,
   "custom-field" : {
      "custom-string" : "my_data",
      "custom-bool" : false,
      "custom-long" : 10
   }
}

Response

You can see the status codes in the following table.