设置 SKAdNetwork 和转化值

StoreKit Ad Network (SKAdNetwork) 是 Apple 的归因框架，可针对应用安装和重装进行归因。SKAdNetwork 的工作流程如下：

Apple 会收集归因信息，并通知相关广告渠道。
然后，广告渠道会通过回调将这些信息传输给 Adjust。
Adjust 在 Datascape 中展示 SKAdNetwork 数据。

Disable SKAdNetwork communication

- (void)disableSkanAttribution;

Adjust SDK 默认与 SKAdNetwork 通讯。SDK 在初始化时会注册 SKAdNetwork 归因。

您可以通过调用不带参数的disableSkanAttribution方法来禁用 SKAdNetwork 通讯。

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;

转化值是用来在 SKAdNetwork 中跟踪用户行为的机制。您可以将 64 个条件映射至 0-63 的转化值，并在用户安装时将此整数值发送至 SKAdNetwork。该信息可帮助您进一步了解用户在安装后的最初几日内是如何与应用交互的。

如果您通过 Adjust 管理转化值，那么服务器会在 SDK 中更新该值。您也可以通过 updateSkanConversionValue 方法更新转化值。该方法接受以下参数：

参数	数据类型	描述
`fineValue`	整数	您的转化值。必须在 `0` 至 `63` 之间。
`coarseValue`	`SKAdNetwork.CoarseConversionValue`	粗粒度转化值。如果应用安装量不足，未能达到隐私阈值，就会启用粗粒度转化值。 `SKAdNetworkCoarseConversionValueLow` `SKAdNetworkCoarseConversionValueMedium` `SKAdNetworkCoarseConversionValueHigh`
`lockWindow`	布尔	是否在转化值窗口结束前发送回调。将这一项设置为 `true`，系统就会在转化值窗口结束前发送回调。默认设置为 `false`。
`completion`	功能	您提供的可选 completion handler，用来捕捉并处理更新转化值时该方法遇到的任何错误。如果您不打算提供 handler，请将该值设为 `nil`。

Swift
Objective-C

1
Adjust.updateSkanConversionValue(
2
    1,
3
    coarseValue: SKAdNetwork.CoarseConversionValue.low,
4
    lockWindow: false) { error in
5
    if let error {
6
        print(String(format: "An error occurred during completion: %@", error))
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 回调中包含额外信息，帮助广告主更好地了解用户。Adjust 服务器更新转化值时，这些额外信息就会通过无类型字典发送。要访问此信息，请将一个 completion handler 传递至[adjustSkanUpdatedWithConversionData]方法。您可以在 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

该示例展示了如何记录了细粒度转化值和粗粒度转化值，以及 SKAdNetwork 回调是否在转化值窗口结束前发送。

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

您可以进行应用配置，将赢得归因的 SKAdNetwork 回调副本发送给 Adjust。借此在数据分析中使用 SKAdNetwork 信息。

要设置直接安装回调，您需要将 Adjust 回传 URL 添加至 Info.plist 文件：

在 Xcode Project navigator 中选择 Info.plist 。
在属性列表编辑器中点击 key 旁边的添加按钮，点击 Return。
输入 key 名称： NSAdvertisingAttributionReportEndpoint 。
在弹出菜单中将 Type (类型) 设置为 String (字符串) 。
输入地址： https://adjust-skadnetwork.com 。