SDK v5 迁移指南

操作前须知

在更新到 SDK v5 之前，您需要进行以下操作：

SDK v5 支持的最低 API 版本已更新。如果您的应用目标版本较低，请先进行更新。
- iOS: 12.0
- 安卓： 21

安装 SDK

要开始使用 SDK v5，您需要将其添加为项目的依赖。为此请进行下列操作：

从 GitHub下载 SDK 档案
复制dist目录下的 C++ 文件，将其添加进 Cocos2d-x 项目

( 仅限安卓 )将 C++ 文件的路径添加到Android.mk文件的LOCAL_SRC_FILES部分。

1
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustConfig2dx.cpp \
2
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustAttribution2dx.cpp \
3
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustProxy2dx.cpp \
4
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustEvent2dx.cpp \
5
$(LOCAL_PATH)/../../../Classes/Adjust/Adjust2dx.cpp \
6
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustEventFailure2dx.cpp \
7
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustEventSuccess2dx.cpp \
8
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustSessionFailure2dx.cpp \
9
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustSessionSuccess2dx.cpp \
10
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustAppStoreSubscription2dx.cpp \
11
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustPlayStoreSubscription2dx.cpp \
12
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustThirdPartySharing2dx.cpp \
13
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustAdRevenue2dx.cpp
14
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustAppStorePurchase2dx.cpp \
15
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustPlayStorePurchase2dx.cpp \
16
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustDeeplink2dx.cpp \
17
$(LOCAL_PATH)/../../../Classes/Adjust/AdjustPurchaseVerificationResult2dx.cpp \

如果您使用 CMake，请将以下来源和标头列表添加至您的CMakeLists.txt文件：

1
# add cross-platforms source files and header files
2
list(APPEND GAME_SOURCE
3
    Classes/Adjust/AdjustConfig2dx.cpp
4
    Classes/Adjust/AdjustAttribution2dx.cpp
5
    Classes/Adjust/AdjustProxy2dx.cpp
6
    Classes/Adjust/AdjustEvent2dx.cpp
7
    Classes/Adjust/AdjustAdRevenue2dx.cpp
8
    Classes/Adjust/AdjustAppStoreSubscription2dx.cpp
9
    Classes/Adjust/AdjustPlayStoreSubscription2dx.cpp
10
    Classes/Adjust/AdjustAppStorePurchase2dx.cpp
11
    Classes/Adjust/AdjustPlayStorePurchase2dx.cpp
12
    Classes/Adjust/Adjust2dx.cpp
13
    Classes/Adjust/AdjustEventFailure2dx.cpp
14
    Classes/Adjust/AdjustEventSuccess2dx.cpp
15
    Classes/Adjust/AdjustSessionFailure2dx.cpp
16
    Classes/Adjust/AdjustSessionSuccess2dx.cpp
17
    Classes/Adjust/AdjustThirdPartySharing2dx.cpp
18
    Classes/Adjust/AdjustDeeplink2dx.cpp
19
    Classes/Adjust/AdjustPurchaseVerificationResult2dx.cpp
20
    )
21
list(APPEND GAME_HEADER
22
    Classes/Adjust/AdjustConfig2dx.h
23
    Classes/Adjust/AdjustAttribution2dx.h
24
    Classes/Adjust/AdjustProxy2dx.h
25
    Classes/Adjust/AdjustEvent2dx.h
26
    Classes/Adjust/AdjustAdRevenue2dx.h
27
    Classes/Adjust/AdjustAppStoreSubscription2dx.h
28
    Classes/Adjust/AdjustPlayStoreSubscription2dx.h
29
    Classes/Adjust/AdjustAppStorePurchase2dx.h
30
    Classes/Adjust/AdjustPlayStorePurchase2dx.h
31
    Classes/Adjust/Adjust2dx.h
32
    Classes/Adjust/AdjustEventFailure2dx.h
33
    Classes/Adjust/AdjustEventSuccess2dx.h
34
    Classes/Adjust/AdjustSessionFailure2dx.h
35
    Classes/Adjust/AdjustSessionSuccess2dx.h
36
    Classes/Adjust/AdjustThirdPartySharing2dx.h
37
    Classes/Adjust/AdjustDeeplink2dx.h
38
    Classes/Adjust/AdjustPurchaseVerificationResult2dx.h
39
    )

