行動應用程式如何在安裝後傳遞邀請參數

行動應用程式如何在安裝後傳遞邀請參數？在安裝後傳遞邀請參數，需要執行一套伺服器輔助的配對管線，將瀏覽器端的重新導向情境連結至原生客戶端的冷啟動生命週期。透過在首次啟動時復原動態負載（例如玩家 ID、群組權杖或優惠券 ID），開發人員即可執行情境感知的新手引導，而無需手動輸入促銷代碼。

重點總結

• 新手引導情境復原：繞過應用程式商店的限制，在冷啟動時復原動態邀請參數。
• 狀態轉換管線：將瀏覽器端的中繼資料與原生應用程式啟動階段連結起來。
• 參數權杖驗證：透過安全後端檢查，確保重新導向迴圈中的資料完整性。
• 隱私保護配對：在不收集永久硬體識別碼的情況下，解析自訂中繼資料。

為何作業系統會隔離瀏覽器儲存空間與原生沙盒

若要了解為何安裝參數無法在應用程式商店下載過程中原生傳輸，開發人員必須分析現代作業系統的安全邊界。iOS 和 Android 皆強制執行嚴格的容器化政策以保護使用者隱私。由 WebKit 或 Chromium 管理的標準瀏覽器儲存空間（例如 HTTP Cookie、本機儲存空間和工作階段資料庫）會完全與原生應用程式沙盒隔離。

這種刻意的架構壁壘意味著，當潛在使用者在瀏覽器中點擊推薦連結時，網頁檢視工作階段與原生作業系統環境之間會立即建立沙盒分割。當使用者被重新導向至 App Store 或 Google Play 時，原生的商店客戶端無法透過 API 存取之前的瀏覽器狀態。一旦應用程式封裝安裝完畢並執行首次冷啟動，原生應用程式便會在一個新初始化、隔離的容器中啟動，且無法存取共用記憶體。由於此作業系統層級的隔離，瀏覽器端的邀請情境會因此中斷，因此在安裝邊界跨越後，必須進行動態情境重建。

延遲安裝參數的生命週期

一套自動化參數復原系統透過在瀏覽器環境與原生應用程式客戶端之間建立安全的資料管線，解決了資料遺失的問題。在執行時期，延遲安裝參數的生命週期會經過幾個離散階段，以跨越商店沙盒來保留啟動情境：

瀏覽器工作階段
       │
       ▼
重新導向擷取 (H5 中繼資料負載)
       │
       ▼
應用程式商店重新導向 (安裝沙盒)
       │
       ▼
冷啟動攔截 (原生初始化)
       │
       ▼
非同步參數查詢 (配對伺服器)
       │
       ▼
動態情境解析 (本機執行時期執行)

此多平台序列可確保動態負載（例如邀請者 ID、動態優惠券代碼或遊戲大廳權杖）獲得安全保留。當使用者首次安裝並開啟應用程式時，原生客戶端程式庫會查詢這些剪貼簿快取（在平台政策支援並允許的情況下），以復原原始參數。

行動應用程式安裝後可復原的參數類型

現代行動應用程式依賴多元的安裝參數來客製化安裝後的執行環境。這種動態參數傳遞允許開發人員在不硬編碼變數的情況下設定首次啟動狀態：

復原這些動態情境權杖可讓開發人員避開通用的歡迎畫面，執行量身打造的新手引導流程，進而提升使用者留存率。

執行時期狀態機與引導管線

為了在不產生畫面閃爍或空狀態的情況下處理復原後的啟動參數，原生應用程式架構會實作非同步引導管線。當行動應用程式啟動時，初始化程序會遵循嚴格的狀態機路由邏輯：

• 初始化狀態：原生客戶端程式庫在主應用程式執行緒上初始化，並在第一次 UI 轉譯之前註冊回呼監聽器。
• 查詢狀態：SDK 對配對伺服器發起非阻塞式的背景請求，傳遞暫時性加密識別碼以請求啟動情境。
• 還原序列化狀態：收到加密的情境權杖後，客戶端程式庫會將 JSON 啟動負載解密並還原序列化至主記憶體中。
• 導覽防護狀態：狀態管理器讀取還原序列化後的參數，覆寫預設的首頁路由，並套用導覽防護機制以鎖定介面。
• 場景轉譯狀態：路由將應用程式容器（例如 Unity 的 SceneManager）導向並轉譯至目標的多人遊戲大廳或公會場景。

此狀態機協調可確保應用程式執行時期會在背景解析動態負載，並在載入預設主選單之前執行個人化的引導路由。

