设置直接深度链接

当已安装应用的用户点击 Adjust 链接时，直接深度链接可确保将用户直接转到应用内的特定内容。

设置

iOS 提供了多种接收直接深度链接的方法，具体取决于应用的实施方式。在这些方法中，您将使用下列其中一种方法将深度链接传递给 Adjust SDK：

处理并解析深度链接 (推荐)

使用processAndResolve(_:withCompletionHandler:)方法，该方法会执行以下操作：

记录深度链接点击的归因
将品牌化短链接解析为其等效的品牌化长链接
按原样透传所有其他链接

然后，应用可以通过解析已解析的链接并跳转至相应的界面来处理该链接。可以使用此方法处理所有深度链接，包括 Adjust 品牌化长链接、其他通用链接以及应用 Scheme 深度链接。

+ (void)processAndResolveDeeplink:(nonnull ADJDeeplink *)deeplink
            withCompletionHandler:(nonnull ADJResolvedDeeplinkBlock)completion;

处理深度链接 (旧版)

Adjust SDK 提供了processDeeplink(_:)方法，可在不使用品牌化短链接的情况下，记录深度链接点击的归因信息。

+ (void)processDeeplink:(ADJDeeplink *)deeplink;

不过， processAndResolve(_:withCompletionHandler:)方法取代了此旧方法的功能，因此建议使用此较新的方法。

重要实施说明

请遵循以下深度链接处理最佳实践：

链接处理要求
- 您的应用应以相同的方式处理 Adjust 品牌化链接 (brandname.go.link) 和通用链接 (example.com)。如果应用使用域名许可名单，请确保将 Adjust 品牌化域名包括在内。例如，以下两个链接都应跳转至同一界面：
  - Adjust 品牌化链接： https://brandname.go.link/summer-clothes?promo=beach
  - 通用链接： https://example.com/summer-clothes?promo=beach
- 您的应用应以相同的方式处理 Adjust 品牌化链接和应用 Scheme 深度链接。在 iOS 不支持通用链接的情况下，Adjust 会将其转换为等效的应用 Scheme 格式。例如，以下两个链接都应跳转至同一界面：
  - Adjust 品牌化链接： https://brandname.go.link/summer-clothes?promo=beach
  - 应用 Scheme 深度链接： example://summer-clothes?promo=beach
应用状态注意事项
- 确保应用在下列任何状态中打开链接时都能正确进行处理：“未运行”、后台或前台 (如果适用)。
- 如果无法立即处理深度链接 (例如用户尚未完成身份验证)，可以考虑将其存储，并在应用准备好进行导航时再处理。
应用内导航
- 当应用尝试通过调用 UIApplication.open(_:options:completionHandler:) 或 SwiftUI 的 openURL 打开其自身的通用链接时，iOS 会在 Safari 中而不是在应用中打开这些链接。只能向其传递应用 Scheme 深度链接，才能使用这些方法进行内部导航。此外，还可以在应用内嵌入通用链接，并使用深度链接处理逻辑解析这些链接，以便跳转至相应的界面。

实施

使用与应用结构相符的实施方式：

使用 AppDelegate 生命周期的 UIKit 应用
使用 SceneDelegate 生命周期的 UIKit 应用
使用 AppDelegate 生命周期的 SwiftUI 应用
使用 SceneDelegate 生命周期的 SwiftUI 应用

使用 AppDelegate 生命周期的 UIKit 应用

更新 AppDelegate 以实施 iOS 直接深度链接方法。

Swift
Objective-C

1
// Receive universal link when app is installed
2
// and link opens app from "not running"
3
// or background state.
4
func application(
5
  _ application: UIApplication,
6
  continue userActivity: NSUserActivity,
7
  restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
8
) -> Bool {
9
  guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
10
    let incomingLink = userActivity.webpageURL
11
  else { return true }
12

13
  // Create deep link object
14
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
15

16
  // Send deep link to Adjust's servers for attribution.
17
  // If short branded link, receive long link.
18
  // Otherwise, receive original link.
19
  Adjust.processAndResolve(deeplink) { resolvedLink in
20
    // Handle failure if resolvedLink is nil
21
    guard let resolvedLink = resolvedLink else { return }
22

23
    // TODO: Handle resolvedLink by parsing its components
24
    // (example: path, query parameters) and
25
    // navigating to the appropriate screen.
26
  }
27

28
  return true
29
}
30