( 仅限安卓 )：从GitHub 发布页面下载最新的adjust-android.aar并将其导入您的 Android Studio 项目中。
( 仅限 iOS )：从GitHub 发布页面下载最新的AdjustSdk.framework并将其链接到您的 Xcode 项目中。

设置签名库

SDK v5 使用SDK 签名库来加密从 Adjust SDK 发送到 Adjust 服务器的信息。您必须将签名库添加到项目中才能使用 SDK v5。

安卓应用

从Adjust 签名库 GitHub 库下载最新的adjust-android-signature.aar 。
将.aar添加至您的 Android Studio 项目。

iOS 应用

从Adjust 签名库 GitHub 库下载最新的AdjustSigSdk-iOS-Static.a 。
请在您的 Xcode 项目中关联.a。

更新应用的隐私清单 (仅限 iOS)

要向 App Store 通知 Adjust SDK 的隐私要求，您需要将您的隐私清单与 Adjust 的隐私清单合并。

将Adjust SDK 隐私清单属性添加至应用的隐私清单。
将签名库隐私清单属性添加至应用的隐私清单。

更新初始化方法

于 v5 中变更

在 SDK v4 中，初始化方法为Adjust2dx::start(adjustConfig) 。现已变更为Adjust2dx::initSdk(adjustConfig) 。

1
#include "Adjust/Adjust2dx.h"
2

3
std::string appToken = "YourAppToken";
4
std::string environment = AdjustEnvironmentSandbox2dx;
5

6
AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
7
 Adjust2dx::start(adjustConfig);
8
 Adjust2dx::initSdk(adjustConfig);

变更 API

于 v5 中变更

SDK v5 中变更了下列 API。

禁用或启用 SDK

在 SDK v4 中，您可以通过调用带bool值的Adjust2dx::setEnabled来启用和禁用 SDK。

1
Adjust2dx::setEnabled(false); // disable SDK
2
Adjust2dx::setEnabled(true); // enable SDK

在 SDK v5 中，为清晰起见，此功能被分成单独的命令。

调用Adjust2dx::disable()来禁用 SDK。
调用Adjust2dx::enable()来启用 SDK。

1
Adjust2dx::disable();
2
Adjust2dx::enable();

在后台发送信息

在 SDK v4 中，您可以将adjustConfig实例上的sendInBackground属性设置为true，以此允许 SDK 在应用后台运行时向 Adjust 发送信息。

1
adjustConfig.sendInBackground(true);

在 SDK v5 中，您需要调用adjustConfig实例的enableSendingInBackground方法，以此允许 SDK 在应用后台运行时向 Adjust 发送信息。

1
adjustConfig.enableSendingInBackground();

预安装应用监测

在 SDK v4 中，您可以使用true参数来调用adjustConfig实例的setPreinstallTrackingEnabled方法，以此来监测预安装应用。

1
adjustConfig.setPreinstallTrackingEnabled(true);

在 SDK v5 中，您需要调用adjustConfig实例的enablePreinstallTracking方法来启用预安装应用监测。

1
adjustConfig.enablePreinstallTracking();

禁用 AdServices 信息读取

在 SDK v4 中，您可以使用false值在adjustConfig上调用setAllowAdServicesInfoReading方法，阻止 Adjust SDK 读取 AdServices 信息。

1
adjustConfig.setAllowAdServicesInfoReading(false);

在 SDK v5 中，您需要在adjustConfig实例上调用disableAdServices方法，以防止 Adjust SDK 读取 AdServices 信息。默认状态为true 。

1
adjustConfig.disableAdServices();

禁用 IDFA 读取

