adjust-icon

设置 SKAdNetwork 和转化值

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

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

关闭 SKAdNetwork 通讯

方法签名
disableSkanAttribution(): void

您的 config 对象包含一个 boolean isSkanAttributionEnabled 属性，该属性控制此行为。您可以通过调用 disableSkanAttribution 方法来禁用 SKAdNetwork 通讯。

const adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);


adjustConfig.disableSkanAttribution();


Adjust.initSdk(adjustConfig);

更新转化值

方法签名
updateSkanConversionValue(conversionValue: number, coarseValue: string, lockWindow: boolean): Promise<string>

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

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

参数数据类型描述
conversionValue数字您的转化值。必须在 0 至 63 之间。
coarseValue字符串 (SKAdNetwork.CoarseConversionValue)粗粒度转化值。如果应用安装量不足，未能达到隐私阈值，就会启用粗粒度转化值。
  • 'low' (针对 SKAdNetworkCoarseConversionValueLow)
  • 'medium' (针对 SKAdNetworkCoarseConversionValueMedium)
  • 'high' (针对 SKAdNetworkCoarseConversionValueHigh)
lockWindow布尔是否在转化值窗口结束前发送回调。将这一项设置为 true，系统就会在转化值窗口结束前发送回调。默认设置为 false。
Adjust.updateSkanConversionValue(6, "low", true, function (error) {
   // error is present in case it happened
});

监听转化值变更

方法签名
setSkanUpdatedCallback(skanUpdatedCallback: (skanData: AdjustSkanData) => void): void

如果您使用 Adjust 管理转化值，那么 Adjust 服务器就会将转化值更新发送到 SDK。您可以设置委托函数，使用 setSkanUpdatedCallback 方法监听更新。请以参数形式传送您的函数。

const adjustConfig = new AdjustConfig(appToken, environment);


adjustConfig.setSkanUpdatedCallback(function (skanData) {
   console.log("Conversion value: " + skanData.conversionValue);
   console.log("Coarse value: " + skanData.coarseValue);
   console.log("Lock window: " + skanData.lockWindow);
   console.log("Error: " + skanData.error);
});


Adjust.initSdk(adjustConfig);

设置直接安装回调

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

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

  1. 在 Xcode Project navigator 中选择 Info.plist 。
  2. 在属性列表编辑器中点击 key 旁边的添加按钮，点击 Return。
  3. 添加下列 key：

针对 SKAdNetwork

  • Key： Advertising attribution report endpoint URL (或 NSAdvertisingAttributionReportEndpoint 原始密钥表示法)
  • 类型： 字符串
  • 值： https://adjust-skadnetwork.com

针对 AdAttributionKit

  • Key： AdAttributionKit - Postback Copy URL (或 AttributionCopyEndpoint 原始密钥表示法)
  • 类型： 字符串
  • 值： https://adjust-skadnetwork.com