设置直接深度链接

在 Adjust 控制面板中完成设置后，您就可以在应用中配置深度链接。如果用户的设备上已经安装了应用，就会发生 直接深度链接 。该链接会将用户转到应用内的特定界面。

要启用深度链接，请进行下列操作：

在 Adjust 控制面板的 AppView 中为您的 iOS 和安卓应用设置相同的品牌化域名。
为您的应用启用 Associated Domain (关联域)
在 Xcode 中配置您的深度链接

启用 Associated Domain

开始设置时，请在 Apple Developer 账户中启用 Associated Domain (关联域)，这样，您就能在应用中设置通用链接域了。为此，请按照以下步骤操作：

登录 Apple Developer 账户。
从左侧菜单中选择 Certificates, IDs & Profiles 。
从左侧菜单中选择 Identifiers 。
找到并选中您的应用，打开编辑界面。
确保勾选 Capabilities 下的 Associated Domains 。
点击保存，保存变更。

在 XCode 中设置深度链接

按照下方步骤操作，在您的 Xcode 项目中添加深度链接配置。

Adjust 通用链接域名

使用 XCode 打开您的应用项目。
从左侧菜单中选择您的项目。
在 Targets 中选择您的应用。
从顶部菜单中选择 Signing & Capabilities 。
确保在下方子菜单中选定 All 。
选择添加选项 ( + 图标) 添加功能。
选择 Associated Domains 。
填写带有前缀的 Adjust 通用链接域名 applinks:
- example.adj.st 域使用示例：applinks:example.adj.st。
输入您在 Adjust 中为应用设置品牌化域名时设置的品牌化链接域名。
- brandedDomain.go.link 域使用示例：brandedDomain.go.link。

如果您已经在使用xxx.adj.st作为通用链接域名，请不要将其移除。请将xxx.adj.st和brandedDomain.go.link继续保持为关联域名。

自定义 URL 方案

使用 XCode 打开您的应用项目。
从左侧菜单中选择您的项目。
在 Targets 中选择您的应用。
从顶部菜单中选择 Info 。
展开 URL Types 板块。
选择添加选项 ( + 图标) 添加 URL 类别。
输入下列信息，以创建 URL 方案：
- 标识符 ： $(PRODUCT_BUNDLE_IDENTIFIER)
- URL 方案 ：您的自定义 URL 方案。该方案必须是唯一的。请勿使用受保护的方案，如 http，https 或 mailto。
- 角色：编辑员

该方案适用于您的生产版本和调试版本。

修改 iOS 应用

要设置不同的深度链接场景，您需要先更新 iOS 应用。具体应用更新方式取决于您的应用是否使用场景。

不使用场景的应用

如果您的应用不使用场景，请在应用委托中更新方法。

通用链接

请在应用委托中更新 application(_:continue:restorationHandler:) 方法，调用 Adjust SDK 中的下列方法：

ADJLinkResolution.resolveLink: 仅在营销团队需要使用 Adjust 链接解析解决方案时调用。如果深度链接使用的域与resolveUrlSuffixArray中的某一元素相匹配，那么方法将会尝试解析深度链接，并返回已解析的链接；如果没有匹配，那么方法就会通过最初的深度链接，您可以将所有深度链接传送至该方法。
Adjust.appWillOpen 调用该方法，向 Adjust 服务器发送深度链接，用于记录信息。Adjust 和非 Adjust 深度链接均可以发送给该方法。Adjust 服务器会忽略不包含 Adjust 参数的所有深度链接。

无论用户是否已经关闭应用，或应用是否在后台运行，只要用户点击您的通用链接，iOS 就会打开您的应用，将深度链接传送至 application(_:continue:restorationHandler:)。

Swift
Objective-C

1
func application(
2
    _ application: UIApplication,
3
    continue userActivity: NSUserActivity,
4
    restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void)
5
    -> Bool {
6

7
    if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
8
        let incomingURL = userActivity.webpageURL
9

10
        // call the below method to resolve deep link
11
        ADJLinkResolution.resolveLink(
12
        withUrl: incomingURL,
13
        resolveUrlSuffixArray: ["email.example.com", "short.example.com"],
14
        callback: { resolvedURL in
15
            // add your code below to handle deep link
16
            // (for example, open deep link content)
17
            // resolvedURL object contains the deep link
18

19

20
            // call the below method to send deep link to Adjust's servers
21
            Adjust.appWillOpen(resolvedURL)
22
        })
23
      } else {
24
          return false
25
      }
26

27
      return true
28
}

