设置 SKAdNetwork 和转化值

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

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

监听转化值更新

如果您使用 Adjust 管理转化值，那么 Adjust 后端就会将转化值更新发送到 SDK。您可以设置委托函数，使用 adjustConversionValueUpdated 方法监听转化值更新。

func adjustConversionValueUpdated(_ conversionValue: NSNumber?){
    print("Conversion value: (conversionValue ?? 0)")
}

SKAdNetwork 4.0 回传

SKAdNetwork 4.0 回调中包含额外信息，帮助广告主更好地了解用户。Adjust 后端更新转化值时，这些额外信息就会通过负载发送。您可以使用 adjustConversionValueUpdated 回传方法访问这些信息。

func adjustConversionValueUpdated(_ fineValue: NSNumber?, coarseValue: String?, lockWindow: NSNumber?){
    print("Fine conversion value: (fineValue ?? 0)")
    print("Coarse conversion value: (coarseValue ?? "")")
    print("Will send before conversion value window ends: (lockWindow?.boolValue ?? nil)")
}

更新转化值

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

如果您通过 Adjust 管理转化值，那么后端会在 SDK 中更新该值。您也可以通过updateConversionValue方法更新转化值。该方法会包装Apple 的updateConversionValue方法，接受代表更新后的转化值的整数参数。

[Adjust updateConversionValue:value];

Adjust.updateConversionValue(value)

func onButtonClick() {
   Adjust.updateConversionValue(10)
}

设置 completion handler

Adjust SDK 包含 Apple updatePostbackConversionValue 方法的包装器。这些方法可提供更多 SKAdNetwork 回调处理选项，包括处理失败的选项。

受支持的方法如下：

• updatePostbackConversionValue(_:completionHandler:) – 更新转化值并处理失败。
• updatePostbackConversionValue(_:completionHandler:coarseValue:) – 更新粗粒度和细粒度转化值并处理失败。
• updatePostbackConversionValue(_:coarseValue:lockWindow:completionHandler:) – 更新粗粒度和细粒度转化值，决定是否在转化值窗口结束前发送回调，并处理错误。

示例

if #available(iOS 16.1, *) {
    Adjust.updatePostbackConversionValue(
        1,
        coarseValue: SKAdNetwork.CoarseConversionValue.low.rawValue,
lockWindow: false) { error in
        if let error {
            print(String(format: "An error occurred during completion: %a", error))
        }
    }
}

设置直接安装回调

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

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

1. 在 Xcode Project navigator 中选择 Info.plist。
2. 在属性列表编辑器中点击 key 旁边的添加按钮 ( +​ )，点击 回车​ 。
3. 输入 ​NSAdvertisingAttributionReportEndpoint​ 作为 key 的名称。
4. 在弹出菜单中将 Type (类型)​ 设置为 String (字符串)​ 。
5. 输入 URL ​https://adjust-skadnetwork.com​ 。

要了解更多信息，请查阅 Apple 的 Configuring an Advertised App 指南。

关闭 SKAdNetwork 通讯

v4.23.0 及以上版本的 Adjust SDK 会默认与 SKAdNetwork 通讯。SDK 在初始化时会注册 SKAdNetwork 归因。

您的 config 对象包含一个 isSKAdNetworkHandlingActive布尔属性，该属性控制此行为。您可以通过 no 参数调用deactivateSKAdNetworkHandling方法来禁用 SKAdNetwork 通讯。

[adjustConfig.deactivateSKAdNetworkHandling];

adjustConfig.deactivateSKAdNetworkHandling()