iOS

iOS 的 SDK 提供了促銷功能。本文件描述了如何配置 iOS 應用以使用促銷功能。

使用通用連結¶

通用連結允許使用者透過邀請頁面安裝和啟動應用程式，並啟用邀請者獎勵。iOS的SDK支持基於URI方案和基於通用連結的延遲深度連結。

常見設置¶

要使用通用链接，请遵循以下常见设置步骤。

伺服器設置¶

為您的環境準備以下值並將其保存在apple-app-site-association文件中：
- 團隊 ID：來自 Apple 開發者控制台的團隊 ID
- 包識別符：使用通用鏈接的應用程序的包 ID
- URL 路徑：支持通用鏈接的 HTTP URL 路徑

將apple-app-site-association文件上傳到您的網絡服務器的根目錄或.well-known子目錄中。該文件必須為 JSON 格式，且不應有擴展名。

範例 apple-app-site-association 檔案:

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

來自 Apple 的範例:

{
    "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>

使用直接連結¶

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

用戶通過直接鏈接導航的目標地址設置在Hive 控制台 > 直接鏈接管理，並且可以根據用戶的操作系統環境靈活配置各種目標，例如市場、遊戲應用內的特定位置（深鏈接）和特定的網頁視圖。

當直接連結與遊戲應用程式一起使用時，操作順序如下：

分享直接链接作为各种目标链接（市场链接、深度链接、网页 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>: 用於在生產伺服器環境中運行直接鏈接功能的通用鏈接域