在 SDK v4 中，您可以使用false值在adjustConfig实例上调用setAllowIdfaReading方法，以防止 Adjust SDK 读取设备的 IDFA。

1
adjustConfig.setAllowIdfaReading(false);

在 SDK v5 中，您需要在adjustConfig实例上调用disableIdfaReading方法，以防止 Adjust SDK 读取设备的 IDFA。默认状态为true 。

1
adjustConfig.disableIdfaReading();

在归因中启用成本数据

在 SDK v4 中，您可以将adjustConfig实例的setNeedsCost属性设置为true，在设备的归因信息中包含成本数据。

1
adjustConfig.setNeedsCost(true);

在 SDK v5 中，您需要在adjustConfig实例上调用enableCostDataInAttribution方法，在设备的归因信息中包含成本数据。默认状态为false 。

1
adjustConfig.enableCostDataInAttribution();

启用 LinkMe

在 SDK v4 中，您可以使用true值在adjustConfig实例上调用setLinkMeEnabled方法，以此来启用 Adjust LinkMe。

1
adjustConfig.setLinkMeEnabled(true);

在 SDK v5 中，您需要在adjustConfig实例上调用enableLinkMe方法，启用 Adjust LinkMe。默认状态为false 。

1
adjustConfig.enableLinkMe();

只读取设备 ID 一次

在 SDK v4 中，您可以使用true值在adjustConfig实例上调用setReadDeviceInfoOnceEnabled方法，指示 SDK 只读取设备 ID 一次。

1
adjustConfig.setReadDeviceInfoOnceEnabled(true);

在 SDK v5 中，您需要在adjustConfig实例上调用enableDeviceIdsReadingOnce方法，指示 SDK 只读取设备 ID 一次。默认状态为false 。

1
adjustConfig.enableDeviceIdsReadingOnce();

离线模式

在 SDK v4 中，您可以通过调用带bool参数的Adjust2dx::setOfflineMode来启用和禁用 SDK 离线模式。

1
Adjust2dx::setOfflineMode(true);
2
Adjust2dx::setOfflineMode(false);

在 SDK v5 中，为清晰起见，此功能被分成单独的命令。

调用Adjust2dx::switchToOfflineMode将 SDK 设为离线模式。
调用Adjust2dx::switchBackToOnlineMode将 SDK 重新设为在线模式。

1
Adjust2dx::switchToOfflineMode(); // Put the SDK in offline mode
2
Adjust2dx::switchBackToOnlineMode(); // Put the SDK back in online mode

会话回传参数

在 SDK v4 中，您可以通过传递键值对至Adjust2dx::addSessionCallbackParameter方法来添加会话回传参数，也可以使用Adjust2dx::removeSessionCallbackParameter方法移除单个参数。

1
Adjust2dx::addSessionCallbackParameter("key", "value");
2
Adjust2dx::removeSessionCallbackParameter("key");
3
Adjust2dx::resetSessionCallbackParameters();

在 SDK v5 中，会话回传参数被重命名为统一参数。

1
Adjust2dx::addGlobalCallbackParameter("key", "value");
2
Adjust2dx::removeGlobalCallbackParameter("key");
3
Adjust2dx::removeGlobalCallbackParameters();

会话合作伙伴参数

在 SDK v4 中，您可以通过传递键值对至Adjust2dx::addSessionPartnerParameter方法来添加会话合作伙伴参数，也可以使用Adjust2dx::removeSessionPartnerParameter方法移除单个参数。

1
Adjust2dx::addSessionPartnerParameter("key", "value");
2
Adjust2dx::removeSessionPartnerParameter("key");
3
Adjust2dx::resetSessionPartnerParameters();

在 SDK v5 中，会话合作伙伴参数被重命名为统一合作伙伴参数。

1
Adjust2dx::addGlobalPartnerParameter("key", "value");
2
Adjust2dx::removeGlobalPartnerParameter("key");
3
Adjust2dx::removeGlobalPartnerParameters();

事件去重