31
// Receive app scheme deep link when app is installed
32
// and link opens app from "not running",
33
// background, or foreground state.
34
func application(
35
  _ application: UIApplication,
36
  open incomingLink: URL,
37
  options: [UIApplication.OpenURLOptionsKey: Any] = [:]
38
) -> Bool {
39
  // Create deep link object
40
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
41

42
  // Send deep link to Adjust's servers for attribution.
43
  // If short branded link, receive long link.
44
  // Otherwise, receive original link.
45
  Adjust.processAndResolve(deeplink) { resolvedLink in
46
    // Handle failure if resolvedLink is nil
47
    guard let resolvedLink = resolvedLink else { return }
48

49
    // TODO: Handle resolvedLink by parsing its components
50
    // (example: path, query parameters) and
51
    // navigating to the appropriate screen.
52
  }
53
  return true
54
}

1
// Receive universal link when app is installed
2
// and link opens app from "not running"
3
// or background state.
4
- (BOOL)application:(UIApplication *)application
5
    continueUserActivity:(NSUserActivity *)userActivity
6
      restorationHandler:
7
          (void (^)(NSArray<id<uiuseractivityrestoring>> *_Nullable))
8
              restorationHandler {
9
  // Check if it's a web browsing activity
10
  if (![userActivity.activityType
11
          isEqualToString:NSUserActivityTypeBrowsingWeb])
12
    return YES;
13

14
  // Check if there's a valid URL
15
  NSURL *incomingLink = userActivity.webpageURL;
16
  if (!incomingLink) return YES;
17

18
  // Create deep link object
19
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
20
  if (!deeplink) return YES;
21

22
  // Send deep link to Adjust's servers for attribution.
23
  // If short branded link, receive long link.
24
  // Otherwise, receive original link.
25
  [Adjust processAndResolveDeeplink:deeplink
26
              withCompletionHandler:^(NSString *resolvedLink) {
27
                // Handle failure if resolvedLink is nil
28
                if (!resolvedLink) return;
29

30
                // TODO: Handle resolvedLink by parsing its components
31
                // (example: path, query parameters) and
32
                // navigating to the appropriate screen.
33
              }];
34

35
  return YES;
36
}
37

38
// Receive app scheme deep link when app is installed
39
// and link opens app from "not running",
40
// background, or foreground state.
41
- (BOOL)application:(UIApplication *)application
42
            openURL:(NSURL *)incomingLink
43
            options:
44
                (NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
45
  // Create deep link object
46
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
47
  if (!deeplink) return YES;
48

49
  // Send deep link to Adjust's servers for attribution.
50
  // If short branded link, receive long link.
51
  // Otherwise, receive original link.
52
  [Adjust processAndResolveDeeplink:deeplink
53
              withCompletionHandler:^(NSString *resolvedLink) {
54
                // Handle failure if resolvedLink is nil
55
                if (!resolvedLink) return;
56

57
                // TODO: Handle resolvedLink by parsing its components
58
                // (example: path, query parameters) and
59
                // navigating to the appropriate screen.
60
              }];
61
  return YES;
62
}

使用 SceneDelegate 生命周期的 UIKit 应用

更新 SceneDelegate 以实施 iOS 直接深度链接方法。

Swift
Objective-C

1
// Receive universal link or app scheme deep link when app is installed
2
// and link opens app from "not running" state.
3
func scene(
4
  _ scene: UIScene,
5
  willConnectTo session: UISceneSession,
6
  options connectionOptions: UIScene.ConnectionOptions
7
) {
8
  // Receive incoming universal link
9
  if let userActivity = connectionOptions.userActivities.first,
10
    userActivity.activityType == NSUserActivityTypeBrowsingWeb,
11
    let incomingLink = userActivity.webpageURL
12
  {
13
    // Create deep link object
14
    guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
15

16
    // Send deep link to Adjust's servers for attribution.
17
    // If short branded link, receive long link.
18
    // Otherwise, receive original link.
19
    Adjust.processAndResolve(deeplink) { resolvedLink in
20
      // Handle failure if resolvedLink is nil
21
      guard let resolvedLink = resolvedLink else { return }
22

23
      // TODO: Handle resolvedLink by parsing its components
24
      // (example: path, query parameters) and
25
      // navigating to the appropriate screen.
26
    }
27
    return
28
  }
29

30
  // Receive incoming app scheme deep link
31
  guard let incomingLink = connectionOptions.urlContexts.first?.url else { return }
32

33
  // Create deep link object
34
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
35

36
  // Send deep link to Adjust's servers for attribution.
37
  // If short branded link, receive long link.
38
  // Otherwise, receive original link.
39
  Adjust.processAndResolve(deeplink) { resolvedLink in
40
    // Handle failure if resolvedLink is nil
41
    guard let resolvedLink = resolvedLink else { return }
42

43
    // TODO: Handle resolvedLink by parsing its components
44
    // (example: path, query parameters) and
45
    // navigating to the appropriate screen.
46
  }
47
}
48

