adjust-icon

设置 SKAdNetwork 和转化值

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

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

关闭 SKAdNetwork 通讯

方法签名
public void deactivateSKAdNetworkHandling();

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

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

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
adjustConfig.deactivateSKAdNetworkHandling();
//...
Adjust.start(adjustConfig);

更新转化值

方法签名
public static void updateConversionValue(int conversionValue);

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

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

Adjust.updateConversionValue(6);

示例

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

public void OnButtonClick() {
Adjust.updateConversionValue(10);
}

监听转化值变更

方法签名
public void setConversionValueUpdatedDelegate(Action<int> conversionValueUpdatedDelegate, string sceneName = "Adjust");

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

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
adjustConfig.setConversionValueUpdatedDelegate(ConversionValueUpdatedCallback);
//...
Adjust.start(adjustConfig);

示例

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

  • 确认转化值发生更新的消息
  • 新的转化值
using com.adjust.sdk;
public class ExampleGUI : MonoBehaviour {
void OnGUI() {
if (GUI.Button(new Rect(0, 0, Screen.width, Screen.height), "callback")) {
AdjustConfig adjustConfig = new AdjustConfig("{Your App Token}", AdjustEnvironment.Sandbox);
adjustConfig.setLogLevel(AdjustLogLevel.Verbose);
adjustConfig.setConversionValueUpdatedDelegate(ConversionValueUpdatedCallback);
Adjust.start(adjustConfig);
}
}
private void ConversionValueUpdatedCallback(int conversionValue) {
Debug.Log("Conversion value updated. Callback received");
Debug.Log("Conversion value: " + conversionValue);
}
}