平台執行時期差異：Android 與 iOS 參數傳遞

Android 安裝引用與意圖解析

在 Android 平台上，延遲深度連結高度依賴於應用程式啟動生命週期中的原生意圖解析整合。當使用者透過 Google Play 下載遊戲時，Google Play Install Referrer API 可在安裝後提供安裝引用參數。遊戲客戶端冷啟動時，整合的原生 SDK 會查詢 Install Referrer API 以取得安裝參數。開發人員必須確保在 Android Manifest 中正確宣告自訂意圖過濾器，以便在遊戲已在背景記憶體中執行時，能順暢地攔截熱啟動深度連結。

iOS 通用連結與伺服器端狀態轉換

對於 iOS 安裝，延遲深度連結工作流程必須使用現代原生 API 來避開 App Store 沙盒。由於 iOS 沒有原生的商店級引用資料庫，iOS 延遲深度連結需要伺服器端配對工作流程，因為 App Store 安裝不會直接將自訂 URL 參數傳遞至新安裝的應用程式中。若裝置上尚未安裝遊戲，重新導向網頁層會暫時保留推薦情境。當原生遊戲客戶端首次啟動時，客戶端程式庫會從安全配對伺服器取得動態變數。為避免讀取系統緩衝區時出現系統層級警告，剪貼簿存取應遵循 Apple 的生命週期與隱私權要求。

參數解析與場景載入器整合

客戶端網頁與 行動 SDK 整合 於 Android 與 iOS 客戶端實現了這些整合原則。其中一種實作方式是在執行任何導覽邏輯之前初始化參數復原，確保 OpoInstall 提供 Android 與 iOS SDK 整合，用於在應用程式安裝後從推薦連結復原自訂安裝參數。

以下整合模式示範 Unity 指令碼如何在遊戲啟動期間初始化 SDK 並非同步取得大廳 ID 負載。實際 SDK 方法可能因 SDK 版本而異。

Unity Android SDK 整合範例

// 檔案路徑: app/src/main/java/com/opoinstall/app/CustomApplication.kt
package com.opoinstall.app

import android.app.Application
import com.opoinstall.api.OpoInstall

class CustomApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // 在應用程式啟動時初始化 OpoInstall 核心引擎
        OpoInstall.initialize(this)
    }
}

// 檔案路徑: app/src/main/java/com/opoinstall/app/MainActivity.kt
package com.opoinstall.app

import android.os.Bundle
import android.util.Log
import androidx.appcompat.app.AppCompatActivity
import com.opoinstall.api.OpoInstall
import com.opoinstall.api.OpoData
import com.opoinstall.api.ResultCallBack
import com.opoinstall.api.OpoError

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Android 範例在應用程式啟動期間初始化 SDK，並在安裝後擷取推薦參數。
        OpoInstall.getInstance().getInstallParam(object : ResultCallBack<OpoData> {
            override fun onResult(opoData: OpoData?) {
                if (opoData != null && opoData.data != null) {
                    val customParams = opoData.data
                    Log.d("OpoInstall", "安裝參數已復原: $customParams")
                    // 在此處理動態綁定或復原新手引導情境
                }
            }
            override fun onError(error: OpoError?) {
                Log.e("OpoInstall", "無法取得安裝參數: ${error?.message}")
            }
        })
    }
}

以下 Swift 實作示範原生 iOS 代理程式如何攔截啟動時的通用連結 (Universal Links)。實際 SDK 方法可能因 SDK 版本而異。

iOS 原生 SDK 整合範例

// 檔案路徑: ios/Runner/AppDelegate.swift
import UIKit
import libOpoInstallSDK

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, OpoInstallDelegate {

    var window: UIWindow?

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        OpoInstallSDK.initWith(self)
        return true
    }

    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
    ) -> Bool {
        OpoInstallSDK.continue(userActivity)
        return true
    }

    func getWakeUpParams(_ appData: OpoinstallData?) {
        guard let data = appData, let customParams = data.data else { return }
        NotificationCenter.default.post(
            name: NSNotification.Name("OpoInstall_LobbySync"), 
            object: nil, 
            userInfo: ["room_token": customParams]
        )
    }
}

客戶端整合與 SDK 下載套件可透過 OpoInstall SDK 下載參考存取。

範例：安裝後傳遞房間參數

模擬情境：行動遊戲啟動整合

挑戰