49
// Receive universal link when app is installed
50
// and link opens app from background state.
51
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
52
  guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
53
    let incomingLink = userActivity.webpageURL
54
  else { return }
55

56
  // Create deep link object
57
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
58

59
  // Send deep link to Adjust's servers for attribution.
60
  // If short branded link, receive long link.
61
  // Otherwise, receive original link.
62
  Adjust.processAndResolve(deeplink) { resolvedLink in
63
    // Handle failure if resolvedLink is nil
64
    guard let resolvedLink = resolvedLink else { return }
65

66
    // TODO: Handle resolvedLink by parsing its components
67
    // (example: path, query parameters) and
68
    // navigating to the appropriate screen.
69
  }
70
}
71

72
// Receive app scheme deep link when app is installed
73
// and link opens app from background
74
// or foreground state.
75
func scene(
76
  _ scene: UIScene,
77
  openURLContexts URLContexts: Set<uiopenurlcontext>
78
) {
79
  guard let incomingLink = URLContexts.first?.url else { return }
80

81
  // Create deep link object
82
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
83

84
  // Send deep link to Adjust's servers for attribution.
85
  // If short branded link, receive long link.
86
  // Otherwise, receive original link.
87
  Adjust.processAndResolve(deeplink) { resolvedLink in
88
    // Handle failure if resolvedLink is nil
89
    guard let resolvedLink = resolvedLink else { return }
90

91
    // TODO: Handle resolvedLink by parsing its components
92
    // (example: path, query parameters) and
93
    // navigating to the appropriate screen.
94
  }
95
}

1
// Receive universal link or app scheme deep link when app is installed
2
// and link opens app from "not running" state.
3
- (void)scene:(UIScene *)scene
4
    willConnectToSession:(UISceneSession *)session