1
- (BOOL)application:(UIApplication *)application
2
    continueUserActivity:(NSUserActivity *)userActivity
3
    restorationHandler:
4
    (void (^)(NSArray *restorableObjects))restorationHandler {
5

6
    if ([[userActivity activityType]
7
        isEqualToString:NSUserActivityTypeBrowsingWeb]) {
8
        NSURL *incomingURL = [userActivity webpageURL];
9

10
        // call the below method to resolve deep link
11
        [ADJLinkResolution
12
        resolveLinkWithUrl:incomingURL
13
        resolveUrlSuffixArray:@[
14
        @"email.example.com", @"short.example.com"
15
        ]
16
        callback:^(NSURL* _Nullable resolvedURL) {
17
            // add your code below to handle deep link
18
            // (for example, open deep link content)
19
            // resolvedURL object contains the deep link
20

21

22
            // call the below method to send deep link to Adjust's servers
23
            [Adjust appWillOpenUrl:resolvedURL];
24
        }];
25
    } else {
26
        return NO;
27
    }
28

29
    return YES;
30
}

自定义 URL 方案

如果营销团队要求您设置自定义 URL 方案深度链接，请更新应用委托中的 application(_:open:options:) 方法，在 Adjust SDK 中调用 Adjust.appWillOpen 方法。该方法会将深度链接发送至 Adjust 后台用于记录。Adjust 和非 Adjust 深度链接均可以发送给该方法。Adjust 会忽略不包含 Adjust 参数的所有深度链接。

无论用户是否已经关闭应用，或应用是否在后台运行，只要用户点击自定义 URL 方案深度链接，iOS 就会打开您的应用，将深度链接传送至 application(_:open:options:)。

Swift
Objective-C

1
func application(
2
    _ app: UIApplication,
3
    open incomingURL: URL,
4
    options: [UIApplication.OpenURLOptionsKey: Any] = [:]
5
    ) -> Bool {
6

7
    // add your code below to handle deep link
8
    // (for example, open deep link content)
9
    // incomingURL object contains the deep link
10

11

12
    // call the below method to send deep link to Adjust's servers
13
    Adjust.appWillOpen(incomingURL)
14

15
    return true
16
}

1
- (BOOL)application:(UIApplication *)app
2
    openURL:(NSURL *)incomingURL
3
    options:(NSDictionary *)options {
4

5
    // add your code below to handle deep link
6
    // (for example, open deep link content)
7
    // incomingURL object contains the deep link
8

9

10
    // call the below method to send deep link to Adjust's servers
11
    [Adjust appWillOpenUrl:incomingURL];
12

13
    return YES;
14
}

使用场景的应用

如果您的应用使用场景，请在场景委托中更新方法。

通用链接

在 scene delegate (场景委托) 中更新 scene(_:willConnectTo:options:) 方法。如果用户在已关闭应用的前提下点击通用链接，那么 iOS 就会打开应用，将深度链接传递给该方法。
在 scene delegate (场景委托) 中更新 scene(_:continue:) 方法。如果用户在应用后台运行的前提下点击通用链接，那么 iOS 就会打开应用，将深度链接传递给该方法。

上述方法会调用 Adjust SDK 中的下列方法：

ADJLinkResolution.resolveLink: 仅在营销团队需要使用 Adjust 链接解析解决方案时调用。如果深度链接使用的域与resolveUrlSuffixArray中的某一元素相匹配，那么方法将会尝试解析深度链接，并返回已解析的链接；如果没有匹配，那么方法就会通过最初的深度链接，您可以将所有深度链接传送至该方法。
Adjust.appWillOpen - 调用该方法，向 Adjust 服务器发送深度链接，用于记录信息。Adjust 和非 Adjust 深度链接均可以发送给该方法。Adjust 会忽略不包含 Adjust 参数的所有深度链接。

Swift
Objective-C

1
func scene(
2
    _ scene: UIScene,
3
    willConnectTo session: UISceneSession,
4
    options connectionOptions: UIScene.ConnectionOptions
5
    ) {
6

7
    guard let userActivity = connectionOptions.userActivities.first,
8
      userActivity.activityType == NSUserActivityTypeBrowsingWeb,
9
      let incomingURL = userActivity.webpageURL
10
    else { return }
11

12
    // call the below method to resolve deep link
13
    ADJLinkResolution.resolveLink(
14
      withUrl: incomingURL,
15
      resolveUrlSuffixArray: ["email.example.com", "short.example.com"],
16
      callback: { resolvedURL in
17
        // add your code below to handle deep link
18
        // (for example, open deep link content)
19
        // resolvedURL object contains the deep link
20

21

22
        // call the below method to send deep link to Adjust's servers
23
        Adjust.appWillOpen(resolvedURL)
24
      })
25
}
26

