###### tags: `打點`
# 達卡拉打點文件
[TOC]

## 客戶端 使用WebApi 打點
## 建議打點時機
- 玩家點擊訪客或Google登入 ClientBaseInfo
- 下載資源時開始打點 ClientBaseInfo
- 下載速度打點 ClientBaseInfo、網速
- 每下載%dMB打點 ClientBaseInfo (建議10MB為單位)
- 新手引導的每次推進流程的點擊
- 新手引導時每次強制引導的Mask啟動
- 新手引導時每次強制引導的Mask事件點擊結束

---

## 事件ID
定義打點類型。

P.S. 編號規則：

區間
** 大Group => 1000 or 10000 區間
** 小Group => 100 區間
** 同一Group的不同項目 => 10 區間
** 同一項目的不同步驟 => 1 區間
結尾
** 初始化orUI顯示紀錄 => 0結尾
** 步驟開始 => 1 結尾
** 失敗 => 9 結尾

SDKLoginEnabled = 10010            //SDK登入介面開啟
SDKLoginStart = 10011              //SDK登入開始
SDKLoginSuccessed = 10012          //SDK登入成功
SDKLoginFailed = 10019             //SDK登入失敗

LSLoginStart = 10111               //LS登入開始(Extra:UID)
LSLoginSuccessed = 10112           //LS登入成功
LSLoginFailed = 10119              //LS登入失敗(Extra:IsError)

SMFConnectStart = 10211            //SMF連線開始
SMFConnectSuccessed = 10212        //SMF連線成功
SMFConnectFailed = 10219           //SMF連線失敗
SMFLoginStart = 10221              //SMF登入開始
SMFLoginSuccessed = 10222          //SMF登入成功
SMFLoginFailed = 10229             //SMF登入失敗
SMFConnectLost = 10299             //SMF斷線

GSLoginEnabled = 10310             //GS登入介面開啟(Extra:ServerID清單)
GSLoginStart = 10311               //GS登入開始(Extra:選擇ServerID)
GSLoginSuccessed = 10312           //GS登入成功
GSLoginFailed = 10319              //GS登入失敗

BundleLoadingStart = 11011         //Bundle載入開始
BundleLoadingFinished = 11012      //Bundle載入完成
BundleLoadingFailed = 11019        //Bundle載入失敗

GuideStart = 12101                 //新手教學步驟開始
GuideEnd = 12102                   //新手教學步驟結束
GuideFailed = 12109                //新手教學步驟失敗
    
UnlockReady = 13000,                //系統可以解鎖
UnlockStart = 13001,                //系統解鎖封包送出
UnlockSuccessed = 13002,            //系統解鎖封包成功
UnlockClick = 13003,                //系統鎖定狀態被點擊
UnlockFailed = 13009,               //系統解鎖封包失敗

## 基本結構(Protocol)

struct LogInfo
{
    int EventID                //事件ID
    string ClientTime          //客戶端時間
    long GameTime              //遊戲內時間
    string ClientLocale        //客戶端語系(台版/美版...etc)
    string ClientDeviceType    //客戶端裝置類型(iOS / Android...etc)
    string ClientDeviceId      //客戶端裝置uuid
    
    long AccountId             //玩家帳號(GameServer登入前為0)
    string LoginChannel        //登入渠道(SDK登入前為空)
    
    string BaseInfo            //其他基礎資訊(json)
    string ExtraInfo           //事件額外資訊(json)
}

## BaseInfo

struct BaseInfo
{
    string ClientVersion        //客戶端使用版本
    string ClientDeviceName     //客戶端裝置名稱
    string ClientDeviceModel    //客戶端裝置型號
    string ClientIP             //客戶端IP
    string ClientOS             //客戶端作業系統含版本資訊
    string NetworkType          //網路環境
    
    string Nickname             //玩家暱稱(GameServer登入前為空)

    string Country              //所在國家
    int CurrentStage            //玩家目前的主線進度(GameServer登入前為空)
	
    //不一定需要
    string RegisterTime         //玩家帳號註冊時間
    string RegisterCountry      //註冊時所在國家
}