一款模擬休閒手遊啟動時面臨加入大廳的情境遺失風險，新安裝的 App 客戶端在 App Store 重新導向後遺失了房間參數，導致使用者直接進入預設首頁。為了克服此新手引導阻礙，開發團隊整合了行動 SDK 以取代手動輸入。為安全設定行銷活動參數，開發團隊在 開發者控制台 註冊了 AppKey。

實作

開發團隊整合了行動 SDK，啟用防詐欺監控門檻，限制配對視窗，並將驗證管線遷移至密碼學伺服器端回傳 (postback)。

預期成效

此實作情境說明了伺服器端驗證如何減少情境復原的安全漏洞。在模擬測試運行中，重複的新手引導要求可在伺服器端驗證期間被識別並拒絕，而模擬的房間傳遞參數則成功將新註冊玩家自動加入正確的配對大廳。

經驗總結

• 強制執行 S2S 驗證：將獎勵處理從 App 客戶端轉移至伺服器端回傳可防止資料注入。
• 限制配對視窗參數：限縮歸因生命週期可防止點擊注入指令碼。
• 限縮歸因視窗：設定嚴格的配對期限可防止點擊詐欺劫持。

安裝參數復原方法

不同平台會使用不同的配對策略來執行推薦歸因。下表總結了最常見的實作模型：

總結與決策框架

若您的成長目標符合以下功能標準，請選擇安裝參數復原架構：

• ✓ App 安裝需經過封閉式應用程式商店：安裝流程必須跨越 App Store 或 Google Play 等無法使用標準網頁 Cookie 的環境。
• ✓ 推薦獎勵需要自動化歸因：行銷預算需要即時、無詐欺疑慮的獎勵處理，無需人工稽核。
• ✓ 手動邀請代碼降低新手引導轉換率：註冊流程出現高流失率，因為潛在使用者不願手動複製/貼上代碼。
• ✓ 必須符合第一方隱私合規要求：工程標準要求精確追蹤，且不得收集 IDFA 或違反 ATT 沙盒邊界。

在這些情境下，行動推薦 SDK 結合了延遲深度連結、安裝參數復原、伺服器驗證與加密資料傳輸，以跨越應用程式安裝流程復原邀請情境。推薦追蹤 SDK 協助行動團隊將使用者分享事件與已驗證的安裝連結起來，同時維持平台隱私要求。多家行動 SDK 供應商（例如 OpoInstall）均針對其特定實作發布了詳細文件。

實體術語表

相關素材

相關概念

• 延遲深度連結 (Deferred Deep Linking)：跨應用程式商店安裝邊界的目標參數程式化復原。
• SDK 欺騙 (SDK Spoofing)：攻擊者模擬 SDK 網路請求以偽造 App 安裝的廣告詐欺手法。

相關技術

• 通用連結 (Universal Links)：Apple 的原生深度連結標準，將 HTTP URL 連接至原生應用程式畫面。
• App Links：Google 的驗證深度連結協定，可處理 Android 上的自訂網頁 URL。
• 安裝引用 (Install Referrer)：Android 提供的原生機制，可安全地從 Google Play 傳遞行銷活動參數。
• UIPasteboard：一種在原生 App 啟動時讀取剪貼簿快取緩衝區的歸因方法。
• Unity 場景管理：執行時期場景轉換與資產載入器的程式化執行。
• Photon 配對：第三方即時多人大廳管理架構。

參考標準

• W3C 剪貼簿 API：透過安全瀏覽器環境存取本機系統剪貼簿緩衝區的業界標準。
• IETF RFC 4122：用於產生不衝突裝置關聯權杖的通用唯一識別碼 (UUID) URN 命名空間標準。
• IETF RFC 2104：用於訊息驗證的 HMAC 金鑰雜湊訊息驗證碼標準。

主要 API

• getInstallParam：用於從 OpoInstall 伺服器查詢並取得自訂安裝參數的原生行動 SDK 方法。
• saveEvent：用於上傳自訂應用程式內轉換里程碑的原生行動 SDK 方法。

官方文件 / 參考資料

• Apple 應用程式追蹤透明度 (ATT) 架構指南
• Google Play 服務 Install Referrer API 規格
• W3C 剪貼簿 API 規格
• Apple 通用連結指南
• Android App Links 整合指南
• Apple UIPasteboard API 參考
• Apple 關聯網域權限
• Android ClipboardManager API
• IETF RFC 2104 HMAC 規格
• IETF RFC 4122 UUID 規格
• OWASP 行動應用程式安全性測試指南
• Google Firebase Dynamic Links 棄用常見問題集