设置延迟深度链接

延迟深度链接让未安装您应用的用户可以点击 Adjust 链接，从 App Store 安装应用，并在首次打开应用时直接跳转至其目标内容。

工作原理

以下是延迟深度链接的基本流程：

用户点击 Adjust 深度链接。
Adjust 服务器将用户重定向至 App Store。
用户安装并打开您的应用。
Adjust 服务器进行归因，并将深度链接发送至 Adjust SDK。
如果适用，您的应用将显示其初始界面，例如新客户引导界面和用户登录界面。
Adjust SDK 会向您的应用发送延迟深度链接。您的应用程序随后会处理此链接，将用户引导至相应的界面。(此步骤的具体机制取决于您的设置，如下所述。)

延迟深度链接格式

当用户点击 Adjust 品牌化链接 (brandname.go.link)，且该链接被延迟时，Adjust 的服务器会使用在 Adjust 控制面板的 iOS 平台设置中配置的应用 Scheme，将其转换为应用 Scheme 格式 (example://)，然后传递给 Adjust SDK。

因此，您应设置应用以相同方式处理 Adjust 品牌化链接和应用 Scheme 深度链接。例如，以下两个链接都应打开同一个界面：

Adjust 品牌化链接： https://brandname.go.link/summer-clothes?promo=beach
应用 Scheme 深度链接： example://summer-clothes?promo=beach

您的应用需要通过解析延迟深度链接的组件 (例如：路径、查询参数) 来加以处理，并跳转至相应的界面。

设置

设置延迟深度链接回传

遵循 AppDelegate 中的 AdjustDelegate 协议。如果您已经配置归因回传，可以跳过这一步。

Swift
Objective-C

class AppDelegate: UIResponder, UIApplicationDelegate, AdjustDelegate {
}

@interface AppDelegate : UIResponder <UIApplicationDelegate, AdjustDelegate>

在初始化 SDK 之前，在 Adjust 配置中将 AppDelegate 指定为委托。

Swift
Objective-C

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox
3
let adjustConfig = ADJConfig(
4
    appToken: yourAppToken,
5
    environment: environment)
6
adjustConfig?.delegate = self
7

8
// ...
9

10
Adjust.initSdk(adjustConfig)

1
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}"
2
                                            environment:ADJEnvironmentSandbox];
3
[adjustConfig setDelegate:self];
4

5
// ...
6

7
[Adjust initSdk:adjustConfig];

向应用委托添加 adjustDeferredDeeplinkReceived 回传方法。Adjust SDK 收到延迟深度链接后会调用该方法。

Swift
Objective-C

1
func adjustDeferredDeeplinkReceived(_ deeplink: URL?) -> Bool {
2
   // TODO: Handle deeplink
3
   // (for example, store deep link or handle it immediately)
4

5
   return false // or true based on your use case (see below)
6
}

1
- (BOOL)adjustDeferredDeeplinkReceived:(NSURL *)deeplink {
2
      // TODO: Handle deeplink
3
      // (for example, store deep link or handle it immediately)
4

5
      return NO; // or YES based on your use case (see below)
6
}

返回值选项

adjustDeferredDeeplinkReceived 的返回值决定了回传代码执行完毕后将执行什么操作：

返回 `false` (最常见)

如果希望您的应用对延迟深链接的处理时间和方式拥有完全控制权，请采用此方法。返回 false 时，Adjust SDK 不会尝试打开延迟深度链接。例如，如果您的应用需要在处理延迟深度链接之前显示并跳过初始界面 (如新客户引导或登录界面)，则此方法十分适用。

返回 `true`

如果您希望 Adjust SDK 在回传代码运行完毕后立即尝试打开延迟深度链接，请使用此方法。例如，如果您的应用没有任何初始界面，则此方法十分适用。

当 Adjust SDK 收到延迟深度链接时，将运行 Adjust 回传代码，然后 Adjust SDK 会使用该链接调用 application(_:open:options:)，iOS 随后根据您的应用设置将其路由到相应的处理程序：

应用实施	处理程序
使用 AppDelegate 的 UIKit	application(_:open:options:)
使用 SceneDelegate 的 UIKit	scene(_:openURLContexts:)
SwiftUI	.onOpenURL 修饰符

如需处理来自上述相应处理程序的深度链接，请确保您已实施直接深度链接。

完整代码示例

此示例展示了一个应用，该应用在处理延迟深度链接之前，必须首先完成其新客户引导流程。以下是示例代码的工作原理摘要。

