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

- (void)disableSkanAttribution;

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

You can disable SKAdNetwork communication by calling the disableSkanAttribution method with no argument.

Swift
Objective-C

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox
3
let adjustConfig = ADJConfig(
4
    appToken: yourAppToken,
5
    environment: environment)
6
//...
7
adjustConfig?.disableSkanAttribution()
8
//...
9
Adjust.initSdk(adjustConfig)

1
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}"
2
                                            environment:ADJEnvironmentSandbox];
3
[adjustConfig disableSkanAttribution];
4
/// ...
5
[Adjust initSdk:adjustConfig];

Update conversion values

+ (void)updateSkanConversionValue:(NSInteger)conversionValue
                      coarseValue:(nullable NSString *)coarseValue
                       lockWindow:(nullable NSNumber *)lockWindow
            withCompletionHandler:(void (^_Nullable)(NSError *_Nullable error))completion;

Conversion values are a mechanism used to measure user behavior in SKAdNetwork. You can map 64 conditions to values from 0 through 63 and send this integer value to SKAdNetwork on user install. This gives you insight into how your users interact with your app in the first few days.

If you manage your conversion values with Adjust, the servers update this value in the SDK. You can also update this value by using the updateSkanConversionValue method. It accepts the following arguments:

Argument	Data type	Description
`fineValue`	Integer	Your conversion value. Must be between `0` and `63`.
`coarseValue`	`SKAdNetwork.CoarseConversionValue`	The coarse conversion value. This value is used if your app doesn’t have sufficient installs to reach the privacy threshold. `SKAdNetworkCoarseConversionValueLow` `SKAdNetworkCoarseConversionValueMedium` `SKAdNetworkCoarseConversionValueHigh`
`lockWindow`	Boolean	Whether to send the postback before the conversion window ends. Use `true` to tell the system to send the postback without waiting for the end of the conversion window. Defaults to `false`.
`completion`	Function	An optional completion handler you provide to catch and handle any errors this method encounters when you update a conversion value. Set this value to `nil` if you don’t provide a handler.

Swift
Objective-C

1
Adjust.updateSkanConversionValue(
2
    1,
3
    coarseValue: SKAdNetwork.CoarseConversionValue.low.rawValue,
4
    lockWindow: false) { error in
5
    if let error {
6
        print( "An error occurred during completion: %@", error.localizedDescription)
7
    }
8
}

1
[Adjust updateSkanConversionValue:1
2
                        coarseValue:SKAdNetworkCoarseConversionValueLow
3
                        lockWindow:NO
4
               withCompletionHandler:^(NSError *_Nullable error) {
5
      NSLog(@"An error occurred during completion: %@", error);
6
}];

SKAdNetwork callbacks

SKAdNetwork 4.0 postbacks contain some additional information to give advertisers more insight into their users. When Adjust’s servers update conversion values, this additional information is sent in an untyped dictionary. To access this information, pass a completion handler to the [adjustSkanUpdatedWithConversionData] method. You can access the callback information in your completion handler.

conversion_value: The updated conversion value.
coarse_value: The updated coarse conversion value
lock_window: Whether to send the postback before the conversion window ends
error: Any error message returned by the update.

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.

Swift
Objective-C

1
func adjustSkanUpdated(withConversionData data: [String: String]) {
2
    print("Conversion value updated callback called!")
3
    print(String(format: "Conversion value dictionary: \n%@", data.description))
4
}

1
- (void)adjustSkanUpdatedWithConversionData:(NSDictionary<NSString *, NSString *> *)data {
2
    NSLog(@"Conversion value updated callback called!");
3
    NSLog(@"Conversion value dictionary: \n%@", data.description);
4
}

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.