iOS 地址

iOS的SDK提供了促销功能。本文档描述了如何配置iOS应用以使用促销功能。

使用 Universal Links¶

Universal Links 允许用户通过邀请页面安装和启动应用程序，并启用邀请者奖励。iOS 的 SDK 支持基于 URI Scheme 和基于 Universal Link 的延迟深度链接。

常见设置¶

要使用Universal Links，请遵循以下常见设置步骤。

服务器设置¶

为您的环境准备以下值，并将其保存在一个apple-app-site-association文件中：
- 团队 ID：来自 Apple 开发者控制台的您的团队 ID
- 包标识符：使用通用链接的应用程序的包 ID
- URL 路径：支持通用链接的 HTTP URL 路径

将apple-app-site-association文件上传到您的 Web 服务器的根目录或.well-known子目录。该文件必须为 JSON 格式，并且不应有扩展名。

示例 apple-app-site-association 文件:

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "--TEAM ID.--Bundle Identifier",
                "paths": ["--URL Path"]
            }
        ]
    }
}

来自苹果的示例:

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "9JA89QQLNQ.com.apple.wwdc",
                "paths": ["/wwdc/news/", "/videos/wwdc/2015/*"]
            }, {
                "appID": "ABCD1234.com.apple.wwdc",
                "paths": ["*"]
            }
        ]
    }
}

iOS 应用设置¶

按照以下步骤在 Xcode 中设置您的 iOS 应用：

在 Xcode 项目导航器中，选择你的项目。
从 TARGETS 列表中选择你的应用。
点击 Signing & Capabilities 标签。
点击 Signing & Capabilities 标签左上角的 + Capability 按钮。
从列表中添加 Associated Domains。
- 示例域名：applinks:hive-ota.withhive.com
在 Apple Developer Console 中启用应用的 Capabilities 中的 Associated Domains。

使用 UA 延迟深度链接¶

延迟深度链接允许用户通过通用链接邀请链接启动应用程序，并启用邀请者奖励。延迟深度链接需要UIPasteboard权限。当用户首次使用邀请链接安装并启动应用程序时，在iOS 16.1以下的版本上可能会出现一个吐司弹出窗口，而在iOS 16.1及以上版本上可能会出现系统权限请求弹出窗口。要禁用系统权限弹出窗口，请参考推广操作指南并将延迟深度链接设置为“禁用”。

Note

有关生成基于通用链接的邀请链接的其他控制台设置说明，请参阅推广操作指南。
系统权限请求弹出文本无法由开发者自定义。

Xcode 项目设置¶

要使用延迟深度链接，请按如下方式配置您的 Xcode 项目：

在您的 Xcode 项目中选择主要的 TARGETS。
在 Signing & Capabilities 选项卡中，在 Associated Domains 下添加以下域名：
- applinks:sandbox-promotion.qpyou.cn: 沙盒服务器环境的通用链接域
- applinks:promotion.qpyou.cn: 生产服务器环境的通用链接域

hive_config.xml 设置¶

将以下代码添加到您的SDK中的hive_config.xml文件：

<universalLink>Universal link address (Domain/Path)</universalLink>

使用直接链接¶

直接链接是用户点击后会将他们引导到游戏应用内特定位置（在安装游戏应用后）或展示特定网页视图以鼓励用户参与的URL。

用户通过直接链接导航的目标地址在 Hive Console > Direct Link Management 中设置，市场、游戏应用内的特定位置（深链接）以及特定网页视图等各种目标可以根据用户的操作系统环境灵活配置。

直接链接与游戏应用结合使用时的操作顺序如下：

共享直接链接作为各种目标链接（市场链接、深度链接、网页 URL）
当用户点击直接链接时，它的操作如下，根据 Hive 控制台 > 直接链接管理中设置的目标：
- 市场导航：无论用户的游戏应用安装状态如何，导航到 Hive 控制台 > 直接链接管理中设置的市场链接
- 应用内导航（深度链接）
- 如果游戏应用已安装在用户的环境中：导航到游戏应用内的指定位置（方案深度链接）
- 如果游戏应用未安装在用户的环境中：导航到各个操作系统环境支持的**市场中的游戏应用安装位置**或在创建深度链接时设置的**未安装用户重定向 URL**
- 网页 URL：无论用户的游戏应用安装状态如何，导航到游戏外的特定网页视图
当用户按照“游戏应用启动 > 登录 > 用户参与（UE）SetReady 操作”的顺序进行时，链接信息中包含的事件将在游戏应用中执行（执行相关功能或 UI 显示，执行在 UE 中定义的自定义功能等）

Warning

当游戏应用未在用户环境中安装时，关于根据 Hive SDK 版本的直接链接行为的注意事项如下：

Hive SDK v4 低于 25.10.0 - 尽管它鼓励在点击直接链接的用户设备上安装游戏应用，但在游戏应用安装后立即启动时，直接链接信息不会被传递。 - 游戏应用安装完成后，再次点击直接链接将同时在游戏应用启动时传递直接链接信息。事件随即执行。
Hive SDK v4 25.10.0 及以上 - 它鼓励在点击直接链接的用户设备上安装游戏应用，并且当游戏应用在安装后立即启动时，直接链接以以下两种方式操作： - 游戏应用与 Hive SDK 的推广服务器通信以获取直接链接信息。推广服务器检查首次点击直接链接的用户的设备历史和通信信息，并将适当的直接链接信息传递给游戏应用客户端。事件随即执行。 - 游戏应用安装完成后，再次点击直接链接将同时在游戏应用启动时传递直接链接信息。事件随即执行。

Xcode 项目设置¶

要在 iOS 目标 Hive SDK 中应用直接链接功能，请按以下顺序配置您的 Xcode 项目：

在您的 Xcode 项目中选择主要 TARGETS。

在 Signing & Capabilities 选项卡的 Associated Domains 部分，按如下方式配置域：

* <i>applinks:sandbox-direct-link.withhive.com</i>: 用于在沙箱服务器环境中操作的直接链接功能的通用链接域
* <i>applinks:direct-link.withhive.com</i>: 用于在生产服务器环境中操作的直接链接功能的通用链接域