🔧
通用基礎知識
🧩 一、SDK 基礎概念
1.1 什麼是 SDK?
SDK(Software Development Kit,軟體開發工具包)是一組由平台或渠道提供的程式碼庫、工具和文件,讓開發者能夠調用該平台的特定功能。在遊戲運營中,SDK 是遊戲與外部平台之間的「橋樑」。
1.2 遊戲運營中常見的 SDK 類型
| SDK 類型 |
功能說明 |
典型例子 |
| 渠道 SDK |
接入應用商店的帳號體系、支付、用戶管理 |
Apple StoreKit、Google Play Billing SDK |
| 廣告 SDK |
接入廣告變現能力(橫幅、插屏、激勵視頻等) |
AdMob、Unity Ads、AppLovin、ironSource |
| 分析 SDK |
追蹤用戶行為、留存、付費數據 |
Firebase Analytics、Adjust、AppsFlyer |
| 推送 SDK |
實現消息推送通知能力 |
FCM(Firebase Cloud Messaging)、APNs |
| 社交 SDK |
接入第三方登入和社交分享 |
Facebook SDK、LINE SDK、Google Sign-In |
| 客服 SDK |
遊戲內嵌客服系統 |
Freshchat、Zendesk、Intercom |
1.3 渠道 SDK 的核心功能模組
- 登入模組:調用渠道帳號體系統一登入(Apple ID / Google 帳號),獲取用戶身份憑證
- 支付模組:調起渠道內購流程,處理訂單創建、支付回調、訂單驗證
- 用戶管理:角色上報、角色信息提交(用於渠道後台顯示在線人數等)
- 退出模組:處理帳號切換、退出登入等場景
- 實名認證:部分地區要求(如未成年人保護),SDK 提供實名驗證能力
💡 關鍵概念:渠道 SDK 與遊戲程式碼之間通常會設計一個抽象層(Abstract Layer),讓遊戲只調用統一介面,底層根據不同渠道自動切換實現。這就是「一套程式碼,多渠道打包」的基礎。
🔌 二、SDK 接入基礎知識
2.1 SDK 接入的標準流程
📖
Step 1 · 閱讀官方文件
— 在對應平台後台(App Store Connect / Google Play Console)下載 SDK 開發文件,了解接入要求和版本規範
⚙️
Step 2 · 環境配置
— 將 SDK 庫匯入專案,配置必要的權限(AndroidManifest.xml / Info.plist)、URL Scheme、簽名等
🔌
Step 3 · 初始化 SDK
— 在應用啟動時調用初始化接口,傳入 App ID / App Key 等參數
🔐
Step 4 · 接入登入
— 調用登入接口,處理登入成功/失敗回調,獲取用戶 Token
💳
Step 5 · 接入支付
— 創建訂單 → 調起支付 → 處理支付回調 → 伺服器驗證 → 發放道具
📊
Step 6 · 角色信息上報
— 登入成功後向渠道伺服器上報角色等級、伺服器等信息
🧪
Step 7 · 測試驗證
— 使用沙盒/測試環境完成全流程測試,確保支付、登入、回調均正常
🚀
Step 8 · 提交審核
— 打包上傳至平台後台,提交審核
2.2 核心接口一覽
| 接口名稱 |
功能 |
調用時機 |
備註 |
Init() |
SDK 初始化 |
App 啟動時,最早調用 |
必須在登入之前完成 |
Login() |
調起登入界面 |
初始化完成後 |
回調中獲取 user_id / token |
Logout() |
登出 / 切換帳號 |
用戶主動退出或切換 |
需回到登入界面 |
Pay(order) |
調起支付 |
用戶觸發購買 |
客戶端回調僅供參考,以伺服器通知為準 |
UpdateRole() |
上報角色信息 |
登入成功 & 进入游戏後 |
等級、伺服器名稱等 |
Exit() |
退出遊戲 |
用戶點擊退出 |
殺進程或返回桌面 |
2.3 多渠道打包架構
當遊戲需要同時上架多個渠道時(如 App Store、Google Play、華為、三星等),推薦使用抽象層 + 配置文件的架構:
- 統一介面層:遊戲程式碼只調用
SDKManager.Login()、SDKManager.Pay() 等統一接口
- 渠道實現層:底層根據配置文件自動切換為 Apple / Google / 華為等具體實現
- 渠道配置文件:每個渠道一個 JSON 配置,包含
app_id、app_key、pay_id 等參數
✅ 最佳實踐:使用聚合 SDK 平台(如 QuickSDK、TypeSDK)可大幅降低多渠道接入成本,一個抽象層適配所有渠道。
2.4 支付流程安全要點
- 伺服器端驗證:客戶端支付回調不可信,必須由遊戲伺服器向平台伺服器驗證訂單真實性
- 防重放攻擊:訂單 ID 必須唯一,伺服器需做冪等處理
- 掉單處理:支付成功但道具未發放時,需提供補單機制(伺服器主動查詢未結算訂單)
- 退款處理:需監聽平台退款通知(Apple Server Notification / Google RTDN),及時處理虛擬貨幣回收
🇭🇰
港台地區
🍎 三、Apple App Store 運營重點(港台)
3.1 App Store Connect 基礎操作
App Store Connect 是蘋果提供的開發者後台管理平台,核心功能包括:
- App 管理:創建 App、配置元數據(名稱、描述、截圖、關鍵字)、管理版本提交
- 內購管理:配置消耗型/非消耗型/自動續期訂閱商品,設定分區域定價
- TestFlight:內部測試(最多100人)和外部測試(最多10,000人),用於上架前 QA
- 財務報表:查看銷售數據、結算報表、退款信息
- App 分析:下載量、留存、營收等核心指標
- 推廣活動:自定義產品頁面(CPP)、App 內事件、促銷內購
3.2 IAP 內購體系
蘋果強制要求所有數位內容和服務的支付必須使用 IAP(In-App Purchase),平台抽取 15%~30% 佣金。
| 商品類型 |
說明 |
遊戲中的應用 |
消耗型 Consumable |
購買後可使用一次,可重複購買 |
鑽石、元寶、金幣等虛擬貨幣;道具包 |
非消耗型 Non-Consumable |
一次購買,永久有效 |
去廣告、永久VIP、解鎖章節 |
自動續期訂閱 Auto-Renewable |
按週期自動扣款續費 |
月卡、周卡、Battle Pass |
非續期訂閱 Non-Renewing |
固定時限,不自動續費 |
較少使用,遊戲中一般用自動續期替代 |
3.3 訂閱優惠體系
| 優惠類型 |
目的 |
適用對象 |
折扣形式 |
推介促銷優惠 Introductory Offer |
獲取新用戶 |
從未訂閱過的新用戶 |
免費試用 / 隨用隨付 / 提前支付 每個訂閱組只能用一次 |
促銷優惠 Promotional Offer |
留住猶豫用戶 |
已訂閱或曾訂閱的用戶 |
通過優惠碼(Offer Code)發放 |
回頭客優惠 Win-Back Offer |
贏回流失用戶 |
已取消訂閱的用戶 |
定向折扣優惠 |
優惠碼 Offer Codes |
靈活發放 |
任意指定用戶 |
一次性碼 / 自定義碼 適用所有內購類型 |
💡 三種折扣形式:
• 免費試用(Free Trial):指定時長內免費,到期自動按標準價續費
• 隨用隨付(Pay As You Go):每期折扣價,如前3個月每月$1.99(原價$9.99)
• 提前支付(Pay Up Front):一次性付費享受指定時長,如$9.99享6個月
3.4 App Store 推廣功能
- App 內事件(In-App Events):在 App Store 展示遊戲內活動(如限時活動、賽季開啟),可附帶截圖和宣傳語,直接出現在 Today / Games 頁面
- 推廣內購(Promoted IAP):最多同時推廣20個內購商品到 App Store 產品頁面,用戶可直接在商店頁購買;需實現
PurchaseIntent API
- 自定義產品頁面(Custom Product Pages, CPP):最多創建70個不同版本的產品頁面,針對不同活動/受眾展示不同截圖和預覽視頻,可綁定關鍵字
3.5 年齡分級
蘋果採用自評分级制,開發者在 App Store Connect 填寫分級問卷,系統自動計算分級:
| 分級 | 說明 | 典型遊戲類型 |
| 4+ | 適合所有年齡 | 休閒消除、兒童教育 |
| 9+ | 可能含輕度卡通暴力 | 模擬經營、塔防 |
| 12+ | 頻繁卡通暴力或輕度真實暴力 | 策略 RPG |
| 16+ | 頻繁真實暴力、模擬賭博 | SLG、射擊 |
| 18+ | 成人內容 | 真錢博彩、露骨內容 |
⚠️ 港台注意事項:台灣《遊戲軟體分級管理辦法》要求遊戲分級須符合當地標準。App Store 分級與台灣本地分級可能不完全對應,建議以當地法規為基準,確保分級準確。
3.6 審核重點
- 隱私政策:必須提供完整的隱私政策 URL,明確說明數據收集和用途
- ATT 彈窗:iOS 14.5+ 追蹤用戶 IDFA 必須彈出授權請求(App Tracking Transparency)
- 帳號註銷:如果 App 支援創建帳號,必須同時提供帳號刪除功能(App Store 審核指南 5.1.1(v))
- 內購規範:所有數位內容必須走 IAP,禁止引導用戶到外部網站支付
- 元數據規範:截圖、描述中不得包含測試文字、佔位符或不實宣傳
🟢 四、Google Play 運營重點(港台)
4.1 Google Play Console 基礎操作
Google Play Console 是 Google 的開發者後台,核心功能包括:
- App 管理:創建 App、配置商店 listing(名稱、描述、截圖、特色圖)
- 版本管理:管理正式版 / 測試版發布,配置分階段推送
- 內購管理:配置應用內商品和訂閱,設定分區域定價
- 財務報表:銷售數據、訂單管理、退款處理
- 用戶評價管理:回覆用戶評論、查看評分趨勢
- 政策合規:內容分級問卷、數據安全表單、廣告聲明
4.2 Google Play Billing 內購體系
港台地區 Google Play 強制要求所有應用內數位商品購買必須使用 Google Play Billing,平台抽取 15%~30% 佣金。
🚫 重要:台灣 Google Play 已封殺第三方支付(如 MyCard、Gash 等點數支付),所有內購必須通過 Google Play 結算服務(Google 錢包)。僅實體商品或可在 App 外使用的數位商品可使用其他支付方式。
🍎 Apple 支付要點
- 佣金:首年 15%(小企業計畫),超$1M 為 30%
- 僅支持 IAP,無任何第三方支付空間
- 退款由 Apple 處理,開發者無法控制
- 結算週期:約45天
- 訂閱可使用優惠碼、促銷優惠等
🟢 Google 支付要點
- 佣金:首$1M 收入 15%,超出 30%
- 港台強制使用 Google Play Billing
- 退款可通過 Google Play Console 管理
- 結算週期:約30天
- 支持促銷代碼(每季度最多50萬個)
4.3 Google Play 促銷代碼(Redeem Codes)
Google Play Console 支持創建促銷代碼,用途廣泛:
- 測試:發放給 QA 團隊測試付費功能
- KOL 合作:發放給網紅/YouTuber 體驗付費內容
- 活動贈送:社交媒體抽獎、社群活動獎勵
- 用戶維護:作為老用戶忠誠度回饋
操作路徑:Play Console → 營利 → 促銷 → 創建促銷活動
- 可選類型:一次性使用碼 / 自定義碼
- 適用範圍:App 本身 / 應用內商品 / 訂閱
- 每季度上限:500,000 個代碼
- 僅已發布且包含付費項目的 App 可創建
4.4 預註冊(Pre-Registration)
遊戲上線前可開放預註冊,讓用戶提前登記,上線時自動收到通知並安裝。
🎮
Step 1 · 創建預註冊商品 ID
在 Google Play Console 創建預註冊商品 ID
⚙️
Step 2 · 配置預註冊
在發行後台配置預註冊 ID 和獎勵內容
🎯
Step 3 · 創建促銷活動
填入預註冊商品 ID
🎁
Step 5 · 用戶領取獎勵
用戶兌換代碼 → 重新啟動遊戲 → 收到預註冊獎勵
4.5 測試軌道
| 測試類型 |
人數上限 |
說明 |
內部測試 Internal Testing |
最多100人 |
團隊內部測試,不需審核,即時部署 |
封閉測試 Closed Testing |
自定義 |
指定郵件列表或群組的用戶參與 |
公開測試 Open Testing |
不限 |
任何用戶可加入,等同 Beta 版 |
⚠️ Google 支付測試注意:測試需要海外 VPN;需要在 Google 後台添加測試帳號(兩處);測試帳號需接受測試邀請;productID 在 Google 後台配置和發行後台配置必須一致。
4.6 內容分級(IARC)
Google Play 使用 IARC(國際年齡分級聯盟)問卷系統,開發者填寫問卷後自動生成分級:
- 問卷涵蓋暴力、成人內容、賭博、語言等維度
- 分級結果影響 App 在哪些地區/年齡段可被搜索和下載
- 2025年更新:問卷僅評估 App 本身內容,不包括廣告;但廣告內容成熟度不得高於 App 分級
4.7 港台審核重點
- 數據安全表單:必須在 Console 中填寫數據收集和使用聲明
- 廣告聲明:如包含廣告需如實聲明,廣告內容不得超過 App 分級
- 繁體中文本地化:商店 listing 建議提供繁體中文版本,提升轉化率
- 年齡限制功能:涉及社交配對、博彩等內容的 App 必須實現功能級年齡屏蔽
📋 五、港台地區運營要點
5.1 支付與財務
- iOS / Android 貨幣隔離:雙端充值幣建議隔離管理(iOS充值幣 / Android充值幣),避免跨平台結算複雜化
- 定價策略:港台用戶付費意願較高,但對性價比敏感;可參考當地市場競品定價
- 發票/收據:台灣用戶習慣索取電子發票,遊戲內購需考慮發票開立需求
5.2 合規要求
- 台灣《個人資料保護法》:收集用戶數據需明確告知目的,取得同意
- 香港《個人資料(私隱)條例》:類似 GDPR 思路,保障用戶數據權利
- 遊戲分級:台灣有專門的遊戲軟體分級管理辦法,需符合當地分級標準
- 機率公示:台灣要求抽獎/轉盤類玩法必須公示機率
5.3 本地化建議
- 界面語言:必須提供繁體中文,建議同時提供英文
- 客服:建議提供繁體中文客服支持
- 節日運營:注意台灣/香港特有假期(如佛誕、重陽節、雙十節等)
- 社交媒體:Facebook 為港台主要社交平台,可搭配 LINE(台灣)/ WhatsApp(香港)進行社群運營
⚖️
港台 vs 泰國 核心差異對照
📊 九、核心差異一覽
| 維度 |
🇭🇰 港台地區 |
🇹🇭 泰國地區 |
| 語言 |
繁體中文 + 英文 |
泰文 + 英文 |
| 付費能力 |
高,LTV 基線較好 |
較低,LTV 約為港台的 7%~9% |
| 付費偏好 |
接受常規定價包 |
偏好限時小額付費包 |
| 安卓留存 |
與 iOS 差距較小 |
安卓留存明顯低於 iOS,是短板 |
| 新手流失 |
正常水平 |
高於港台,需加強引導 |
| 隱私法律 |
台灣個保法 / 香港私隱條例 |
PDPA(類似 GDPR) |
| 遊戲分級 |
台灣有獨立分級制度 |
使用 IARC 分級 + 本地審查 |
| 支付強制 |
雙端均強制平台內購 |
雙端均強制平台內購 |
| 社交主陣地 |
Facebook + LINE(台) / WhatsApp(港) |
LINE + Facebook |
| 文化敏感點 |
政治敏感話題 |
皇室(冒犯君主法)、佛教元素 |
| 機率公示 |
台灣要求公示 |
要求公示 |
| 時區 |
UTC+8(與北京一致) |
UTC+7(比北京慢1小時) |