在 SDK v4 中，事件去重与事件transaction ID同时进行且唯一 ID 的数量上限为 10 个。

1
adjustEvent.setTransactionId("transaction-id");

在 SDK v5 中，该功能与transaction ID分离。事件去重添加了名为deduplicationId的新 ID 字段。

1
adjustEvent.setDeduplicationId("deduplication-id");

您可以自定义deduplicationId的数量限制，添加到用于识别重复事件的列表中。默认情况下，数量上限为 10 。

1
AdjustConfig2dx adjustConfig = AdjustConfig2dx("appToken", AdjustEnvironmentSandbox2dx);
2
adjustConfig.setEventDeduplicationIdsMaxSize(20);
3
Adjust2dx::initSdk(adjustConfig);

App Store 订阅

在 SDK v4 中，您可以通过配置AdjustAppStoreSubscription2dx对象来设置新的订阅。该对象使用四个参数进行初始化：price 、 currency 、 transactionId和receipt 。

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(price, currency, transactionId, receipt);

在SDK v5 中，您无需发送receipt参数，因为收入验证不再需要此参数。

1
AdjustAppStoreSubscription2dx subscription = AdjustAppStoreSubscription2dx(price, currency, transactionId);

通过深度链接进行再归因

在 SDK v4 中，您可以将深度链接信息传递至Adjust2dx::appWillOpenUrl方法。

1
Adjust2dx::appWillOpenUrl("url");

为清晰起见，在 SDK v5 中，该方法已重命名为Adjust2dx::processDeeplink 。其中添加了新的AdjustDeeplink2dx类用于构建深度链接。要处理深度链接，请使用您的深度链接 URL 实例化AdjustDeeplink2dx对象并将其传递至Adjust2dx::processDeeplink方法。

1
AdjustDeeplink2dx deeplink = AdjustDeeplink2dx("url");
2
Adjust2dx::processDeeplink(deeplink);

深度链接解析

在 SDK v4 中，您可以通过将url传递至Adjust2dx::processDeeplink方法来解析缩短的深度链接。

1
Adjust2dx::processDeeplink("url", [](std::string resolvedLink) {
2
    std::cout << "Resolved link: " << resolvedLink;
3
});

在 SDK v5 中，您需要发送使用深度链接url初始化的AdjustDeeplink2dx对象。此操作会返回未缩短的原始深度链接。

1
AdjustDeeplink2dx deeplink = AdjustDeeplink2dx("url");
2
Adjust2dx::processDeeplink(deeplink, [](std::string resolvedLink) {
3
    std::cout << "Resolved link: " << resolvedLink;
4
});

COPPA 合规

在 SDK v4 中，您可以使用true值在adjustConfig实例上调用coppaCompliantEnabled方法，启用 COPPA 合规。

1
adjustConfig.setCoppaCompliantEnabled(true);

在 SDK v5 中，您需要在adjustConfig实例上调用enableCoppaCompliance方法，启用 COPPA 合规。默认状态为false 。

1
adjustConfig.enableCoppaCompliance();

Play 商店儿童应用

在 SDK v4 中，您可以使用true值在adjustConfig实例上调用setPlayStoreKidsAppEnabled方法，将应用标记为Play 商店儿童应用。该属性会在 SDK 初始化期间读取，也就是说 SDK 初始化后该值将无法更新。

1
adjustConfig.setPlayStoreKidsAppEnabled(true);

在 SDK v5 中，您需要调用adjustConfig实例的enablePlayStoreKidsCompliance方法来启用合规。默认状态为false 。

1
adjustConfig.enablePlayStoreKidsCompliance();

设置数据驻留和 URL 策略

在 SDK v4 中，URL 策略和数据驻留域名在AdjustConfig类中被定义为常量。

1
adjustConfig.setUrlStrategy(AdjustDataResidencyEU);

在 SDK v5 中，您需要将选定的一个或多个域名以数组的形式发送。您还需要进行下列设置：

