adjust-icon

设置 SKAdNetwork 和转化值

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

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

关闭 SKAdNetwork 通讯

方法签名
void deactivateSkAdNetworkHandling();
于 v4.23.0 中添加

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

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

AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
adjustConfig.deactivateSKAdNetworkHandling();
Adjust2dx::start(adjustConfig);

更新转化值

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

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

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

Adjust2dx::updateConversionValue(6);

示例

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

bool HelloWorld::init() {
auto position =
Vec2(origin.x + visibleSize.width / 2,
origin.y + visibleSize.height - label->getContentSize().height
+ offset
- divide * (++index));
makeButton(mainmenu, "Update conversion value", position,
CC_CALLBACK_1(HelloWorld::onUpdateCv, this));
}
void HelloWorld::onUpdateCv(cocos2d::Ref *pSender) {
Adjust2dx::updateConversionValue(6);
}

监听转化值变更

方法签名
void setConversionValueUpdatedCallback(void(*callbackMethod)(int conversionValue));

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

AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
adjustConfig.setConversionValueUpdatedCallback(conversionValueUpdatedCallbackMethod);
Adjust2dx::start(adjustConfig);

示例

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

  • 确认转化值发生更新的消息
  • 新的转化值
#include "Adjust/Adjust2dx.h"
bool AppDelegate::applicationDidFinishLaunching() {
std::string appToken = "{YourAppToken}";
std::string environment = AdjustEnvironmentSandbox2dx;
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
adjustConfig.setPostbackConversionValueUpdatedCallback([](int conversionValue) {
std::cout << "\nConversion value updated. Callback received";
std::cout << "\nConversion value: " << conversionValue;
});
Adjust2dx::start(adjustConfig);
}