adjust-icon

设置 SKAdNetwork 和转化值

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

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

关闭 SKAdNetwork 通讯

方法签名
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);

更新转化值

方法签名
static void updateConversionValue(int conversionValue)

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

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

Adjust.updateConversionValue(6);

监听转化值变更

属性声明
typedef void ConversionValueUpdatedCallback(num? conversionValue);

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

AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
config.conversionValueUpdatedCallback = (num? conversionValue) {
print('[Adjust]: Received conversion value update: ' + conversionValue!.toString());
};
Adjust.start(adjustConfig);

示例

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

  • 确认转化值发生更新的消息
  • 新的转化值
main.dart
import 'package:adjust_sdk/adjust.dart';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
initPlatformState() async {
AdjustConfig config =
new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
config.logLevel = AdjustLogLevel.verbose;
config.conversionValueUpdatedCallback = (num? conversionValue) {
print('[Adjust]: Received conversion value update: ' +
conversionValue!.toString());
};
Adjust.start(config);
}