adjust-icon

设置直接深度链接

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

要启用深度链接,请进行下列操作:

  • 为您的应用启用 Associated Domain (关联域)
  • 在 Xcode 中配置您的深度链接

Enable Associated Domains

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

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

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

  1. 使用 XCode 打开您的应用项目。
  2. 从左侧菜单中选择您的项目。
  3. Targets 中选择您的应用。
  4. 从顶部菜单中选择 Signing & Capabilities
  5. 确保在下方子菜单中选定 All
  6. 选择添加选项 ( + 图标) 添加功能。
  7. 选择 Associated Domains
  8. 填写带有前缀的 Adjust 通用链接域名 applinks:
    • example.adj.st 域使用示例:applinks:example.adj.st

Custom URL scheme

  1. 使用 XCode 打开您的应用项目。
  2. 从左侧菜单中选择您的项目。
  3. Targets 中选择您的应用。
  4. 从顶部菜单中选择 Info
  5. 展开 URL Types 板块。
  6. 选择添加选项 ( + 图标) 添加 URL 类别。
  7. 输入下列信息,以创建 URL 方案:
    • 标识符$(PRODUCT_BUNDLE_IDENTIFIER)
    • URL 方案 :您的自定义 URL 方案。该方案必须是唯一的。请勿使用受保护的方案,如 httphttpsmailto
    • 角色 :编辑员

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

Modify your iOS app

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

App doesn’t use scenes

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

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

  • ADJLinkResolution.resolveLink: Call this method only if your marketing team requires the use of Adjust’s Link Resolution solution. If the deep link uses a domain that matches an element in the resolveUrlSuffixArray, then the method attempts to resolve the deep link, and returns the resolved link. If the deep link doesn’t match an element in this array, then the method passes through the original deep link, so you can pass all deep links to this method.
  • Adjust.processDeeplink 调用该方法,向 Adjust 服务器发送深度链接,用于记录信息。Adjust 和非 Adjust 深度链接均可以发送给该方法。Adjust 服务器会忽略不包含 Adjust 参数的所有深度链接。

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

Custom URL scheme

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

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

App uses scenes

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

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

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

  • ADJLinkResolution.resolveLink: Call this method only if your marketing team requires the use of Adjust’s Link Resolution solution. If the deep link uses a domain that matches an element in the resolveUrlSuffixArray, then the method attempts to resolve the deep link, and returns the resolved link. If the deep link doesn’t match an element in this array, then the method passes through the original deep link, so you can pass all deep links to this method.
  • Adjust.processDeeplink - 调用该方法,向 Adjust 服务器发送深度链接,用于记录信息。Adjust 和非 Adjust 深度链接均可以发送给该方法。Adjust 服务器会忽略不包含 Adjust 参数的所有深度链接。

Custom URL scheme

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

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