设置深度链接

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

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

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

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

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

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

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

deeplink: NSURL: 打开应用的深度链接 URI。

processDeeplink 函数需要以下参数：

adjustDeeplink: ADJDeeplink: 您创建的 ADJDeeplink 实例。

延迟深度链接回传

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

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

setDeferredDeeplinkReceivedBlock 函数需要以下参数：

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

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

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

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

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

结果将如下：

Swift
Objective-C

1
import UIKit
2
import AEPCore
3
import AEPServices
4
import AdjustAdobeExtension
5

6
@main
7
class AppDelegate: UIResponder, UIApplicationDelegate {
8

9
   func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
10
      MobileCore.setLogLevel(LogLevel.trace)
11
      let appState = application.applicationState
12

13
      if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
14
        config.setDeferredDeeplinkReceivedBlock { (deeplink: URL?) -> Bool in
15
            if let deeplinkString = deeplink?.absoluteString.lowercased(),
16
            deeplinkString.contains("no_open") {
17
                return false
18
            }
19
            return true
20
        }
21
         AdjustAdobeExtension.setConfiguration(config)
22
      }
23

24
      MobileCore.registerExtensions([AdjustAdobeExtension.self]) {
25
         MobileCore.configureWith(appId: "{your_adobe_app_id}")
26
         if appState != .background {
27
               MobileCore.lifecycleStart(additionalContextData: nil)
28
         }
29
      }
30
      return true
31
   }
32

33
    func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
34
        if let deeplink = ADJDeeplink(deeplink: url) {
35
            Adjust.processDeeplink(deeplink)
36
        }
37
        return true
38
    }
39

40
    func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
41
        if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
42
            if let incomingUrl = userActivity.webpageUrl {
43
                if let deeplink = ADJDeeplink(deeplink: incomingUrl) {
44
                    Adjust.processDeeplink(deeplink)
45
                }
46
            }
47
        }
48
        return true
49
    }
50
}

1
#import "AppDelegate.h"
2
@import AEPCore;
3
@import AEPServices;
4
#import <AdjustAdobeExtension/AdjustAdobeExtension.h>
5

6
@implementation AppDelegate
7

8
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
9
    [AEPMobileCore setLogLevel: AEPLogLevelTrace];
10
    const UIApplicationState appState = application.applicationState;
11

12
    AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
13
    [config setDeferredDeeplinkReceivedBlock:^BOOL(NSURL * _Nullable deeplink) {
14
        if (deeplink && [[deeplink.absoluteString lowercaseString] containsString:@"no_open"]) {
15
            return NO;
16
        }
17
        return YES;
18
    }];
19
    [AdjustAdobeExtension setConfiguration:config];
20

21
    [AEPMobileCore registerExtensions:@[AdjustAdobeExtension.class]
22
                           completion:^{
23
        [AEPMobileCore configureWithAppId: @"{your_adobe_app_id}"];
24

25
        if (appState != UIApplicationStateBackground) {
26
            [AEPMobileCore lifecycleStart:nil];
27
        }
28
    }];
29

30
    return YES;
31
}
32

33
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
34
   [Adjust processDeeplink: [[ADJDeeplink alloc] initWithDeeplink:url]];
35
   return YES;
36
}
37

38
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<uiuseractivityrestoring>> * _Nullable))restorationHandler {
39
   if ([[userActivity activityType] isEqualToString:NSUserActivityTypeBrowsingWeb]) {
40
     [Adjust proceessDeeplink:[[ADJDeeplink alloc] initWithDeeplink:[userActivity webpageURL]]];
41
   }
42
   return YES;
43
}
44
@end

您需要进行下列操作：

在 App Delegate 中找到您的 AdjustAdobeExtensionConfig 实例。在下一行中，以函数块为参数，调用 setDeferredDeeplinkReceivedBlock 方法。该函数块会以参数形式接收深度链接。

Swift
Objective-C

if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
    config.setDeferredDeeplinkReceivedBlock { (deeplink: URL?) -> Bool in }
    AdjustAdobeExtension.setConfiguration(config)
}

AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
[config setDeferredDeeplinkReceivedBlock:^BOOL(NSURL * _Nullable deeplink) {}];
[AdjustAdobeExtension setConfiguration:config];

在 setDeferredDeeplinkReceivedBlock 函数块中添加 if 块，以检查深度链接是否包含字符串 "no_open"。如果包含，则返回 false。

Swift
Objective-C

if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
    config.setDeferredDeeplinkReceivedBlock { (deeplink: URL?) -> Bool in
        if let deeplinkString = deeplink?.absoluteString.lowercased(),
        deeplinkString.contains("no_open") {
            return false
        }
    }
    AdjustAdobeExtension.setConfiguration(config)
}

AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
[config setDeferredDeeplinkReceivedBlock:^BOOL(NSURL * _Nullable deeplink) {
    if (deeplink && [[deeplink.absoluteString lowercaseString] containsString:@"no_open"]) {
        return NO;
    }
}];
[AdjustAdobeExtension setConfiguration:config];

最后返回 true，来打开所有不包含 "no_open" 的深度链接。

Swift
Objective-C

if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
    config.setDeferredDeeplinkReceivedBlock { (deeplink: URL?) -> Bool in
        if let deeplinkString = deeplink?.absoluteString.lowercased(),
        deeplinkString.contains("no_open") {
            return false
        }
        return true
    }
    AdjustAdobeExtension.setConfiguration(config)
}

AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
[config setDeferredDeeplinkReceivedBlock:^BOOL(NSURL * _Nullable deeplink) {
    if (deeplink && [[deeplink.absoluteString lowercaseString] containsString:@"no_open"]) {
        return NO;
    }
    return YES;
}];
[AdjustAdobeExtension setConfiguration:config];

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