Set up SKAdNetwork and conversion values

StoreKit Ad Network (SKAdNetwork) is Apple’s attribution framework for app install and reinstall attribution. The SKAdNetwork workflow goes like this:

Apple gathers attribution information and notifies the relevant ad network.
The network sends a postback with this information to Adjust.
Adjust displays SKAdNetwork data in Datascape.

Disable SKAdNetwork communication

public bool? IsSkanAttributionEnabled { get; set; }

The Adjust SDK communicates with SKAdNetwork by default. The SDK registers for SKAdNetwork attribution upon initialization.

You can control this behavior by setting the IsSkanAttributionEnabled property of your AdjustConfig instance to a bool value.

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
2
//...
3
adjustConfig.IsSkanAttributionEnabled = false;
4
//...
5
Adjust.InitSdk(adjustConfig);

Listen for changes to conversion values

public Action<Dictionary<string, string>> SkanUpdatedDelegate { get; set; }

If you use Adjust to manage conversion values, the Adjust’s servers send conversion value updates to the SDK. You can set up a delegate function to listen for these changes assigning a function to the SkanUpdatedDelegate property of your AdjustConfig instance.

1
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
2
//...
3
adjustConfig.SkanUpdatedDelegate = SkanUpdatedDelegate;
4
//...
5
Adjust.InitSdk(adjustConfig);

The delegate function receives a postback from SKAdNetwork with the following properties:

Arguments	Description
`fine_value`	The conversion value sent by Adjust’s servers
`coarse_value`	The coarse conversion value. This value is used if your app doesn’t have sufficient installs to reach the privacy threshold. `none` `low` `medium` `high` Apple sends none whenever none of the conditions that are set for low, medium, and high were met.
`lock_window`	Whether to send the postback before the conversion window ends. `1` indicates the postback will be sent before the conversion window ends. Defaults to `0` in SKAdNetwork 4.0 postbacks and `nil` in older SKAdNetwork versions.
`error`	Contains the error message if an error occured.

Example

This example shows how to log the the fine conversion value, the coarse conversion value, and whether the SKAdNetwork postback is set to send before the conversion window ends.

1
using com.adjust.sdk;
2

3
public class ExampleGUI : MonoBehaviour {
4
    void OnGUI() {
5
        if (GUI.Button(new Rect(0, 0, Screen.width, Screen.height), "callback")) {
6
            AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
7
            adjustConfig.LogLevel = AdjustLogLevel.Verbose;
8
            adjustConfig.SkanUpdatedDelegate = SkanUpdatedDelegate;
9

10
            Adjust.InitSdk(adjustConfig);
11
        }
12

13

14
      private void SkanUpdatedDelegate(Dictionary<string,string> response) {
15
         Debug.Log("Conversion value updated. Callback received");
16
         Debug.Log("Conversion value: " + response["fine_value"]);
17
         Debug.Log("Coarse conversion value: " + response["coarse_value"]);
18
         Debug.Log ("Will send before conversion value window ends: " response["lock_window"]);
19
         Debug.Log("Error message: " response["error"]);
20
      }
21
   }
22
};

Set up direct install postbacks

You can configure your app to send a copy of winning SKAdNetwork callbacks to Adjust. This enables you to use SKAdNetwork information in your analytics.

To set up direct install postbacks, you need to add the Adjust callback URL to your Info.plist file:

Select Info.plist in the Project navigator in Xcode.
Select the Add button beside a key in the property list editor and press Return.
Enter NSAdvertisingAttributionReportEndpoint as the key name.
Set the Type to String in the pop up menu.
Enter the address https://adjust-skadnetwork.com.