27
func scene(
28
    _ scene: UIScene,
29
    continue userActivity: NSUserActivity) {
30

31
    if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
32
        let incomingURL = userActivity.webpageURL
33

34
        // call the below method to resolve deep link
35
        ADJLinkResolution.resolveLink(
36
        withUrl: incomingURL,
37
        resolveUrlSuffixArray: ["email.example.com", "short.example.com"],
38
        callback: { resolvedURL in
39
            // add your code below to handle deep link
40
            // (for example, open deep link content)
41
            // resolvedURL object contains the deep link
42

43

44
            // call the below method to send deep link to Adjust's servers
45
            Adjust.appWillOpen(resolvedURL)
46
        })
47
    }
48
}

1
- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session
2
    options:(UISceneConnectionOptions *)connectionOptions {
3

4
    NSUserActivity* userActivity =
5
    [[[connectionOptions userActivities] allObjects] firstObject];
6

7
    if ([[userActivity activityType]
8
        isEqualToString:NSUserActivityTypeBrowsingWeb]) {
9
        NSURL *incomingURL = [userActivity webpageURL];
10

11
        // call the below method to resolve deep link
12
        [ADJLinkResolution
13
        resolveLinkWithUrl:incomingURL
14
        resolveUrlSuffixArray:@[
15
        @"email.example.com", @"short.example.com"
16
        ]
17
        callback:^(NSURL* _Nullable resolvedURL) {
18
            // add your code below to handle deep link
19
            // (for example, open deep link content)
20
            // resolvedURL object contains the deep link
21

22

23
            // call the below method to send deep link to Adjust's servers
24
            [Adjust appWillOpenUrl:resolvedURL];
25
        }];
26
    }
27
}
28

29
- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity{
30
    if ([[userActivity activityType]
31
        isEqualToString:NSUserActivityTypeBrowsingWeb]) {
32
        NSURL *incomingURL = [userActivity webpageURL];
33

34
        // call the below method to resolve deep link
35
        [ADJLinkResolution
36
        resolveLinkWithUrl:incomingURL
37
        resolveUrlSuffixArray:@[
38
        @"email.example.com", @"short.example.com"
39
        ]
40
        callback:^(NSURL* _Nullable resolvedURL) {
41
            // add your code below to handle deep link
42
            // (for example, open deep link content)
43
            // resolvedURL object contains the deep link
44

45

46
            // call the below method to send deep link to Adjust's servers
47
            [Adjust appWillOpenUrl:resolvedURL];
48
        }];
49
    }
50
}

自定义 URL 方案

在 scene delegate (场景委托) 中更新 scene(_:willConnectTo:options:) 方法。如果用户在已关闭应用的前提下点击自定义 URL 方案深度链接，那么 iOS 就会打开应用，将深度链接传递给该方法。
在 scene delegate (场景委托) 中更新 scene(_:openURLContexts:) 方法。如果用户在应用后台运行的前提下点击自定义 URL 方案深度链接，那么 iOS 就会打开应用，将深度链接传递给该方法。

这些方法会在 Adjust SDK 中调用 Adjust.appWillOpen 方法。该方法会将深度链接发送至 Adjust 后台用于记录。Adjust 和非 Adjust 深度链接均可以发送给该方法。Adjust 会忽略不包含 Adjust 参数的所有深度链接。

Swift
Objective-C

1
func scene(
2
    _ scene: UIScene,
3
    openURLContexts URLContexts: Set<uiopenurlcontext>
4
    ) {
5

6
    guard let incomingURL = URLContexts.first?.url else {
7
        return
8
    }
9

10
    // add your code below to handle deep link
11
    // (for example, open deep link content)
12
    // incomingURL object contains the deep link
13

14

15
    // call the below method to send deep link to Adjust's servers
16
    Adjust.appWillOpen(incomingURL)
17
}

1
- (void)scene:(UIScene *)scene
2
    openURLContexts:(nonnull NSSet<uiopenurlcontext *> *)URLContexts {
3

4
    NSURL *incomingURL = [[URLContexts allObjects] firstObject].URL;
5

6
    if (incomingURL) {
7
        // add your code below to handle deep link
8
        // (for example, open deep link content)
9
        // incomingURL object contains the deep link
10

11

12
        // call the below method to send deep link to Adjust's servers
13
        [Adjust appWillOpenUrl:incomingURL];
14
    }
15
}