useSubdomains (bool): 域名是否应被视为 Adjust 域名。若为 true，则 SDK 会为域名添加 Adjust 子域名前缀。若为 false，SDK 会使用收到的域名，不添加任何前缀。
isDataResidency ( bool )：域名是否用于数据驻留。

1
adjustConfig.setUrlStrategy({"eu.adjust.com"}, true, true);

请查看下方表格，了解如何在 SDK v5 中配置 URL 策略。

v4	v5 - 主要和后备域名	v5 - 使用子域名	v5 - 数据驻留
`AdjustDataResidencyEU`	`"eu.adjust.com"`	`true`	`true`
`AdjustDataResidencyTR`	`"tr.adjust.com"`	`true`	`true`
`AdjustDataResidencyUS`	`"us.adjust.com"`	`true`	`true`
`AdjustUrlStrategyChina`	`"adjust.world"`： `"adjust.com"`	`true`	`false`
`AdjustUrlStrategyCn`	`"adjust.cn"`： `"adjust.com"`	`true`	`false`
`AdjustUrlStrategyCnOnly`	`"adjust.cn"`	`true`	`false`
`AdjustUrlStrategyIndia`	`"adjust.net.in"`： `"adjust.com"`	`true`	`false`

示例

1
// India URL strategy
2
adjustConfig.setUrlStrategy({"adjust.net.in", "adjust.com"}, true, false);
3

4
// China URL strategy
5
adjustConfig.setUrlStrategy({"adjust.world", "adjust.com"}, true, false);
6

7
// China only URL strategy
8
adjustConfig.setUrlStrategy({"adjust.cn"}, true, false);
9

10
// EU URL strategy
11
adjustConfig.setUrlStrategy({"eu.adjust.com"}, true, true);
12

13
// Turkey URL strategy
14
adjustConfig.setUrlStrategy({"tr.adjust.com"}, true, true);
15

16
// US URL strategy
17
adjustConfig.setUrlStrategy({"us.adjust.com"}, true, true);

记录广告收入

在 SDK v4 中，您可以通过实例化带有广告收入来源常量的AdjustAdRevenue2dx对象来记录广告收入。

1
AdjustAdRevenue2dx adRevenue = AdjustAdRevenue2dx(AdjustAdRevenueSourceAppLovinMAX);

在 SDK v5 中，您需要使用字符串source实例化AdjustAdRevenue对象。

1
AdjustAdRevenue2dx adRevenue = AdjustAdRevenue2dx("applovin_max_sdk")

v4	v5
`AdjustAdRevenueSourceAppLovinMAX`	`"applovin_max_sdk"`
`AdjustAdRevenueSourceAdMob`	`"admob_sdk"`
`AdjustAdRevenueSourceIronSource`	`"ironsource_sdk"`
`AdjustAdRevenueSourceAdMostSource`	`"admost_sdk"`
`AdjustAdRevenueSourceUnity`	`"unity_sdk"`
`AdjustAdRevenueSourceHeliumChartboost`	`"helium_chartboost_sdk"`
`AdjustAdRevenueSourceAdx`	`"adx_sdk"`
`AdjustAdRevenueSourcePublisher`	`"publisher_sdk"`
`AdjustAdRevenueSourceTopOn`	`"topon_sdk"`
`AdjustAdRevenueSourceMopub`	不再支持

关闭 SKAdNetwork 通讯

在 SDK v4 中，您可以通过调用adjustConfig.deactivateSKAdNetworkHandling方法来阻止 SDK 与 SKAdNetwork 通讯。

1
adjustConfig.deactivateSKAdNetworkHandling();

在 SDK v5 中，您需要在adjustConfig实例上调用disableSkanAttribution方法，以此禁用 SKAdNetwork 通讯。默认状态为true 。

1
adjustConfig.disableSkanAttribution();

监听转化值更新

在 SDK v4 中，您可以在adjustConfig实例上调用setPostbackConversionValueUpdatedCallback方法来监听转化值更新。在 SKAN4 之前，您可以使用setConversionValueUpdatedCallback方法。

