设置深度链接

深度链接是一种 URI (统一资源标志符，Uniform Resource Identifier)，能将用户带到应用中的特定页面，在用户与链接互动后直接呈现相关内容，优化用户体验。

根据用户是否已经安装您的应用，针对 Adobe Experience SDK 的 Adjust Android Extension 支持两种类型的深度链接：

直接深度链接 ：如果用户已经安装了您的应用，那么链接就会打开指定页面。
延迟深度链接 ：如果用户尚未安装您的应用，链接会将用户转到应用商店进行安装。安装后，应用会打开指定页面。

使用直接深度链接再归因用户

您可以向 Adjust 发送深度链接信息，来对用户进行再归因。当用户与深度链接交互时，您可以将这些数据发送给 Adjust，更新用户的归因信息。

首先，使用您的深度链接 URI 创建一个 AdjustDeeplink 实例。AdjustDeeplink 类会验证该 URI，并检查格式化字符串，以确保处理成功。
然后调用 Adjust.processDeeplink 函数来处理深度链接，并将信息发送至 Adjust。

AdjustDeeplink 类构造函数需要以下参数：

url: Uri: 打开应用的深度链接 URI。

Adjust.processDeeplink 函数需要以下参数：

adjustDeeplink: AdjustDeeplink: 您创建的 AdjustDeeplink 实例。
context: Context: 应用程序的上下文。

延迟深度链接回传

针对 Adobe Experience SDK 的 Adjust Android Extension 默认自动打开延迟深度链接。要控制此行为，或在深度链接打开之前进行验证，请配置扩展，在通过延迟深度链接打开应用时调用一个函数。

在 AdjustAdobeExtensionConfig 实例上调用 setOnDeferredDeeplinkResponseListener。
调用AdjustAdobeExtension.setConfiguration进行设置的配置。

OnDeferredDeeplinkResponseListener 函数需要以下参数：

onDeferredDeeplinkResponseListener: OnDeferredDeeplinkResponseListener: 返回 boolean 值的函数。如果该函数返回 false，那么 Extension 就不会打开延迟深度链接。

教程：创建延迟深度链接函数

如果您已按照集成指南中的说明进行了操作，那么您就已经配置了 Adjust Extension，可以处理和打开深度链接。如果您尚未进行这些操作，请参考设置深度链接处理相关说明完成操作。

在本教程中，您将了解如何使用 setOnDeferredDeeplinkResponseListener 方法，创建能控制深度链接功能的回传函数。该函数会根据下列条件打开链接：

“如果深度链接包含 "no_open"，那么应用就不会将其打开。”

结果将如下：

1
import android.app.Application;
2
import android.util.Log;
3

4
import com.adjust.adobeextension.AdjustAdobeExtension;
5
import com.adjust.adobeextension.AdjustAdobeExtensionConfig;
6
import com.adobe.marketing.mobile.AdobeCallback;
7
import com.adobe.marketing.mobile.Extension;
8
import com.adobe.marketing.mobile.Analytics;
9
import com.adobe.marketing.mobile.Identity;
10
import com.adobe.marketing.mobile.LoggingMode;
11
import com.adobe.marketing.mobile.MobileCore;
12

13
public class MainApp extends Application {
14
    @Override
15
    public void onCreate() {
16
        super.onCreate();
17

18
        MobileCore.setApplication(this);
19
        MobileCore.setLogLevel(LoggingMode.VERBOSE);
20

21
        try {
22
            MobileCore.configureWithAppID("your_adobe_app_id");
23

24
            AdjustAdobeExtensionConfig config =
25
                    new AdjustAdobeExtensionConfig(AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX);
26
            config.setOnDeferredDeeplinkResponseListener(new OnDeferredDeeplinkResponseListener() {
27
                @Override
28
                public boolean launchReceivedDeeplink(Uri deeplink) {
29
                    if (deeplink.contains("no_open")) {
30
                        return false;
31
                    } else {
32
                        return true;
33
                    }
34
                }
35
            });
36
            AdjustAdobeExtension.setConfiguration(config);
37
        } catch (Exception e) {
38
            Log.e("example", "Exception occurred during configuration: " + e.getMessage());
39
        }
40

41
        try {
42
        List<Class<? extends Extension>> extensions = Arrays.asList(
43
                Analytics.EXTENSION,
44
                Identity.EXTENSION,
45
                AdjustAdobeExtension.EXTENSION);
46
        MobileCore.registerExtensions(extensions, new AdobeCallback<object>() {
47
            @Override
48
            public void call(Object o) {
49
                Log.d("example", "Adjust Adobe Extension SDK initialized");
50
            }
51
        });
52
        } catch (Exception e) {
53
            Log.e("example", "Exception occurred while registering Extension: " + e.getMessage());
54
        }
55
    }
56
}

您需要进行下列操作：

在 try...catch 块中调用 AdjustAdobeExtensionConfig 实例的 setOnDeferredDeeplinkResponseListener 方法。以参数形式传送 OnDeferredDeeplinkResponseListener 实例。

21
 try {
22
     MobileCore.configureWithAppID("your_adobe_app_id");
23

24
     AdjustAdobeExtensionConfig config =
25
             new AdjustAdobeExtensionConfig(AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX);
26
     config.setOnDeferredDeeplinkResponseListener(new OnDeferredDeeplinkResponseListener() {});
27
     AdjustAdobeExtension.setConfiguration(config);
28
 } catch (Exception e) {
29
     Log.e("example", "Exception occurred during configuration: " + e.getMessage());
30
 }

在 OnDeferredDeeplinkResponseListener 声明中，创建一个名为 launchReceivedDeeplink 的新公共函数。该方法接受 Uri 参数，并会返回一个 boolean。

26
 config.setOnDeferredDeeplinkResponseListener(new OnDeferredDeeplinkResponseListener() {
27
     @Override
28
     public boolean launchReceivedDeeplink(Uri deeplink) {}
29
 });

向 launchReceivedDeeplink 添加 if 条件，检查 deeplink 是否包含值 "no_open"。如果能找到该字符串，函数就会返回 false，应用不会打开延迟深度链接。

27
 @Override
28
 public boolean launchReceivedDeeplink(Uri deeplink) {
29
     if (deeplink.contains("no_open")) {
30
         return false;
31
     }
32
 }

最后添加 else 块，以便在深度链接不包含 "no_open" 的情况夏返回 true 。

27
 @Override
28
 public boolean launchReceivedDeeplink(Uri deeplink) {
29
     if (deeplink.contains("no_open")) {
30
         return false;
31
     } else {
32
         return true;
33
     }
34
 }

完成了！当用户通过延迟深度链接打开您的应用时，Adjust Extension 就会检查链接中是否包含字符串 "no_open"。如果包含该字符串，应用就不会打开深度链接。