adjust-icon

设置 SKAdNetwork 和转化值

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

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

关闭 SKAdNetwork 通讯

属性声明
public bool? IsSkanAttributionEnabled { get; set; }

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

您可以通过将AdjustConfig实例的IsSkanAttributionEnabled属性设置为bool值来控制此行为。

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
adjustConfig.IsSkanAttributionEnabled = false;
//...
Adjust.InitSdk(adjustConfig);

监听转化值变更

属性声明
public Action<Dictionary<string, string>> SkanUpdatedDelegate { get; set; }

如果您使用 Adjust 管理转化值,那么 Adjust 服务器就会将转化值更新发送到 SDK。您可以设置委托函数,将函数指定给AdjustConfig实例的SkanUpdatedDelegate属性来监听这些变化。

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

委托函数会从 SKAdNetwork 接收带有下列属性的回调:

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

如果低、中、高三个值的条件都不满足,Apple 就会发送 none。
lock_window是否在转化值窗口结束前发送回调。1 表示回调会在转化窗口结束前发送。在 SKAdNetwork 4.0 回调中默认为 0;在更旧的 SKAdNetwork 版本中默认为 nil
error发生错误时包含错误消息。

示例

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

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.LogLevel = AdjustLogLevel.Verbose;
adjustConfig.SkanUpdatedDelegate = SkanUpdatedDelegate;
Adjust.InitSdk(adjustConfig);
}
private void SkanUpdatedDelegate(Dictionary<string,string> response) {
Debug.Log("Conversion value updated. Callback received");
Debug.Log("Conversion value: " + response["fine_value"]);
Debug.Log("Coarse conversion value: " + response["coarse_value"]);
Debug.Log ("Will send before conversion value window ends: " response["lock_window"]);
Debug.Log("Error message: " response["error"]);
}
}
};

设置直接安装回调

您可以进行应用配置,将赢得归因的 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