1
// pre-SKAN4 callback
2
adjustConfig.setConversionValueUpdatedCallback([](int conversionValue) {
3
    std::cout << "\nConversion value: " << conversionValue;
4
});
5
// SKAN4 callback
6
adjustConfig.setPostbackConversionValueUpdatedCallback([](
7
        int conversionValue,
8
        std::string coarseValue,
9
        bool lockWindow) {
10
    std::cout << "\nConversion value: " << conversionValue;
11
    std::cout << "\nCoarse value: " << coarseValue;
12
    std::cout << "\nLock window: " << lockWindow;
13
});

在 SDK v5 中，您需要为adjustConfig对象的setSkanUpdatedCallback方法指定一个回传函数。

1
adjustConfig.setSkanUpdatedCallback([](
2
    std::unordered_map<std::string, std::string> data) {
3
    std::cout << "\nConversion value: " << data["conversionValue"];
4
    std::cout << "\nCoarse value: " << data["coarseValue"];
5
    std::cout << "\nLock window: " << data["lockWindow"];
6
    std::cout << "\nError: " << data["error"];
7
});

更新转化值

在 SDK v4 中，您可以使用以下方法之一向 Adjust 发送更新后转化值：

1
// pass just the conversion value (deprecated method)
2
Adjust2dx::updateConversionValue(6);
3

4
// pass the conversion value and a callback to receive a message about potential error
5
Adjust2dx::updatePostbackConversionValue(6, [](std::string error) {
6
    std::cout << "Error while updating conversion value: " << error;
7
});
8

9
// SKAN 4.0
10
// pass the conversion value, coarse value and a callback to receive a message about potential error
11
Adjust2dx::updatePostbackConversionValue(6, "low", [](std::string error) {
12
    std::cout << "Error while updating conversion value: " << error;
13
});
14

15
// SKAN 4.0
16
// pass the conversion value, coarse value, lock window and a callback to receive a message about potential error
17
Adjust2dx::updatePostbackConversionValue(6, "low", false, [](std::string error) {
18
    std::cout << "Error while updating conversion value: " << error;
19
});

如需更新 SDK v5 中的转化值，请使用带下列参数的updateSkanConversionValue方法：

conversionValue ( int )：更新后的转化值
coarseValue ( std::string )：更新后的粗粒度转化值
lockWindow (bool)：是否在转化窗口结束前发送回调

1
Adjust2dx::updateSkanConversionValue(6, "low", true, [](std::string error) {
2
    std::cout << "Error while updating conversion value: " << error;
3
});

App Tracking Transparency 授权包装器

在 SDK v4 中，您可以使用Adjust2dx::requestTrackingAuthorizationWithCompletionHandler方法处理用户 ATT 授权状态变更。

1
Adjust2dx::requestTrackingAuthorizationWithCompletionHandler([] (int status) {
2
    switch (status) {
3
        case 0:
4
            // ATTrackingManagerAuthorizationStatusNotDetermined case
5
            break;
6
        case 1:
7
            // ATTrackingManagerAuthorizationStatusRestricted case
8
            break;
9
        case 2:
10
            // ATTrackingManagerAuthorizationStatusDenied case
11
            break;
12
        case 3:
13
            // ATTrackingManagerAuthorizationStatusAuthorized case
14
            break;
15
    }
16
});

为清晰起见，该参数在 SDK v5 中被重命名为Adjust2dx::requestAppTrackingAuthorization 。

1
Adjust2dx::requestAppTrackingAuthorization([] (int status) {
2
    switch (status) {
3
        case 0:
4
            // ATTrackingManagerAuthorizationStatusNotDetermined case
5
            break;
6
        case 1:
7
            // ATTrackingManagerAuthorizationStatusRestricted case
8
            break;
9
        case 2:
10
            // ATTrackingManagerAuthorizationStatusDenied case
11
            break;
12
        case 3:
13
            // ATTrackingManagerAuthorizationStatusAuthorized case
14
            break;
15
    }
16
});

