Android Adobe Extension v3 迁移指南

针对 Adobe Experience SDK 的 Adjust Extension 已更新至版本 v3。该版本加入了针对 Adjust Android SDK v5 的支持。请按照本指南说明操作，从 v2 迁移至 v3。

要按照版本 v3 的针对 Adobe Experience SDK 的 Adjust Android Extension，请按照下列方式更新您 build.gradle 中的依赖声明：

com.adjust.adobeextension:adobeextension 必须至少更新到版本 3.0.0。
com.adjust.sdk:adjust-android 必须至少更新刀版本 5.0.0。

1
dependencies {
2
   implementation 'com.adjust.adobeextension:adobeextension:3.0.0'
3
   implementation 'com.adjust.sdk:adjust-android:5.4.4'
4
   implementation 'com.adobe.marketing.mobile:core:3.2.0'
5
   implementation 'com.android.installreferrer:installreferrer:2.2'
6
}

要查看针对 Adobe Experience SDK 的 Adjust Android Extension 设置完整指南，请参阅集成指南。

新 API

于 v3 中添加

版本 v3 中添加了下列 API。

解析品牌化短链接

针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 加入了品牌化短链接的解析支持。要解析短链接，请使用下列参数调用 Adjust.processAndResolveDeeplink 方法：

adjustDeeplink: AdjustDeeplink: 打开应用的深度链接。
context: Context: 应用 context。调用 getApplicationContext() 以填充该值。
callback: OnDeeplinkResolvedListener: 以参数形式接收已解析短链接的回传函数。

1
Intent intent = getIntent();
2
Uri data = intent.getData();
3
AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data);
4
Adjust.processAndResolveDeeplink(adjustDeeplink, getApplicationContext(), new OnDeeplinkResolvedListener() {
5
   @Override
6
   public void onDeeplinkResolved(String s) {
7

8
   }
9
});

统一回传参数

针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 加入了对来自 Android SDK v5 的统一回传参数 API 支持。要向会话添加统一回传，请使用下列参数调用 Adjust.addGlobalCallbackParameter：

key: String: 参数的键。
value: String: 参数值。

1
Adjust.addGlobalCallbackParameter("key", "value");
2
Adjust.addGlobalCallbackParameter("user_id", "855");

了解统一回传设置方法。

统一合作伙伴参数

针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 加入了对来自 Android SDK v5 的全局合作伙伴参数 API 支持。要添加全局合作伙伴参数，请使用下列参数调用 Adjust.addGlobalPartnerParameter方法：

key: String: 参数的键。
value: String: 参数值。

1
Adjust.addGlobalPartnerParameter("key", "value");
2
Adjust.addGlobalPartnerParameter("user_id", "855");

了解全局合作伙伴参数设置方法。

设置外部设备 ID

针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 加入了外部设备标识符设置的支持。要设置外部设备 ID，请使用下列参数调用 AdjustAdobeExtensionConfig 实例上的 setExternalDeviceId 方法：

externalDeviceId: String: 您的外部设备标识符。

1
String environment = AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX;
2
AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment);
3
config.setExternalDeviceId("{YourExternalDeviceId}");
4
AdjustAdobeExtension.setConfiguration(config);

了解外部设备 ID 配置方法。

为预安装应用设置默认链接识别码

针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 拓展了支持功能，现在允许您设置默认链接识别码，以便将预安装应用的安装记录到默认推广活动中。要设置默认链接识别码，请使用下列参数调用 AdjustAdobeExtensionConfig 实例上的 setDefaultTracker 方法：

defaultTracker: String: 预安装推广活动的、由英文字母和数字组成的链接识别码

1
String environment = AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX;
2
AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment);
3
config.setDefaultTracker("{Token}");
4
AdjustAdobeExtension.setConfiguration(config);

了解发送预安装应用活动信息的方法。

变更 API

于 v3 中变更

版本 v3 中的以下 API 发生了变更。

调取设备 ADID

在 SDK v2 中，AdjustAttribution 类包含一个名为 adid 的属性。该属性已被移除。您可以调用 Adjust.getAdid 以异步调取设备 ADID。

1
Adjust.getAdid(new OnAdidReadListener() {
2
    @Override
3
    public void onAdidRead(String adid) {
4
      // Your callback function
5
    }
6
});

直接深度链接

在 SDK v2 中，您可将深度链接数据座位参数调用 AdjustAdobeExtension.openUrl 方法，以此打开归因深度链接。

1
Intent intent = getIntent();
2
Uri data = intent.getData();
3
AdjustAdobeExtension.openUrl(data, getApplicationContext());

SDK v3 已更新，可以使用 Adjust Android SDK 的 processDeeplink 方法。要打开直接深度链接，请按照下列步骤操作：

使用深度链接 URL 创建新的 AdjustDeeplink 实例。
将您的 AdjustDeeplink 实例传递至 Adjust.processDeeplink 方法。

1
Intent intent = getIntent();
2
Uri data = intent.getData();
3
AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data);
4
Adjust.processDeeplink(adjustDeeplink, getApplicationContext());

了解如何使用直接深度链接进行用户再归因。

延迟深度链接回传

在 SDK v2 中，您可以对 SDK 进行配置，向 AdjustAdobeExtensionConfig 实例的 setOnDeeplinkResponseListener 方法传递函数，以便在延迟深度链接被打开时启用回传函数。

1
AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment);
2

3
config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() {
4
    @Override
5
    public boolean launchReceivedDeeplink(Uri deeplink) {
6
        if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) {
7
            return true;
8
        } else {
9
            return false;
10
        }
11
    }
12
});
13

14
AdjustAdobeExtension.setConfiguration(config);

在 SDK v5 中，setOnDeeplinkResponseListener 方法已重命名为 setOnDeferredDeeplinkResponseListener。

1
AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment);
2

3
config.setOnDeferredDeeplinkResponseListener(new OnDeferredDeeplinkResponseListener() {
4
    @Override
5
    public boolean launchReceivedDeeplink(Uri deeplink) {
6
        if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) {
7
            return true;
8
        } else {
9
            return false;
10
        }
11
    }
12
});
13

14
AdjustAdobeExtension.setConfiguration(config);

学习如何使用延迟深度链接回传