未安装相关应用的用户点击 Adjust 深度链接后，会跳转至 App Store。
用户安装并打开应用。
Adjust SDK 向 Adjust 的服务器发送会话和归因请求。
应用开始其新客户引导流程。
Adjust 的服务器会返回包含归因数据的响应，其中包括用户点击的深度链接 (“延迟深度链接”)。
Adjust SDK 在应用中触发延迟深度链接回传 (如下面的 AppDelegate 中所示)。相关回传检查是否已完成新用户引导：
- 如果已完成新客户引导，会立即处理深度链接。
- 如果未完成新客户引导，则会存储深度链接。
完成新客户引导后，应用会检查并处理任何已存储的延迟深度链接 (如以下 ViewController 和 ContentView 示例所示)。
应用将用户引导至深度链接界面。

AppDelegate

突出显示的代码中包含 AppDelegate 的延迟深度链接更新。此示例适用于 UIKit 和 SwiftUI 示例。

Swift
Objective-C

1
import AdjustSdk
2
import UIKit
3

4
@UIApplicationMain
5
class AppDelegate: UIResponder, UIApplicationDelegate, AdjustDelegate {
6
  func application(
7
    _ application: UIApplication,
8
    didFinishLaunchingWithOptions launchOptions:
9
      [UIApplication.LaunchOptionsKey: Any]?
10
  ) -> Bool {
11
    // Configure Adjust SDK
12
    // Replace {YourAppToken} with your Adjust app token
13
    let appToken = "{YourAppToken}"
14
    var adjustConfig: ADJConfig?
15

16
    // Enable verbose logging for deep link testing
17
    #if DEBUG
18
      let environment = ADJEnvironmentSandbox
19
      adjustConfig = ADJConfig(appToken: appToken, environment: environment)
20
      adjustConfig?.logLevel = ADJLogLevel.verbose
21
    #else
22
      let environment = ADJEnvironmentProduction
23
      adjustConfig = ADJConfig(
24
        appToken: appToken, environment: environment, suppressLogLevel: true)
25
      adjustConfig?.logLevel = ADJLogLevel.suppress
26
    #endif
27

28
    // Create delegate for deferred deep linking
29
    adjustConfig?.delegate = self
30

31
    // Initialize Adjust SDK
32
    Adjust.initSdk(adjustConfig)
33

34
    return true
35
  }
36

37
  // Receive deferred deep link via AdjustDelegate method
38
  func adjustDeferredDeeplinkReceived(_ deeplink: URL?) -> Bool {
39
    // Handle failure if deeplink is nil
40
    guard let deeplink = deeplink else { return false }
41

42
    if UserDefaults.standard.bool(forKey: "hasCompletedOnboarding") {
43
      // If onboarding is complete, handle deferred deep link immediately
44

45
      // TODO: Handle the deferred deep link by parsing its components
46
      // (example: path, query parameters) and
47
      // navigating to the appropriate screen.
48
    } else {
49
      // Store deferred deep link to invoke after onboarding screens and login
50
      UserDefaults.standard.set(
51
        deeplink.absoluteString, forKey: "deferredLink")
52
    }
53

54
    // The app controls when and how it handles the deferred deep link, so return false.
55
    return false
56
  }
57
}

1
#import <AdjustSdk/AdjustSdk.h>
2
#import "AppDelegate.h"
3

4
@implementation AppDelegate
5

6
- (BOOL)application:(UIApplication *)application
7
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
8
  // Configure Adjust SDK
9
  // Replace {YourAppToken} with your Adjust app token
10
  NSString *appToken = @"{YourAppToken}";
11
  ADJConfig *adjustConfig;
12

13
// Enable verbose logging for deep linking testing
14
#ifdef DEBUG
15
  adjustConfig = [ADJConfig configWithAppToken:appToken
16
                                   environment:ADJEnvironmentSandbox];
17
  [adjustConfig setLogLevel:ADJLogLevelVerbose];
18
#else
19
  adjustConfig = [ADJConfig configWithAppToken:appToken
20
                                   environment:ADJEnvironmentProduction
21
                         allowSuppressLogLevel:YES];
22
  [adjustConfig setLogLevel:ADJLogLevelSuppress];
23
#endif
24

25
  // Create delegate for deferred deep linking
26
  adjustConfig.delegate = self;
27

28
  // Initialize Adjust SDK
29
  [Adjust initSdk:adjustConfig];
30

31
  return YES;
32
}
33

