adjust-icon

配置深度链接设置

要求

  • Adjust 控制面板中用于设置品牌化域名的管理员权限
  • Adjust 控制面板中用于管理应用设置的编辑或更高权限

创建应用

在 Adjust 控制面板中创建应用。

请注意，Adjust 控制面板仅支持每个应用使用一个 Bundle ID (com.example.app) 和一个应用 Scheme (example://) 。如果您的应用在发布版本和调试版本中使用不同的 Bundle ID 和／或应用 Scheme，请创建单独的调试应用。

添加 iOS 平台

在应用的平台设置中添加 iOS。此步骤需要输入 Bundle ID。如果不确定应用版本的 Bundle ID，请输入临时值 (com.example.app) 以保存平台设置。按照本指南的其余步骤收集全部所需数据点，然后返回控制面板中的平台设置以完成配置。

设置品牌化域名

在 Adjust 控制面板中使用 Adjust 的 go.link 域名，例如：brandname.go.link，设置品牌化域名。

如果您的 iOS 应用和 Android 应用在 Adjust 中使用不同的应用，请确保在 Adjust 控制面板中为这两个应用选择相同的品牌化域名 (brandname.go.link)。

如果发布版本和调试版本使用不同的应用，请为调试应用单独创建一个品牌化域名 (brandnamedebug.go.link)。如果调试应用在 Adjust 中使用单独的 iOS 和 Android 应用，请确保在 Adjust 控制面板中为这两个调试应用选择相同的品牌化域名。

请记下您的品牌化域名，以便在下一节中通过 Xcode 进行配置。

在 Xcode 中配置设置

  1. 打开 Xcode 项目。

  2. 在导航面板中，选择项目名称来访问项目设置。

  3. 在项目设置的 Targets (目标) 下选择合适的目标 (通常是您的应用名称)。

  4. 选择 Signing & Capabilities (签名和功能) 标签页。

  5. 在“ Release ” (发布) 和“ Debug ” (调试) 子选项卡中完成以下步骤：

    • 记录“ Bundle Identifier ”字段中的值。这是应用的 Bundle ID (“发布 Bundle ID”或“调试 Bundle ID”)，需要在 Adjust 控制面板的 iOS 平台设置中进行配置。

    • 在“ Associated Domains ” (关联域名) 栏为每个品牌化域名添加条目。对于示例域名 brandname.go.link，以下是必填条目：

      applinks:brandname.go.link

排查缺失或有问题的关联域名设置

  • 如果看不到“ 关联域名 ”栏，可能需要先加以启用：

    1. 在“ 发布 ”或“ 调试 ”子选项卡旁边 (缺失该栏的位置) 点击“ + Capability ”(+ 功能)。
    2. 搜索“Associated Domains” (关联域名) 并加以选择。

  • 如果在尝试启用关联域名时收到错误信息 (例如“配置文件 {profile_name} 不支持关联域名功能”) ，请更新预置描述文件：

检索或配置应用 Scheme

在某些 iOS 不支持通用链接的用例中，需要使用应用 Scheme。可以重复使用现有的应用 Scheme，以便进行 Adjust 深度链接。

  1. 在 Xcode 导航面板中选择项目名称来访问项目设置。
  2. 在“Targets” (目标) 栏下选择合适的目标 (通常是您的应用名称)。
  3. 选择“ Info ” (信息) 选项卡。
  4. 展开 URL Types 板块。

如果您的应用已经有一个应用 Scheme，则会有 URL 类型条目，每个条目都有一个 URL 方案 值。使用下表根据 URL 类型配置来确定应用 Scheme。请记录相关应用 Scheme，以便稍后在 Adjust 控制面板中进行设置。

URL 方案 字段应用 scheme
静态值，例如 exampleexample:// 是“Release App Scheme” (发布应用 Scheme)
静态值，例如单独的 URL 类型条目中的 example、exampleDebugexample:// 是“Release App Scheme”
exampleDebug:// 是“Debug App Scheme” (调试应用 Scheme)
动态版本设置变量，例如 $(APP_SCHEME)前往“ Build Settings ” (版本设置) 选项卡 -> 搜索变量名称 (例如“APP_SCHEME”) -> 发布和调试值分别是“Release App Scheme”和“Debug App Scheme”

如需创建应用 Scheme，请按照以下步骤操作：

  • 选择“ + ”按钮以添加新的 URL 类型。

  • 填写以下字段：

    • 标识符 ： $(PRODUCT_BUNDLE_IDENTIFIER)
    • 角色 ：编辑员
    • URL 方案 ：输入所需的应用 Scheme 值 (输入 example，而不是 example://)。请勿使用 http、https 或保留的 iOS 方案 (例如 mailto、tel、sms 或 facetime)。在此处输入静态值将创建用于发布和调试版本的单一应用 Scheme。

  • 创建后，记录应用 Scheme，以便稍后在 Adjust 控制面板中进行配置。

从 Apple 开发者门户检索应用 ID 前缀

  1. 登入 Apple Developer 门户。
  2. 在 Certificates, IDs & Profiles (证书、标识符和描述文件)下选择 Identifiers (标识符)。
  3. 选择您的应用。
  4. 在页面顶部附近记录 应用 ID 前缀 ，以便在下一节的 Adjust 控制面板中进行配置。

完成 iOS 平台设置配置

在 Adjust 控制面板中利用所收集的以下数据点完成 iOS 平台设置的配置。

数据点示例要求
发布版 Bundle IDcom.example.app必要。
调试版 Bundle IDcom.example.debug如果调试 Bundle ID 与发布 Bundle ID 不同，则必填。
发布应用 Schemeexample://对于 iOS 不支持通用链接的用例，这是必填项。
调试应用 SchemeexampleDebug://如果调试应用 Scheme 与发布应用 Scheme 不同，则必填。
应用 ID 前缀ABCDE12345必要。