设置直接深度链接

在 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.processDeeplink 调用该方法，向 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
        if let incomingURL = userActivity.webpageURL {
9
            // call the below method to resolve deep link
10
            ADJLinkResolution.resolveLink(
11
                with: incomingURL,
12
                resolveUrlSuffixArray: ["email.example.com", "short.example.com"],
13
                callback: { resolvedURL in
14
                    // add your code below to handle deep link
15
                    // (for example, open deep link content)
16
                    // resolvedURL object contains the deep link
17
                    if let resolvedDeeplink = resolvedURL {
18
                        // call the below method to send deep link to Adjust's servers
19
                        if let deeplink = ADJDeeplink(deeplink: resolvedDeeplink) {
20
                            Adjust.processDeeplink(deeplink)
21
                        }
22
                    }
23
                })
24
        }
25
      } else {
26
          return false
27
      }
28

29
      return true
30
}

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
            ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:resolvedURL];
24
            [Adjust processDeeplink:deeplink];
25
        }];
26
    } else {
27
        return NO;
28
    }
29

30
    return YES;
31
}

自定义 URL 方案

如果营销团队要求您设置自定义 URL 方案深度链接，请更新应用委托中的 application(_:open:options:) 方法，在 Adjust SDK 中调用 Adjust.processDeeplink 方法。该方法会将深度链接发送至 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
    if let deeplink = ADJDeeplink(deeplink: incomingURL) {
14
        Adjust.processDeeplink(deeplink)
15
    }
16
    return true
17
}

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 processDeeplink:[[ADJDeeplink alloc] initWithDeeplink:incomingURL]];
12

13
    return YES;
14
}

使用场景的应用

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

通用链接

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

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

ADJLinkResolution.resolveLink: 仅在营销团队需要使用 Adjust 链接解析解决方案时调用。如果深度链接使用的域与resolveUrlSuffixArray中的某一元素相匹配，那么方法将会尝试解析深度链接，并返回已解析的链接；如果没有匹配，那么方法就会通过最初的深度链接，您可以将所有深度链接传送至该方法。
Adjust.processDeeplink - 调用该方法，向 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
        if let deeplink = ADJDeeplink(deeplink: resolvedURL) {
24
            Adjust.processDeeplink(deeplink)
25
        }
26
      })
27
}
28

29
func scene(
30
    _ scene: UIScene,
31
    continue userActivity: NSUserActivity) {
32

33
    if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
34
        let incomingURL = userActivity.webpageURL
35

36
        // call the below method to resolve deep link
37
        ADJLinkResolution.resolveLink(
38
        withUrl: incomingURL,
39
        resolveUrlSuffixArray: ["email.example.com", "short.example.com"],
40
        callback: { resolvedURL in
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
            if let deeplink = ADJDeeplink(deeplink: resolvedURL) {
48
                Adjust.processDeeplink(deeplink)
49
            }
50
        })
51
    }
52
}

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
            ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:resolvedURL];
25
            [Adjust processDeeplink:deeplink];
26
        }];
27
    }
28
}
29

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

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

46

47
            // call the below method to send deep link to Adjust's servers
48
            ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:resolvedURL];
49
            [Adjust processDeeplink:deeplink];
50
        }];
51
    }
52
}

自定义 URL 方案

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

这些方法会在 Adjust SDK 中调用 Adjust.processDeeplink 方法。该方法会将深度链接发送至 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
    if let deeplink = ADJDeeplink(deeplink: incomingURL) {
17
        Adjust.processDeeplink(deeplink)
18
    }
19
}

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
        ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingURL];
14
        [Adjust processDeeplink:deeplink];
15
    }
16
}

获取最近的深度链接

+ (void)lastDeeplinkWithCompletionHandler:(nonnull ADJLastDeeplinkGetterBlock)completion;

您可以通过调用 Adjust.lastDeeplinkWithCompletionHandler: 方法，返回发送至 Adjust.processDeeplink 或 Adjust.processAndResolveDeeplink 方析的最近一个深度链接 URL。此方法会以 NSURL 的形式返回最近的深度链接。

Swift
Objective-C

1
Adjust.lastDeeplink { lastDeeplink in
2
    if let deeplink = lastDeeplink {
3
        // Handle the deeplink here
4
        print("Last deep link: \(deeplink.absoluteString)")
5
    }
6
}

1
[Adjust lastDeeplinkWithCompletionHandler:^(NSURL * _Nullable lastDeeplink) {
2
    if (lastDeeplink != nil) {
3
        // Handle the deeplink here
4
        NSLog(@"Last deep link: %@", [lastDeeplink absoluteString]);
5
    }
6
}];

处理带有 referrer 的深度链接

可选 referrer URL，用于跟踪深度链接或应用打开的来源，以优化归因或再归因和深度链接。例如，对于 SEO / 自然搜索等渠道，Adjust 链接不会直接被使用。如果客户的根域已部署通用链接，并触发了应用打开，那么对于此类渠道来说，我们可能必须通过 referrer URL 传入的信号开展用户归因或再归因。

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

5
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
6
        let url = userActivity.webpageURL else { return false }
7

8
    if let deeplink = ADJDeeplink(deeplink: url) {
9
        // If referrer URL is available, add it to the deeplink object
10
        if let referrer = URL(string: "https://example.com") {
11
            deeplink.setReferrer(referrer)
12
        }
13
        // Send deeplink and referrer to Adjust's servers
14
        Adjust.processDeeplink(deeplink)
15
        return true
16
    }
17
    return false
18
}

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

5
    if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
6
        NSURL *url = userActivity.webpageURL;
7
        if (url) {
8
            ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:url];
9
            if (deeplink) {
10
                NSURL *referrer = [NSURL URLWithString:@"https://example.com"];
11
                // If referrer URL is available, add it to the deeplink object
12
                if (referrer) {
13
                    [deeplink setReferrer:referrer];
14
                }
15
                // Send deeplink and referrer to Adjust's servers
16
                [Adjust processDeeplink:deeplink];
17
            }
18
            return YES;
19
        }
20
    }
21
    return NO;
22
}