获取设备信息

在 SDK v4 中，所有设备信息 getter 方法都会同步运行。在 SDK v5 中，这些方法已改为异步运行。您可以添加回传函数，在异步流程完成时处理信息。

1
// IDFA getter
2
Adjust2dx::getIdfa([](std::string idfa) {
3
    std::cout << "\nIDFA = " << idfa;
4
});
5

6
// IDFV getter
7
Adjust2dx::getIdfv([](std::string idfv) {
8
    std::cout << "\nIDFV = " << idfa;
9
});
10

11
// ADID getter
12
Adjust2dx::getAdid([](std::string adid) {
13
    std::cout << "\nAdjust ID = " << adid;
14
});
15

16
// Attribution getter
17
Adjust2dx::getAttribution([](AdjustAttribution2dx attribution) {
18
   // process attribution
19
});
20

21
// Enabled status getter
22
Adjust2dx::isEnabled([](bool isEnabled) {
23
   // process isEnabled
24
});
25

26
// SDK version getter
27
Adjust2dx::getSdkVersion([](std::string sdkVersion) {
28
    std::cout << "\nSDK version = " << sdkVersion;
29
});
30

31
// Last deep link getter
32
Adjust2dx::getLastDeeplink([](std::string lastDeeplink) {
33
    std::cout << "\nLast deeplink = " << lastDeeplink;
34
});

移除 API

于 v5 中删除

SDK v5 中移除了下列 API。

事件缓冲

SDK v4 支持事件缓冲。该功能可将请求事件、广告收入、推送标签 (Push token) 和其他信息存储在本地缓冲区中以便在之后发送。

1
adjustConfig.setEventBufferingEnabled(true);

SDK v5 中已删除该设置。

自定义用户代理字符串

SDK v4 支持使用用户代理字符串调用 adjustConfig.setUserAgent 来设置自定义用户代理。

1
adjustConfig.setUserAgent("custom-user-agent");

SDK v5 中已删除该设置。

设置设备是否已知

在 SDK v4 中，您可以调用adjustConfig.setDeviceKnown方法，手动告知 SDK 设备是否为已知设备。

1
adjustConfig.setDeviceKnown(true);

SDK v5 中已删除该设置。

延迟 SDK 启动

SDK v4 支持通过调用adjustConfig.setDelayStart来延迟 SDK 的启动，最多延迟 10 秒 。

1
adjustConfig.setDelayStart(10);

该方法在 SDK v5 中已被移除。中断此延迟的Adjust2dx::sendFirstPackages()方法也已被移除。

在 SDK v4 中，您可以调用Adjust2dx::disableThirdPartySharing方法来全面禁用第三方信息分享。

1
Adjust2dx::disableThirdPartySharing();

SDK v5 中已删除该功能。在 SDK v5 中，使用Adjust2dx::trackThirdPartySharing方法来启用或禁用第三方共享。

1
AdjustThirdPartySharing2dx thirdPartySharing = AdjustThirdPartySharing2dx(false);
2
Adjust2dx::trackThirdPartySharing(thirdPartySharing);

SDK v5 迁移指南

操作前须知

安装 SDK

设置签名库

安卓应用

iOS 应用

更新应用的隐私清单 (仅限 iOS)

更新初始化方法

变更 API

禁用或启用 SDK

在后台发送信息

预安装应用监测

禁用 AdServices 信息读取

禁用 IDFA 读取

在归因中启用成本数据

启用 LinkMe

只读取设备 ID 一次

离线模式

会话回传参数

会话合作伙伴参数

事件去重

App Store 订阅

通过深度链接进行再归因

深度链接解析

COPPA 合规

Play 商店儿童应用

设置数据驻留和 URL 策略

示例

记录广告收入

关闭 SKAdNetwork 通讯

监听转化值更新

更新转化值

App Tracking Transparency 授权包装器

获取设备信息

移除 API

事件缓冲

自定义用户代理字符串

设置设备是否已知

延迟 SDK 启动

全局禁用第三方分享