用戶點(diǎn)進(jìn)一條廣告鏈接iPhone 上卻什么也沒(méi)發(fā)生App 沒(méi)彈起來(lái)瀏覽器停在落地頁(yè)運(yùn)營(yíng)第二天拿著漏斗數(shù)據(jù)找過(guò)來(lái)轉(zhuǎn)化掉了將近一半。這種問(wèn)題我見(jiàn)過(guò)太多次。做 Unity 手游的 iOS 客戶端越久越清楚Deep Link 這件事表面上歸 iOS 原生層管但真正要做到召回、買(mǎi)量、分享回流這些鏈路不丟用戶就必須從 URL Scheme / Universal Links 的注冊(cè)開(kāi)通、系統(tǒng)驗(yàn)證、原生回調(diào)一路打通到 C# 層的參數(shù)投遞。中間任何一環(huán)偷懶用戶就會(huì)在某個(gè)靜默的角落流失。這篇文章以 Unity 手游為背景完整走一遍 iOS 拉起 App、C# 收到深鏈參數(shù)并派發(fā)到業(yè)務(wù)界面的全過(guò)程包含原生側(cè)配置、AASA 校驗(yàn)、冷啟動(dòng)和熱啟動(dòng)兩種時(shí)序的處理姿勢(shì)以及我在項(xiàng)目里真實(shí)踩過(guò)的坑適合正在接深鏈、或者準(zhǔn)備做用戶回流和買(mǎi)量歸因的朋友參考。1. 一條分享鏈接決定生死Deep Link 到 C# 層到底解決了什么問(wèn)題1.1 三個(gè)真實(shí)場(chǎng)景沒(méi)有好的喚醒鏈路會(huì)怎樣先說(shuō)最常見(jiàn)的買(mǎi)量歸因場(chǎng)景。用戶在抖音、快手或者廣告聯(lián)盟里看到一條素材點(diǎn)了一下廣告平臺(tái)會(huì)帶著一串投放參數(shù)跳到一個(gè)落地頁(yè)。如果這個(gè)落地頁(yè)能直接拉起 App并且把 campaign、adset、creative 這些參數(shù)傳給 C# 層客戶端就能在用戶進(jìn)來(lái)后上報(bào)歸因渠道方就能確認(rèn)這個(gè)用戶是它帶來(lái)的。沒(méi)有深鏈用戶點(diǎn)了廣告后只能先去 App Store 下載裝完一打開(kāi)就是空白首頁(yè)誰(shuí)也不記得被哪條廣告勾來(lái)的。投放側(cè)的數(shù)據(jù)一旦斷了買(mǎi)量?jī)?yōu)化就變成了盲人摸象。第二個(gè)是社交分享和邀請(qǐng)。玩家把“幫我砍一刀”或者“加入公會(huì)領(lǐng)鉆石”的鏈接甩到微信群里好友點(diǎn)開(kāi)如果系統(tǒng)沒(méi)有把 link 里的邀請(qǐng)人 ID 透?jìng)鹘o游戲內(nèi)邏輯新用戶注冊(cè)后就沒(méi)法自動(dòng)綁定關(guān)系運(yùn)營(yíng)包里的“邀請(qǐng)有禮”就只能靠玩家手動(dòng)填寫(xiě)邀請(qǐng)碼。手動(dòng)填寫(xiě)這一步轉(zhuǎn)化率基本要打三折。第三個(gè)是 Push 和郵件召回。運(yùn)營(yíng)發(fā)一條“七日回歸福利”的推送用戶點(diǎn)開(kāi)通知理想情況是直接回到游戲內(nèi)任務(wù)中心并且把這條 push 的 campaign 號(hào)帶進(jìn)來(lái)。如果深鏈參數(shù)沒(méi)法送到 C# 層客戶端就只能彈首頁(yè)用戶還要自己找半天入口。別小看這一步連續(xù)兩次點(diǎn)進(jìn)去都是首頁(yè)第三輪召回郵件基本就沒(méi)人打開(kāi)。這三個(gè)場(chǎng)景的共同點(diǎn)是把“外部世界的一個(gè)意圖”翻譯成“App 內(nèi)部的一個(gè)入口動(dòng)作”。說(shuō)白了就是用戶在外面點(diǎn)了一個(gè)鏈接系統(tǒng)需要知道啟動(dòng)哪個(gè) AppApp 需要知道進(jìn)去之后干什么。深鏈做得好的產(chǎn)品用戶從點(diǎn)擊到看到指定界面能在三秒內(nèi)完成做得差的用戶點(diǎn)完鏈接還要經(jīng)歷彈窗確認(rèn)、落地頁(yè)跳轉(zhuǎn)、App 首頁(yè)漫無(wú)目的地劃拉流失就是這么一點(diǎn)點(diǎn)磨掉的。1.2 先理清需求邊界你需要的到底是“喚起到站”還是“參數(shù)到界面”在動(dòng)手之前我建議團(tuán)隊(duì)先把需求拆成兩個(gè)層級(jí)。層級(jí) A只要喚起。用戶點(diǎn)鏈接App 能打開(kāi)就行進(jìn)去之后統(tǒng)一走首頁(yè)不關(guān)心上一跳是誰(shuí)。這個(gè)最簡(jiǎn)單配一個(gè) URL Scheme 或者 Universal Links 就完事了。層級(jí) B參數(shù)到界面。不僅要把 App 拉起來(lái)還要把落地頁(yè)里攜帶的邀請(qǐng)人 ID、物料編號(hào)、活動(dòng)碼、來(lái)源渠道等參數(shù)解析出來(lái)轉(zhuǎn)給游戲內(nèi)某個(gè)界面直接跳轉(zhuǎn)或彈窗。絕大多數(shù)手游做到后面都需要層級(jí) B。原因很現(xiàn)實(shí)買(mǎi)量歸因平臺(tái)、分享系統(tǒng)、運(yùn)營(yíng)后臺(tái)都會(huì)往鏈接后面追加參數(shù)如果客戶端只實(shí)現(xiàn)了“喚起不讀參數(shù)”等于只修了一半的橋。與其以后返工不如一開(kāi)始就把“收到原始 URL、解析參數(shù)、按參數(shù)路由”這條鏈路搭好。另外要注意的是深鏈方案的復(fù)雜度和你的瀏覽器投放矩陣強(qiáng)相關(guān)只投 Safari 和海外渠道Universal Links 比較省心如果國(guó)內(nèi)微信、抖音、QQ 大量?jī)?nèi)嵌瀏覽器分享那就不能只靠 Universal Links通常還要保留一套 URL Scheme 降級(jí)兜底。這個(gè)取舍后面細(xì)說(shuō)。2. URL Scheme 和 Universal Links 在 iOS 上的運(yùn)轉(zhuǎn)邏輯以及怎么選2.1 URL Scheme老牌方案快但糙URL Scheme 的原理和你在電腦上輸入mailto:會(huì)喚起郵件客戶端差不多。iOS 有一套已注冊(cè)的協(xié)議表每個(gè) App 通過(guò) Info.plist 里的CFBundleURLTypes聲明自己可以處理哪些協(xié)議。系統(tǒng)收到一個(gè)以mygame://開(kāi)頭的鏈接時(shí)會(huì)去協(xié)議表里找哪個(gè) App 聲明過(guò)這個(gè)協(xié)議找到就把它拉起來(lái)然后把整條 URL 作為參數(shù)交給 App。這個(gè)方案的好處是接入成本極低。Unity 工程里在 Player Settings 填幾個(gè) scheme構(gòu)建出來(lái)就能用不需要服務(wù)器不需要域名甚至連蘋(píng)果開(kāi)發(fā)者后臺(tái)都不用額外配置。缺點(diǎn)是體驗(yàn)有限在 Safari 里通過(guò)網(wǎng)頁(yè) JS 跳轉(zhuǎn) scheme 時(shí)iOS 會(huì)彈一個(gè)“此 App 想要打開(kāi)”的確認(rèn)框多一次點(diǎn)擊就多一批流失。微信、QQ 這類內(nèi)嵌瀏覽器對(duì) scheme 跳轉(zhuǎn)攔截得很兇經(jīng)常要用戶點(diǎn)右上角“在瀏覽器打開(kāi)”鏈路非常曲折。如果 scheme 和系統(tǒng)協(xié)議或其它 App 沖突匹配行為不可控。即便如此URL Scheme 在手游里依然是兜底方案。理由很樸素Universal Links 在國(guó)內(nèi)部分 webview 里并不萬(wàn)能關(guān)鍵時(shí)刻還得靠 scheme 硬拉一次雖然帶著一個(gè)確認(rèn)彈窗總比完全拉不起來(lái)強(qiáng)。2.2 Universal Links蘋(píng)果親兒子驗(yàn)證鏈路長(zhǎng)Universal Links 是 iOS 9 之后蘋(píng)果推薦的深鏈方案。它的思路是你的域名和你的 App 做一次綁定以后用戶在 Safari 或其它支持的系統(tǒng)組件里點(diǎn)開(kāi)這個(gè)域名下的某條 HTTPS 鏈接時(shí)如果手機(jī)上裝了你的 App系統(tǒng)直接無(wú)縫喚起 App不彈確認(rèn)框如果沒(méi)裝就正常打開(kāi)網(wǎng)站落地頁(yè)。這個(gè)“順滑降級(jí)”能力對(duì)買(mǎi)量尤其友好——已安裝用戶直接進(jìn)游戲未安裝用戶看網(wǎng)頁(yè)不會(huì)被一個(gè)彈窗卡在中間。要讓 Universal Links 生效需要滿足三個(gè)條件Xcode 工程里為 App 開(kāi)啟 Associated Domains并寫(xiě)好applinks:這個(gè)域名關(guān)聯(lián)。蘋(píng)果開(kāi)發(fā)者后臺(tái)里這個(gè) App ID 必須也開(kāi)啟 Associated Domains capability。域名根目錄的https://你的域名/.well-known/apple-app-site-association位置放一個(gè) AASA 文件文件里寫(xiě)明 team ID 和 bundle ID以及哪些路徑允許喚起 App。這套東西的所有驗(yàn)證都在蘋(píng)果服務(wù)器和系統(tǒng)內(nèi)部完成鏈路長(zhǎng)出問(wèn)題的時(shí)候排查起來(lái)也比 scheme 麻煩。首次部署時(shí)系統(tǒng)還會(huì)要求用 Safari 實(shí)際打開(kāi)一遍域名才能觸發(fā) AASA 下載很多新人在這一步就把時(shí)間耗掉了后面我會(huì)專門(mén)寫(xiě)排查順序。2.3 選型建議按產(chǎn)品和預(yù)算判斷我自己項(xiàng)目的經(jīng)驗(yàn)絕大多數(shù)手游最終都會(huì)是兩條腿走路Universal Links 做主力體驗(yàn)URL Scheme 做降級(jí)兜底。下面這個(gè)對(duì)比表可以幫助團(tuán)隊(duì)快速拍板對(duì)比維度URL SchemeUniversal Links接入成本低一個(gè) scheme 字符串高需要域名、HTTPS、AASA、entitlements用戶體驗(yàn)有確認(rèn)彈窗部分 webview 攔截?zé)o感喚起直接進(jìn) App未安裝 App無(wú)處理能力通常只報(bào)錯(cuò)流暢回落網(wǎng)頁(yè)歸因參數(shù)攜帶可以但容易丟完整且系統(tǒng)層面更穩(wěn)定國(guó)內(nèi)微信/抖音 webview經(jīng)常攔截同樣經(jīng)常攔截需要 scheme 兜底排查成本低高AASA 和 entitlements 經(jīng)常出問(wèn)題如果項(xiàng)目只是想做一個(gè)簡(jiǎn)單的“從郵件里點(diǎn)鏈接進(jìn)首頁(yè)”那就只配 URL Scheme半天搞定。如果要做買(mǎi)量歸因、活動(dòng)分享、Push 跳轉(zhuǎn)這些正經(jīng)場(chǎng)景我建議直接上 Universal Links Scheme 雙通道因?yàn)闅w因平臺(tái)比如 AppsFlyer、Adjust的 iOS 啟動(dòng)方案基本都要求 Universal Links你繞不開(kāi)。3. iOS 工程側(cè)配置實(shí)操?gòu)?Info.plist 到 AASA 部署3.1 URL Scheme 配置Unity 側(cè)最省事的做法說(shuō)到配置先澄清一個(gè)容易踩的坑Unity 項(xiàng)目構(gòu)建 Xcode 工程后Info.plist每次都會(huì)重新生成你如果每次構(gòu)建完手動(dòng)去 Xcode 里改 CFBundleURLTypes下一次構(gòu)建又會(huì)被覆蓋早晚有一天忘記。最穩(wěn)的做法是直接在 Unity 的 Project Settings 里做。在 Unity 打開(kāi)Edit Project Settings Player切到 iOS 頁(yè)簽找到Other Settings Supported URL schemes把你想要的協(xié)議名填進(jìn)去多個(gè)協(xié)議用英文逗號(hào)分隔例如mygame,mygamepay構(gòu)建之后生成的 Xcode 工程 Info.plist 里就會(huì)出現(xiàn)下列內(nèi)容keyCFBundleURLTypes/key array dict keyCFBundleURLName/key stringcom.yourcompany.yourgame/string keyCFBundleURLSchemes/key array stringmygame/string stringmygamepay/string /array /dict /array這里有個(gè)細(xì)節(jié)scheme 建議全部用小寫(xiě)字母iOS 匹配雖說(shuō)不區(qū)分大小寫(xiě)但某些第三方 SDK 解析 URL 的時(shí)候會(huì)按大小寫(xiě)敏感處理與其后面排查玄學(xué)不如一開(kāi)始統(tǒng)一小寫(xiě)。另外不要用http、https、tel、sms這類已被系統(tǒng)或系統(tǒng)應(yīng)用占用的協(xié)議注冊(cè)了也沒(méi)用。3.2 Universal Links 配置Associated Domains 與 AASA 文件Universal Links 的配置比 scheme 繁瑣我給你按步驟走一遍。第一步到蘋(píng)果開(kāi)發(fā)者后臺(tái)找到你的 App ID勾選 Associated Domains capability。這個(gè)如果沒(méi)開(kāi)Xcode 里配了關(guān)聯(lián)域名也白搭而且這個(gè)選項(xiàng)改動(dòng)后需要重新下載配置文件或者直接重新生成 provisioning profile真機(jī)調(diào)試時(shí)要注意。第二步在 Xcode 工程能力里添加關(guān)聯(lián)域名。選中 target切到 Signing Capabilities點(diǎn)添加 Associated Domains填寫(xiě)applinks:yourgame.com注意是applinks:前綴后面跟你的域名不需要加https://。加了這條之后Xcode 會(huì)自動(dòng)生成 entitlements 文件里面長(zhǎng)這樣keycom.apple.developer.associated-domains/key array stringapplinks:yourgame.com/string /array如果項(xiàng)目使用 CI 打包建議把 entitlements 文件納入版本管理并在構(gòu)建腳本里做校驗(yàn)避免開(kāi)發(fā)者本地 Xcode 因?yàn)楹灻渲貌煌堰@條能力弄丟。第三步部署 AASA 文件。把下面的 JSON 存成apple-app-site-association放到域名根目錄下的.well-known文件夾里{ applinks: { apps: [], details: [ { appID: ABCDE12345.com.yourcompany.yourgame, paths: [*] } ] } }appID的格式是團(tuán)隊(duì)ID.bundleID團(tuán)隊(duì) ID 在蘋(píng)果開(kāi)發(fā)者后臺(tái)的 Membership 頁(yè)面找bundle ID 是 App 的準(zhǔn)確標(biāo)識(shí)這兩個(gè)拼寫(xiě)錯(cuò)任何一個(gè)Universal Links 都起不來(lái)而且不會(huì)有任何直觀報(bào)錯(cuò)。paths決定域名下哪些路徑可以喚起 App。[*]最粗暴所有的路徑都能喚起也可以精確限定比如[/gift/*, /invite/*]不在列表里的路徑就讓 Safari 正常開(kāi)網(wǎng)頁(yè)。我建議線上正式環(huán)境用精確路徑開(kāi)發(fā)環(huán)境先放通配符方便排查。文件命名有講究apple-app-site-association沒(méi)有.json后綴服務(wù)器 MIME 類型應(yīng)該返回application/json文件大小不能超過(guò) 150KB而且整個(gè)域名必須是 HTTPS不能帶重定向鏈。很多 CDN 默認(rèn)會(huì) 301 跳轉(zhuǎn)http://或跳轉(zhuǎn)到帶www.的域名iOS 對(duì) AASA 的重定向容忍度很差最好讓運(yùn)維把 HTTPS 直連和常見(jiàn)后綴都配好。3.3 驗(yàn)證手段curl、Safari 與模擬器 openurl配置完以后別急著寫(xiě) C#先確認(rèn)系統(tǒng)能不能拿到 AASA 文件。在終端直接執(zhí)行curl -i https://yourgame.com/.well-known/apple-app-site-association看返回碼是不是 200Content-Type 是不是application/json內(nèi)容里 appID 和 paths 是否符合預(yù)期。如果返回 404、301 或者內(nèi)容被 JS 包裹就要先解決服務(wù)器問(wèn)題。接著在真機(jī)上做一次“首次激活”。用 Safari 地址欄手動(dòng)輸入https://yourgame.com/gift?codeSUMMER2024這一步的目的不是測(cè)試跳轉(zhuǎn)而是觸發(fā)系統(tǒng)下載這個(gè)域名的 AASA。第一次訪問(wèn)之后系統(tǒng)才真正知道你這個(gè)域名和 App 是綁定的之后你再通過(guò)其它入口打開(kāi)同域名鏈接才有機(jī)會(huì)走 Universal Links。開(kāi)發(fā)期這個(gè)順序特別容易漏很多人配置全對(duì)就是因?yàn)闆](méi)有先讓 Safari 訪問(wèn)過(guò)域名結(jié)果一直拉不起來(lái)。模擬器調(diào)試的話可以直接用 simctl 命令喚起某個(gè) scheme 或 universal linkxcrun simctl openurl booted mygame://open?pagegiftcodeSUMMER2024 xcrun simctl openurl booted https://yourgame.com/gift?codeSUMMER2024缺點(diǎn)是模擬器對(duì) Universal Links 的兼容偶爾有玄學(xué)AASA 下載有時(shí)不觸發(fā)所以我更推薦真機(jī)作為最終驗(yàn)收環(huán)境。4. Unity C# 層橋接冷啟動(dòng)、熱啟動(dòng)與參數(shù)交付4.1 官方內(nèi)置 API 的完整使用姿勢(shì)很多教程會(huì)教你寫(xiě) Objective-C 代碼重寫(xiě)UnityAppController去攔截application:openURL:options:那次 iOS 原生層的正統(tǒng)做法但對(duì) Unity 開(kāi)發(fā)者來(lái)說(shuō)從 Unity 2018.2 開(kāi)始官方已經(jīng)把這件事封裝好了。你只需要關(guān)心 C# 里兩個(gè) APIApplication.absoluteURLApp 啟動(dòng)時(shí)攜帶的完整 URL冷啟動(dòng)場(chǎng)景用。Application.deepLinkActivated深鏈觸發(fā)事件熱啟動(dòng)和 Universal Links 喚起時(shí)會(huì)被調(diào)用。我的做法是寫(xiě)一個(gè)專門(mén)的DeepLinkManager單例把所有深鏈 URL 收進(jìn)來(lái)再統(tǒng)一拋給業(yè)務(wù)層。下面這個(gè)代碼可以直接放到 Unity 工程里跑using System; using System.Collections.Generic; using UnityEngine; public sealed class DeepLinkManager : MonoBehaviour { public static event Actionstring DeepLinkReceived; private static readonly Queuestring PendingUrls new Queuestring(); private static bool _isReady; private void Awake() { Application.deepLinkActivated OnDeepLinkActivated; // 冷啟動(dòng)時(shí)如果系統(tǒng)已經(jīng)把 URL 給了 Unity string coldStartUrl Application.absoluteURL; if (!string.IsNullOrEmpty(coldStartUrl)) { EnqueueUrl(coldStartUrl); } } private void Start() { // 場(chǎng)景已經(jīng)初始化可以開(kāi)始派發(fā) _isReady true; FlushPendingUrls(); } private void OnDeepLinkActivated(string url) { EnqueueUrl(url); } private void EnqueueUrl(string url) { if (_isReady) { DeepLinkReceived?.Invoke(url); } else { PendingUrls.Enqueue(url); } } private void FlushPendingUrls() { while (PendingUrls.Count 0) { string url PendingUrls.Dequeue(); DeepLinkReceived?.Invoke(url); } } }這段代碼看著簡(jiǎn)單但解決了兩個(gè)關(guān)鍵問(wèn)題第一冷啟動(dòng)和熱啟動(dòng)兩個(gè)路徑都收錄第二URL 到達(dá)和場(chǎng)景初始化完成這兩個(gè)事件并不保證先后用隊(duì)列兜底避免 URL 到了但 UI 還沒(méi)建好導(dǎo)致參數(shù)丟失。業(yè)務(wù)層只需要訂閱DeepLinkReceived事件就夠了不用關(guān)心到底從哪條鏈路來(lái)的。4.2 參數(shù)暫存與延遲派發(fā)別讓 UI 還沒(méi)建好就收參數(shù)深鏈參數(shù)丟失最隱蔽的場(chǎng)景是冷啟動(dòng)時(shí)系統(tǒng)喚起 AppUnity 引擎初始化、首個(gè)場(chǎng)景加載、業(yè)務(wù)模塊初始化這三件事幾乎是并行的。如果拿到 URL 的瞬間就去FindObjectOfType找某個(gè)彈窗組件大概率拿到 null然后你的代碼就靜默 return 了日志里什么都沒(méi)有運(yùn)營(yíng)那邊看到的反饋就是“點(diǎn)鏈接進(jìn)游戲什么都沒(méi)有”。所以一定不要在你的業(yè)務(wù)回調(diào)里直接操作未初始化的 UI。穩(wěn)妥的做法是收到 URL 后先解析、先緩存等核心模塊登錄、活動(dòng)系統(tǒng)、消息中心都啟動(dòng)完畢再統(tǒng)一派發(fā)解析時(shí)如果發(fā)現(xiàn)參數(shù)格式不對(duì)要打日志不要吞掉。我見(jiàn)過(guò)團(tuán)隊(duì)把深鏈邏輯寫(xiě)在某個(gè)界面的OnEnable里結(jié)果那個(gè)界面還沒(méi)跳到參數(shù)已經(jīng)過(guò)去了白接。更合理的做法是干脆為深鏈做一層“路由表”比如void HandleDeepLink(string url) { DeepLinkData data DeepLinkParser.Parse(url); if (data null) { Debug.LogError($[DeepLink] 無(wú)法解析: {url}); return; } switch (data.Page) { case gift: // 等禮包系統(tǒng)初始化后彈出 GiftManager.Instance.OpenGiftPanel(data.Code); break; case shop: ShopManager.Instance.OpenItemDetail(data.ItemId); break; default: Debug.Log($[DeepLink] Unknown page: {data.Page}); break; } }這里有幾個(gè)運(yùn)營(yíng)側(cè)的習(xí)慣要注意。很多鏈接里的參數(shù)是中文、甚至有 emoji直接Uri解析出來(lái)可能是亂碼所以要統(tǒng)一做一次 URL decode。我一般用WWW.UnEscapeURL或UnityWebRequest.UnEscapeURL和 iOS 原生傳給 Unity 的轉(zhuǎn)義格式是對(duì)應(yīng)的。4.3 參數(shù)解析與統(tǒng)一協(xié)議把 scheme 和 UL 收斂成同一種 URL雙通道方案帶來(lái)的一個(gè)麻煩是URL Scheme 長(zhǎng)這樣mygame://open?pagegiftcodeSUMMER2024Universal Links 長(zhǎng)這樣https://yourgame.com/gift?codeSUMMER2024。如果業(yè)務(wù)層分別解析兩種格式寫(xiě)出來(lái)的代碼會(huì)越來(lái)越亂而且渠道方一換參數(shù)又得改。我推薦的做法是在 C# 層做一個(gè)“統(tǒng)一深鏈協(xié)議”。無(wú)論進(jìn)來(lái)是什么都先抽成 頁(yè)面名 參數(shù)字典再往下傳入站 URL頁(yè)面名參數(shù)mygame://open?pagegiftcodeSUMMER2024open{ page: gift, code: SUMMER2024 }https://yourgame.com/gift?codeSUMMER2024/gift{ code: SUMMER2024 }然后內(nèi)部再定義一個(gè)映射關(guān)系把/gift、pagegift、gift這些不同表達(dá)全部歸一成page_type gift。這樣后續(xù)不管買(mǎi)量平臺(tái)扔過(guò)來(lái)什么奇形怪狀的 URL客戶端只要改映射表不動(dòng)業(yè)務(wù)代碼。具體解析可以直接用 .NET 的Uriusing UnityEngine; public static class DeepLinkParser { public static DeepLinkData Parse(string rawUrl) { string decoded UnityEngine.Networking.UnityWebRequest.UnEscapeURL(rawUrl); Uri uri new Uri(decoded); string page uri.Host; string query uri.Query; // scheme 格式: mygame://gift?codexxx if (uri.Scheme mygame || uri.Scheme mygamepay) { page uri.Host; } else if (uri.Scheme https) { // universal link 格式: https://yourgame.com/gift?codexxx page uri.AbsolutePath.TrimStart(/); } var data new DeepLinkData { Page page, Query uri.Query }; return data; } } public class DeepLinkData { public string Page; public string Query; public string GetQueryValue(string key) { // 用 Uri 解析 query 中的 key-value string cut Query.TrimStart(?); foreach (string pair in cut.Split()) { string[] kv pair.Split(); if (kv.Length 2 kv[0] key) { return UnityEngine.Networking.UnityWebRequest.UnEscapeURL(kv[1]); } } return null; } }如果項(xiàng)目用了 AppsFlyer 或 Adjust它們的 SDK 在自己那套回調(diào)里也會(huì)把深鏈 URL 透?jìng)骰貋?lái)。這時(shí)候要小心雙路重復(fù)回調(diào)SDK 傳一次 URLUnity 的deepLinkActivated又傳一次業(yè)務(wù)層不冪等就會(huì)彈兩次禮包。我處理的辦法是給每個(gè) URL 算一個(gè) hash按 hash 做去重并且把歸因 SDK 的回調(diào)作為主鏈路、系統(tǒng)深鏈回調(diào)作為備用鏈路優(yōu)先級(jí)統(tǒng)一收斂到一個(gè)入口。5. 實(shí)戰(zhàn)中繞不開(kāi)的坑從“打不開(kāi)”到“參數(shù)丟了”5.1 Universal Links 白屏回 Safari 的排查鏈路如果用戶點(diǎn)了鏈接App 沒(méi)被喚起反而一直停在網(wǎng)頁(yè)里九成是 Universal Links 鏈路斷了。這類問(wèn)題第一次排查時(shí)很容易盲目我建議按下面這個(gè)順序走基本能覆蓋 80% 的原因第一檢查 Xcode entitlements 里有沒(méi)有applinks:yourgame.com。有時(shí)候團(tuán)隊(duì)交班后有人重新生成過(guò) project這一條被丟了。第二檢查蘋(píng)果開(kāi)發(fā)者后臺(tái) App ID 有沒(méi)有開(kāi) Associated Domains。這一步的問(wèn)題最隱蔽因?yàn)?Xcode 里配了 entitlements真機(jī)安裝也能成功但系統(tǒng)拉取 AASA 時(shí)校驗(yàn)的就是后臺(tái)這個(gè)開(kāi)關(guān)。第三用 curl 看 AASA 是否可以被 iOS 無(wú)重定向訪問(wèn)。很多公司域名和靜態(tài)資源分離運(yùn)維為了方便在 CDN 上做了 301iOS 認(rèn)不出來(lái)。第四確認(rèn)首次 Safari 激活已經(jīng)做過(guò)。Universal Links 不是配置完就立刻生效系統(tǒng)下載 AASA 有延遲開(kāi)發(fā)期換了新設(shè)備、新系統(tǒng)都需要先用 Safari 打開(kāi)一次域名。第五確認(rèn) appID 沒(méi)有寫(xiě)錯(cuò) team ID 和 bundle ID。這個(gè)錯(cuò)得也隱蔽因?yàn)榕f版本的 AASA 系統(tǒng)會(huì)緩存你改對(duì)之后要等一段時(shí)間或者刪掉 App 重裝。有一套我常用的快速自測(cè)在 Xcode 里跑 App然后給系統(tǒng)發(fā)一條同域名的 Universal Link看控制臺(tái)有沒(méi)有systemState、openURL這類日志再用curl https://yourgame.com/.well-known/apple-app-site-association | jq .看 AASA 是否在線。兩分鐘就能判斷大概是 native 側(cè)還是服務(wù)端的問(wèn)題。5.2 熱啟動(dòng)、去重與歸因參數(shù)穿透熱啟動(dòng)是另一個(gè)高發(fā)坑。用戶已經(jīng)打開(kāi) App切到后臺(tái)再?gòu)哪硞€(gè)鏈接點(diǎn)進(jìn)來(lái)這時(shí)候Application.absoluteURL往往不是新的深鏈地址必須靠deepLinkActivated事件接收。不少開(kāi)發(fā)者只在Awake里讀一次 absoluteURL導(dǎo)致熱啟動(dòng)場(chǎng)景下參數(shù)永遠(yuǎn)進(jìn)不來(lái)。另外歸因平臺(tái)的參數(shù)往往很長(zhǎng)。比如 AppsFlyer 的 links 到端后可能變成https://yourgame.com/gift?codeSUMMER2024af_siteidxxxaf_sub1yyyC# 層拿到后需要對(duì)參數(shù)做白名單過(guò)濾只把業(yè)務(wù)字段透?jìng)鹘o運(yùn)營(yíng)活動(dòng)其余歸因字段交給歸因 SDK 消費(fèi)。不要一刀切全用也不要全部丟掉。參數(shù)去重必須做。我遇到過(guò)一次比較典型的線上事故運(yùn)營(yíng)在后臺(tái)批量發(fā) Push點(diǎn)擊量集中爆發(fā)某個(gè)活動(dòng)彈窗被連續(xù)觸發(fā)就是因?yàn)樯铈溁卣{(diào)在客戶端布了兩條監(jiān)聽(tīng)同一個(gè) URL 被deepLinkActivated和歸因 SDK 各上報(bào)一次業(yè)務(wù)層沒(méi)有去重。補(bǔ)一個(gè)簡(jiǎn)單的 hash 去重就能解決private readonly HashSetstring _seenUrlHashes new HashSetstring(); void OnDeepLinkReceived(string url) { string hash url.GetHashCode().ToString(); if (!_seenUrlHashes.Add(hash)) return; HandleDeepLink(url); }5.3 調(diào)試工具與檢查清單深鏈問(wèn)題最怕兩眼一抹黑。我一般會(huì)根據(jù)現(xiàn)象先歸類再針對(duì)性調(diào)試現(xiàn)象優(yōu)先排查項(xiàng)參考手段URL Scheme 點(diǎn)擊后無(wú)反應(yīng)協(xié)議名是否注冊(cè)、是否有大小寫(xiě)問(wèn)題模擬器simctl openurlURL Scheme 點(diǎn)擊后彈確認(rèn)框正常現(xiàn)象體驗(yàn)問(wèn)題評(píng)估是否補(bǔ) Universal LinksUniversal Links 不喚起 Appentitlements、AASA、首次 Safari 激活curl AASA Xcode 控制臺(tái)日志參數(shù)進(jìn)入了 C# 但亂碼URL 未做 Unicode 解碼UnityWebRequest.UnEscapeURL參數(shù)收到多次歸因 SDK 與系統(tǒng)回調(diào)重復(fù)URL hash 去重冷啟動(dòng)后拿不到參數(shù)只讀了 absoluteURL未等場(chǎng)景就緒參數(shù)隊(duì)列延后派發(fā)微信內(nèi)點(diǎn)擊鏈接無(wú)法喚起內(nèi)嵌瀏覽器攔截引導(dǎo)“右上角瀏覽器打開(kāi)”或接微信開(kāi)放標(biāo)簽開(kāi)發(fā)期我還會(huì)在DeepLinkManager里加一段調(diào)試模式URL 可以通過(guò) Unity 菜單欄模擬注入這樣不依賴真機(jī)也能在編輯器里測(cè)試界面表現(xiàn)。6. 一些項(xiàng)目教訓(xùn)權(quán)當(dāng)課后作業(yè)深鏈接入最容易被輕視的部分是“參數(shù)協(xié)議設(shè)計(jì)”。很多項(xiàng)目一開(kāi)始只想著把 App 拉起來(lái)等買(mǎi)量平臺(tái)要做活動(dòng)聚合頁(yè)的時(shí)候才發(fā)現(xiàn)鏈接格式各家各味C# 層解析代碼寫(xiě)得像打補(bǔ)丁。所以我特別建議在立項(xiàng)階段就把自家的深鏈鏈接形態(tài)固定下來(lái)不管外面怎么變內(nèi)部統(tǒng)一成page query的結(jié)構(gòu)。其次Universal Links 一旦換域名舊域名要保留一段時(shí)間的 AASA不要馬上刪否則線上老版本客戶端的召回活動(dòng)會(huì)直接斷掉。我經(jīng)歷過(guò)一次因?yàn)橛蛎w移沒(méi)考慮老包老版本全都點(diǎn)不開(kāi)鏈接運(yùn)營(yíng)緊急回滾非常狼狽。最后分享一個(gè)實(shí)用小技巧在開(kāi)發(fā)環(huán)境給深鏈加一個(gè)專用入口比如用mygame://debug/open?pagegiftcodeTEST客戶端收到這個(gè) URL 時(shí)打印完整日志并顯示測(cè)試面板能讓你在接歸因 SDK、調(diào)試活動(dòng)彈窗時(shí)省掉大量等待真機(jī)觸發(fā)的時(shí)間。等線上穩(wěn)定后把調(diào)試分支的日志級(jí)別關(guān)掉就行也不用刪代碼。深鏈到 C# 參數(shù)投遞這條路本質(zhì)上就是一條“把外界意圖接進(jìn)游戲內(nèi)路由”的管道。管道做得越順滑買(mǎi)量、回流、邀請(qǐng)這些業(yè)務(wù)跑起來(lái)就越省心。真機(jī)調(diào)試時(shí)一定別怕麻煩把冷啟動(dòng)、熱啟動(dòng)、Safari 跳轉(zhuǎn)、微信瀏覽器降級(jí)這幾種場(chǎng)景反復(fù)跑幾遍鏈路通了后面團(tuán)隊(duì)做事都會(huì)輕松很多。