5
                 options:(UISceneConnectionOptions *)connectionOptions {
6
  // Receive universal link
7
  if (connectionOptions.userActivities.count > 0) {
8
    NSUserActivity *userActivity =
9
        connectionOptions.userActivities.allObjects.firstObject;
10
    if ([userActivity.activityType
11
            isEqualToString:NSUserActivityTypeBrowsingWeb] &&
12
        userActivity.webpageURL) {
13
      NSURL *incomingLink = userActivity.webpageURL;
14

15
      // Create deep link object
16
      ADJDeeplink *deeplink =
17
          [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
18
      if (!deeplink) return;
19

20
      // Send deep link to Adjust's servers for attribution.
21
      // If short branded link, receive long link.
22
      // Otherwise, receive original link.
23
      [Adjust processAndResolveDeeplink:deeplink
24
                  withCompletionHandler:^(NSString *resolvedLink) {
25
                    // Handle failure if resolvedLink is nil
26
                    if (!resolvedLink) return;
27

28
                    // TODO: Handle resolvedLink by parsing its components
29
                    // (example: path, query parameters) and
30
                    // navigating to the appropriate screen.
31
                  }];
32
      return;
33
    }
34
  }
35

36
  // Receive app scheme deep link
37
  if (connectionOptions.URLContexts.count == 0) return;
38

39
  UIOpenURLContext *urlContext =
40
      connectionOptions.URLContexts.allObjects.firstObject;
41
  NSURL *incomingLink = urlContext.URL;
42

43
  // Create deep link object
44
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
45
  if (!deeplink) return;
46

47
  // Send deep link to Adjust's servers for attribution.
48
  // If short branded link, receive long link.
49
  // Otherwise, receive original link.
50
  [Adjust processAndResolveDeeplink:deeplink
51
              withCompletionHandler:^(NSString *resolvedLink) {
52
                // Handle failure if resolvedLink is nil
53
                if (!resolvedLink) return;
54

55
                // TODO: Handle resolvedLink by parsing its components
56
                // (example: path, query parameters) and
57
                // navigating to the appropriate screen.
58
              }];
59
}
60

61
// Receive universal link when app is installed
62
// and link opens app from background state.
63
- (void)scene:(UIScene *)scene
64
    continueUserActivity:(NSUserActivity *)userActivity {
65
  // Check if it's a web browsing activity
66
  if (![userActivity.activityType
67
          isEqualToString:NSUserActivityTypeBrowsingWeb])
68
    return;
69

70
  // Check if there's a valid URL
71
  NSURL *incomingLink = userActivity.webpageURL;
72
  if (!incomingLink) return;
73

74
  // Create deep link object
75
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
76
  if (!deeplink) return;
77

78
  // Send deep link to Adjust's servers for attribution.
79
  // If short branded link, receive long link.
80
  // Otherwise, receive original link.
81
  [Adjust processAndResolveDeeplink:deeplink
82
              withCompletionHandler:^(NSString *resolvedLink) {
83
                // Handle failure if resolvedLink is nil
84
                if (!resolvedLink) return;
85

86
                // TODO: Handle resolvedLink by parsing its components
87
                // (example: path, query parameters) and
88
                // navigating to the appropriate screen.
89
              }];
90
}
91

92
// Receive app scheme deep link when app is installed
93
// and link opens app from background
94
// or foreground state.
95
- (void)scene:(UIScene *)scene
96
    openURLContexts:(NSSet<uiopenurlcontext *> *)URLContexts {
97
  // Check if we have any URL contexts
98
  UIOpenURLContext *urlContext = URLContexts.allObjects.firstObject;
99
  if (!urlContext) return;
100

101
  // Check if the URL is valid
102
  NSURL *incomingLink = urlContext.URL;
103
  if (!incomingLink) return;
104

105
  // Create deep link object
106
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
107
  if (!deeplink) return;
108

109
  // Send deep link to Adjust's servers for attribution.
110
  // If short branded link, receive long link.
111
  // Otherwise, receive original link.
112
  [Adjust processAndResolveDeeplink:deeplink
113
              withCompletionHandler:^(NSString *resolvedLink) {
114
                // Handle failure if resolvedLink is nil
115
                if (!resolvedLink) return;
116

117
                // TODO: Handle resolvedLink by parsing its components
118
                // (example: path, query parameters) and
119
                // navigating to the appropriate screen.
120
              }];
121
}

使用 AppDelegate 生命周期的 SwiftUI 应用

如果尚未在项目的主目录中创建 AppDelegate.swift 文件，请立即执行此操作，并在主应用文件中加以引用，如以下 App.swift 示例文件所示。这是处理应用生命周期事件和 Adjust SDK 集成的必要步骤。此外，实施 onOpenURL SwiftUI 修饰符，该修饰符在应用安装时接收通用链接和应用 Scheme 深度链接。

Swift

1
import AdjustSdk
2
import SwiftUI
3

4
@main
5
struct MyApp: App {
6
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
7

8
  var body: some Scene {
9
    WindowGroup {
10
      ContentView()
11
        // Receive universal link or app scheme deep link when app is installed
12
        // and link opens app from "not running",
13
        // background, or foreground state.
14
        .onOpenURL { incomingLink in
15
          // Create deep link object
16
          guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
17

18
          // Send deep link to Adjust's servers for attribution.
19
          // If short branded link, receive long link.
20
          // Otherwise, receive original link.
21
          Adjust.processAndResolve(deeplink) { resolvedLink in
22
            // Handle failure if resolvedLink is nil
23
            guard let resolvedLink = resolvedLink else { return }
24

25
            // TODO: Handle resolvedLink by parsing its components
26
            // (example: path, query parameters) and
27
            // navigating to the appropriate screen.
28
          }
29
        }
30
    }
31
  }
32
}

使用 SceneDelegate 生命周期的 SwiftUI 应用

按照“使用 AppDelegate 生命周期的 SwiftUI 应用”栏中的说明进行操作。安装应用后，onOpenURL SwiftUI 修饰符会接收通用链接和应用 Scheme 深度链接，并且该链接会在后台或前台状态中打开相关应用。

此外，从“使用 SceneDelegate 生命周期的 UIKit 应用”栏实施scene(_:willConnectTo:options:)方法。此方法会在安装应用后接收通用链接和应用 Scheme 深度链接，并且该链接会在“未运行”状态中打开相关应用。