adjust-icon

设置 SKAdNetwork 和转化值

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

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

关闭 SKAdNetwork 通讯

方法签名
public deactivateSKAdNetworkHandling(): void
于 v4.23.0 中添加

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

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

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


adjustConfig.deactivateSKAdNetworkHandling();


Adjust.create(adjustConfig);

更新转化值

方法签名
updateConversionValue: (conversionValue: number) => void

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

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

Adjust.updateConversionValue(6);

示例

该示例展示了如何在用户触发事件后将转化值更新为 10。

function _onPress_trackSimpleEvent() {
   Adjust.updateConversionValue(10);
}

监听转化值变更

方法签名
public setConversionValueUpdatedCallbackListener(
   callback: (conversionValue: AdjustConversionValue) => void
): void

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

const adjustConfig = new AdjustConfig(appToken, environment);


adjustConfig.setConversionValueUpdatedCallbackListener(
   function (conversionValue) {
      console.log("Conversion value updated callback recveived");
      console.log("Conversion value: " + conversionValue.conversionValue);
   },
);


Adjust.create(adjustConfig);

示例

该示例展示了如何在转化值更新时记录下列内容：

  • 确认转化值发生更新的消息
  • 新的转化值
import { Adjust, AdjustEvent, AdjustConfig } from "react-native-adjust";
import { AdjustOaid } from "react-native-adjust-oaid";


const App: () => React$Node = () => {
   Adjust.getSdkVersion(function (sdkVersion) {
      console.log("Adjust SDK version: " + sdkVersion);
   });


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


   adjustConfig.setConversionValueUpdatedCallbackListener(function (
      conversionValue
   ) {
      console.log("Conversion value updated. Callback received");
      console.log("Conversion value: " + conversionValue.conversionValue);
   });


   Adjust.create(adjustConfig);
};


export default App;

SKAdNetwork 4.0 回传

于 v4.33.0 中添加

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

参数数据类型描述
fineValueNSNumberAdjsut 服务器发送的转化值
coarseValueNSString粗粒度转化值。如果应用安装量不足，未能达到隐私阈值，就会启用粗粒度转化值。
  • none
  • low
  • medium
  • high

如果低、中、高三个值的条件都不满足，Apple 就会发送 none。
lockWindowNSNumber是否在转化窗口结束前发送回调。1 表示回调会在转化窗口结束前发送。在 SKAdNetwork 4.0 回调中默认为 0；在更旧的 SKAdNetwork 版本中默认为 nil。

示例

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

import { Adjust, AdjustEvent, AdjustConfig } from "react-native-adjust";
import { AdjustOaid } from "react-native-adjust-oaid";


const App: () => React$Node = () => {
   Adjust.getSdkVersion(function (sdkVersion) {
      console.log("Adjust SDK version: " + sdkVersion);
   });


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


   adjustConfig.setSkad4ConversionValueUpdatedCallbackListener(function (
      conversionValue, coarseValue, lockWindow
   ) {
      console.log("Conversion value updated. Callback received");
      console.log("Fine conversion value: " + conversionValue);
      console.log("Coarse conversion value: " + coarseValue);
      console.log("Will send before conversion value window ends: " + lockWindow.toString());
   });


   Adjust.create(adjustConfig);
};


export default App;

设置直接安装回调

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

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

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