34
// Receive deferred deep link via AdjustDelegate method
35
- (BOOL)adjustDeferredDeeplinkReceived:(nullable NSURL *)deeplink {
36
  // Handle failure if deeplink is nil
37
  if (!deeplink) return NO;
38

39
  if ([[NSUserDefaults standardUserDefaults]
40
          boolForKey:@"hasCompletedOnboarding"]) {
41
    // If onboarding is complete, handle deferred deep link immediately
42

43
    // TODO: Handle the deferred deep link by parsing its components
44
    // (example: path, query parameters) and
45
    // navigating to the appropriate screen.
46
  } else {
47
    // Store deferred deep link to invoke after onboarding screens and login
48
    [[NSUserDefaults standardUserDefaults] setObject:deeplink.absoluteString
49
                                              forKey:@"deferredLink"];
50
  }
51

52
  // The app controls when and how it handles the deferred deep link, so return NO.
53
  return NO;
54
}
55

56
@end
57

58
// AppDelegate.h
59

60
@interface AppDelegate : UIResponder <UIApplicationDelegate, AdjustDelegate>
61
@end

1
import AdjustSdk
2
import UIKit
3

4
class ViewController: UIViewController {
5
  var hasCompletedOnboarding: Bool {
6
    get {
7
      UserDefaults.standard.bool(forKey: "hasCompletedOnboarding")
8
    }
9
    set {
10
      UserDefaults.standard.set(newValue, forKey: "hasCompletedOnboarding")
11
    }
12
  }
13

14
  override func viewDidAppear(_ animated: Bool) {
15
    super.viewDidAppear(animated)
16

17
    // Check if onboarding has been completed
18
    if hasCompletedOnboarding {
19
      // Show main content
20
      return
21
    }
22

23
    // Show onboarding screens and login prompt
24

25
    // After onboarding, set hasCompletedOnboarding to true
26
    hasCompletedOnboarding = true
27

28
    // Show main content
29

30
    // Check for deferredLink received before or during onboarding
31
    if let deferredLink = UserDefaults.standard.string(forKey: "deferredLink") {
32
      // Remove stored deferred deep link to avoid handling again later
33
      UserDefaults.standard.removeObject(forKey: "deferredLink")
34

35
      // TODO: Handle deferredLink by parsing its components
36
      // (example: path, query parameters) and
37
      // navigating to the appropriate screen.
38
    }
39
  }
40
}

1
#import <AdjustSdk/AdjustSdk.h>
2
#import "ViewController.h"
3

4
@implementation ViewController
5

6
- (BOOL)hasCompletedOnboarding {
7
  return [[NSUserDefaults standardUserDefaults]
8
      boolForKey:@"hasCompletedOnboarding"];
9
}
10

11
- (void)setHasCompletedOnboarding:(BOOL)hasCompletedOnboarding {
12
  [[NSUserDefaults standardUserDefaults] setBool:hasCompletedOnboarding
13
                                          forKey:@"hasCompletedOnboarding"];
14
}
15

16
- (void)viewDidAppear:(BOOL)animated {
17
  [super viewDidAppear:animated];
18

19
  // Check if onboarding has been completed
20
  if (self.hasCompletedOnboarding) {
21
    // Show main content
22
    return;
23
  }
24

25
  // Show onboarding screens and login prompt
26

27
  // After onboarding, set hasCompletedOnboarding to YES
28
  self.hasCompletedOnboarding = YES;
29

30
  // Show main content
31

32
  // Check for deferred deep link received before or during onboarding
33
  NSString *deferredLink =
34
      [[NSUserDefaults standardUserDefaults] stringForKey:@"deferredLink"];
35
  if (deferredLink) {
36
    // Remove stored deferred deep link to avoid handling again later
37
    [[NSUserDefaults standardUserDefaults] removeObjectForKey:@"deferredLink"];
38

39
    // TODO: Handle deferredLink by parsing its components
40
    // (example: path, query parameters) and
41
    // navigating to the appropriate screen.
42
  }
43
}
44

45
@end

SwiftUI

Swift

1
import AdjustSdk
2
import SwiftUI
3

4
struct ContentView: View {
5
  var body: some View {
6
    NavigationStack {
7
      VStack {
8
        // Check if onboarding has been completed
9
        if !UserDefaults.standard.bool(forKey: "hasCompletedOnboarding") {
10
          // Show onboarding screens and login prompt
11

12
          // After onboarding, set hasCompletedOnboarding to true
13
          UserDefaults.standard.set(true, forKey: "hasCompletedOnboarding")
14

15
          // Show main content
16

17
          // Check for deep link received before or during onboarding
18
          if let deferredLink = UserDefaults.standard.string(
19
            forKey: "deferredLink")
20
          {
21
            // Remove stored deferred deep link to avoid handling again later
22
            UserDefaults.standard.removeObject(forKey: "deferredLink")
23

24
            // TODO: Handle deferredLink by parsing its components
25
            // (example: path, query parameters) and
26
            // navigating to the appropriate screen.
27
          }
28
        } else {
29
          // Show main content
30
        }
31
      }
32
    }
33
  }
34
}