国产99久久久国产精品成人小说_高清一区二区亚洲欧美日韩_天堂…在线最新版资源_强奷漂亮脱肉丝袜视频大全_国内精品久78视频_91免费观看在线网址_(凹凸18+)国产一级a爱做片免费观看_亚洲天堂在线免费短视频_国产日韩新片无码一区_亚洲av一级福利精品麻豆

SDK 接入概要

初始化接口
void init ( ... );

確保在調(diào)用其他接口之前正確調(diào)用 AppLogger::init 接口,僅在第一次調(diào)用時有效;

Android 下通常在 第一個 Activity 的 onCreate() 中調(diào)用初始化接口;

事件接口調(diào)用結(jié)構(gòu)
						
onStart // 應(yīng)用啟動
    onSubStart // 關(guān)卡或頁面的開始
        // 關(guān)卡中發(fā)生的事件
        onBuy, onUse, onEvent … 等事件接口
        onPassFail 關(guān)卡成功或失敗
    onSubEnd // 關(guān)卡或頁面的結(jié)束
    
    // 關(guān)卡外發(fā)生的事件
onEnd // 應(yīng)用退出,Back按鍵強(qiáng)制退出調(diào)用onExit
					

onStart, onEnd 在 iOS 版本的SDK中自動調(diào)用。

onSubStart, onSubEnd 表示一個關(guān)卡/頁面的開始與結(jié)束,可以嵌套,但不能交叉。

onSubStart 的第一個參數(shù)stage是關(guān)卡名稱,用版本號的形式,例如 “1”, “2”, “2.1”, “2.2”, … 。如果是字母開始,作為頁面。

獲取 APPKEY

1,登錄 天梯游戲統(tǒng)計 后臺,進(jìn)入我的應(yīng)用界面,在應(yīng)用匯總窗口點(diǎn)擊 “創(chuàng)建新應(yīng)用”。如圖:

創(chuàng)建新應(yīng)用截圖

2,輸入應(yīng)用的相關(guān)信息后,點(diǎn)擊 “提交應(yīng)用”,即可。如圖:

提交應(yīng)用截圖

3,得到唯一的 APPKEY,接入 SDK 時使用。如圖:

APPKEY截圖

iOS SDK 導(dǎo)入

Xcode 導(dǎo)入
1,目錄下包含下面文件:

libs/ios/liblogger.a
libs/ios/liblogger_c11.a
AppLogger.h
					

在 liblogger.a 和 liblogger_c11.a 之間,根據(jù)你的編譯設(shè)置選擇一個,連同 AppLogger.h 放到工程項(xiàng)目目錄下,并將 .a 和 .h 文件拖拽到項(xiàng)目工程中。

(liblogger.a 和 liblogger_c11.a 的選擇詳見下面的說明。)

2,選擇 liblogger.a 或者 liblogger_c11.a

由于開發(fā)者選用的 C++ 標(biāo)準(zhǔn)庫可能有所不同,所以我們對 liblogger 也做了對應(yīng)的區(qū)分,分別為:

2.1 如果使用 GNU C++ Standard Library (如下圖),使用 liblogger.a。

AppLogger_c99

2.2 如果使用 LLVM C++ Standard Library (如下圖)或者 Complier Default,使用 liblogger_c11.a。

AppLogger_c11
提示: 在 Build Settings 中搜索 C++ Standard Library,即可查看自己的設(shè)置
3,添加依賴框架

在 TARGETS > Build Phases > Link Binary With Libraries 下添加下面四個 framework:

						
SystemConfiguration.framework
CoreTelephony.framework
Security.framework
CFNetwork.framework
					
4,代碼中初始化 SDK

在 didFinishLaunchingWithOptions 或者 ViewController 的 viewDidLoad 下添加 AppLogger::init。

提示:如果與 Android 共享代碼,請保證此函數(shù)只在 iOS 中執(zhí)行

iOS SDK 初始化

定義
void init (const char* appId, const char* appChannel=NULL);

appId: 應(yīng)用的唯一標(biāo)識,在天梯游戲統(tǒng)計后臺創(chuàng)建應(yīng)用時自動生成。具體詳見:獲取 APPKEY

appChannel: 應(yīng)用分發(fā)渠道名 (iOS 版本通常指定為 "AppStore")

功能

初始化數(shù)據(jù)統(tǒng)計服務(wù)

用法

必須指定 appId 和 appChannel,通常指定 appChannel 為"AppStore"

在程序啟動的時候調(diào)用初始化接口,僅在第一次調(diào)用時有效,確保在調(diào)用其他接口之前正確調(diào)用 init 接口

如果需要臨時禁用天梯游戲統(tǒng)計相關(guān)服務(wù),不需要逐一注釋相關(guān)代碼,只需要注釋掉 init 函數(shù)調(diào)用,天梯游戲統(tǒng)計 將不會記錄,保存,傳輸任何數(shù)據(jù),所有接口調(diào)用直接忽略

現(xiàn)在可以登錄 天梯游戲統(tǒng)計 后臺,然后運(yùn)行您的游戲,即可實(shí)時看到當(dāng)前啟動游戲的記錄。實(shí)時心跳數(shù)據(jù),如圖:

運(yùn)行游戲測試

恭喜,基本的統(tǒng)計 SDK 已經(jīng)接入完成!

如果您的項(xiàng)目是關(guān)卡類型游戲或者需要統(tǒng)計分析移動應(yīng)用的具體頁面數(shù)據(jù),您可以繼續(xù)接入 “關(guān)卡與頁面”。

初次接入天梯游戲統(tǒng)計 SDK 建議開啟調(diào)試信息輸出接口 “setDebugLog

關(guān)卡與頁面

關(guān)卡或頁面開始 onSubStart
定義
void onSubStart (const char* name);
功能

進(jìn)入一個關(guān)卡或頁面

用法

在進(jìn)入一個關(guān)卡或頁面時,調(diào)用 onSubStart 接口

onSubStart 事件接口可以幫助統(tǒng)計系統(tǒng)獲得關(guān)卡 新增用戶,活躍用戶,啟動次數(shù),進(jìn)入次數(shù),離開次數(shù),滯留人數(shù),最大關(guān)卡,最后關(guān)卡 等各種指標(biāo)數(shù)據(jù)。如圖:

onSubStart 實(shí)例圖

關(guān)卡/頁面可以嵌套,但不可以交叉。

onSubStart 的第一個參數(shù) stage 是關(guān)卡的名稱,用版本號的形式,例如 “1”, “2”, “2.1”, “2.2”, … 。如果是字母開始的名稱(例如:“MainScene”),將作為頁面統(tǒng)計。

關(guān)卡或頁面結(jié)束 onSubEnd
定義
void onSubEnd (const char* name);
功能

退出指定關(guān)卡或頁面

用法

在退出一個關(guān)卡或頁面時,調(diào)用 onSubEnd 接口

onSubEnd 必須與 onSubStart 匹配

onSubEnd 不能用 STAGE_LAST 參數(shù),必須指定和對應(yīng) onSubStart 一樣的關(guān)卡名稱

關(guān)卡過關(guān)或失敗 onPassFail
定義
void onPassFail (bool bPass);
功能

過關(guān)或失敗

用法

關(guān)卡過關(guān)或失敗時,立即調(diào)用 onPassFail 接口

onPassFail 在 onSubStart 與 onSubEnd 之間調(diào)用

onPassFail 事件接口可以幫助統(tǒng)計系統(tǒng)獲得關(guān)卡的難度等各種細(xì)節(jié)信息,例如,過關(guān)時間,失敗時間,難度 等數(shù)據(jù)

關(guān)卡過關(guān)失敗數(shù)據(jù)對于分析關(guān)卡數(shù)據(jù)非常有意義,強(qiáng)烈建議開發(fā)者及時并正確調(diào)用 onPassFail 接口

關(guān)卡與頁面子事件

所有子事件缺省都算在最后關(guān)卡中(STAGE_LAST)

如果需要把子事件計算到特定關(guān)卡或頁面,請指定子事件中的 stage 參數(shù)

現(xiàn)金購買 onBuy
定義
void onBuy (const char* payService, const char* item, int count, float value, const char* stage = STAGE_LAST);
功能

現(xiàn)金購買虛擬幣, onBuy 事件接口提交的數(shù)據(jù),將作為收入數(shù)據(jù),在后端報表中用各種收入圖表展現(xiàn)。

用法

當(dāng)用現(xiàn)金進(jìn)行購買時,請調(diào)用 onBuy 事件接口

onBuy 事件缺省統(tǒng)計到最后關(guān)卡中,所以你可以看到各個關(guān)卡的各種與收入相關(guān)的數(shù)據(jù),如,收入,新增付費(fèi)用戶,活躍付費(fèi)用戶,當(dāng)天購買用戶

payService: 支付服務(wù)類型,例如:支付寶, paypal, appstore, …

item: 購買的項(xiàng)目

count: 購買數(shù)量,通常是1

value: 購買總價

stage: 發(fā)生事件時的關(guān)卡位置,缺省為最后關(guān)卡(STAGE_LAST)

虛擬貨幣交易 onExchange
定義
void onExchange (const char* item, int count, const char* stage = STAGE_LAST);
功能

虛擬幣兌換為道具

用法

數(shù)據(jù)分析人員可以觀察到各個關(guān)卡的兌換次數(shù),兌換項(xiàng)目等詳細(xì)數(shù)據(jù),以及各個數(shù)據(jù)的分布狀況

item: 兌換的項(xiàng)目

count: 兌換數(shù)量,通常是1

stage: 發(fā)生事件時的關(guān)卡位置,缺省為最后關(guān)卡(STAGE_LAST)

道具使用 onUse
定義
void onUse (const char* item, int count, const char* stage = STAGE_LAST);
功能

使用道具或點(diǎn)數(shù)

item: 使用的物品(或點(diǎn)數(shù))名稱,例如道具名稱

count: 使用的物品的數(shù)量

stage: 使用的位置,關(guān)卡或頁面名稱

收集 onCollect
定義
void onCollect (const char* item, int count, const char* stage = STAGE_LAST);
功能

收集點(diǎn)數(shù)/道具

item: 收集的物品(或點(diǎn)數(shù))名稱,例如道具名稱

count: 收集的物品的數(shù)量

stage: 收集的位置,關(guān)卡或頁面名稱

獎勵 onReward
定義
void onReward (const char* item, int count, const char* stage = STAGE_LAST);
功能

獎勵虛擬幣或道具

用法

發(fā)生獎勵行為時,立即調(diào)用 onReward 接口

item: 獎勵的物品(或點(diǎn)數(shù))名稱,例如道具名稱

count: 獎勵的物品的數(shù)量

stage: 獎勵的位置,關(guān)卡或頁面名稱

分享 onShare
定義
void onShare (const char* service, const char* item, const char* stage = STAGE_LAST);
功能

分享到社交服務(wù)上

用法

當(dāng)用戶進(jìn)行分享操作時,立即調(diào)用 onShare 事件接口

service: 分享服務(wù)的名稱,例如,weibo, qq, weixin, …

item: 分享的項(xiàng)目名稱

stage: 分享的位置,關(guān)卡或頁面名稱

產(chǎn)出與消耗(游戲平衡) onBalance
定義
void onBalance (const char* name, const char* item, int value, const char* stage = STAGE_LAST);
功能

游戲內(nèi)虛擬貨幣的產(chǎn)出與消耗數(shù)據(jù)分析,通過產(chǎn)出與消耗可以觀察游戲平衡情況。

用法

name 用 +,- 符號前綴,聲明是產(chǎn)出或消耗。

玩家分享獎勵: onBalance ("+寶石", "獎勵", 100);

玩家購買時裝: onBalance ("-寶石", "時裝A", 200);

升級事件(玩家/角色/寵物) onLevelUp
定義
void onLevelUp (const char* name, const char* oldLevel, const char* newLevel, const char* stage = STAGE_LAST);
功能

玩家/角色/寵物的等級變化事件,統(tǒng)計玩家等級分布

用法

級別(oldLevel, newLevel)建議用版本號形式

自定義事件 onEvent
定義
void onEvent (const char* name, const char* stage = STAGE_LAST);
功能

用戶自定義事件

用法

自定義事件將以列表形式羅列出來,并顯示最近幾天的自定義事件變化

自定義事件可以是一個簡單的名稱,例如 dm_show,也可以是包含 / 的多級名稱,例如 main/dm_show, main/dm_close, …

對于 main/dm_show 形式的事件,在統(tǒng)計報表中將把所有 main/ 開頭的時間一起對比顯示。

所以如果想對比觀察一組事件,可以給這些事件一個一樣的分組名稱作為前綴,并用 / 分隔。

事件列表:

onEvent 實(shí)例圖

相同前綴的事件之間對比:

onEvent 實(shí)例圖

在線參數(shù)

啟用在線參數(shù)
定義
void enableOnlineConfig ();
功能

啟用在線參數(shù)同步功能,缺省不啟用在線參數(shù)功能

用法

在 init 接口后調(diào)用 enableOnlineConfig

在線參數(shù)在應(yīng)用統(tǒng)計的后臺管理,添加參數(shù)時可以指定當(dāng)前參數(shù)的有效期。

客戶端每次啟動或者從后臺切換到前臺時自動更新在線參數(shù),并且最小更新間隔為15分鐘。

獲取在線參數(shù)
定義
string getOnlineConfig (string key, string defaultValue="");
功能

獲得某個在線參數(shù)的具體數(shù)據(jù),如果沒有指定,返回 defaultValue

用法

先調(diào)用 enableOnlineConfig,然后可以任意多次調(diào)用 getOnlineConfig

服務(wù)器可以指定在線參數(shù)的 key 和 數(shù)據(jù),類型由客戶端自己處理

服務(wù)器端可以指定在線參數(shù)的有效期,如果在有效期之外,相當(dāng)于服務(wù)器沒有定義該參數(shù),返回缺省值

存量數(shù)據(jù)統(tǒng)計

清除存量數(shù)據(jù)
定義
void clearStatus();
功能

清除所有存量數(shù)據(jù)

在需要清除所有存量數(shù)據(jù)時調(diào)用
設(shè)置存量數(shù)據(jù)
定義
void setStatus(const char* key, int value, bool bAutoConvert = true);
功能

設(shè)置存量數(shù)據(jù),服務(wù)器端將對存量數(shù)據(jù)自動分區(qū)間統(tǒng)計,或根據(jù)指定的區(qū)間統(tǒng)計

例如:玩家當(dāng)前有多少寶石,用了多少寶石,收集了多少寶石等等這類長期累積的數(shù)據(jù)可以通過 setStatus 的接口統(tǒng)計。

用法

通常在 init 之后盡快調(diào)用 setStatus 接口,把客戶端的累計存量數(shù)據(jù)匯報給服務(wù)器

存量數(shù)據(jù)每天第一次啟動的時候提交到服務(wù)器

存量數(shù)據(jù)設(shè)置后會保存下來,下次啟動如果沒有更新,自動使用之前設(shè)置的數(shù)據(jù),除非重新設(shè)置或clearStatus

通常在應(yīng)用啟動后,客戶端持續(xù)存量數(shù)據(jù)加載后立即調(diào)用 AppLogger::setStatus 接口

持續(xù)狀態(tài)變更時也立即調(diào)用 AppLogger::setStatus 接口

SDK 在每天第一次啟動時自動同步數(shù)據(jù)到服務(wù)器,不會導(dǎo)致數(shù)據(jù)重復(fù)統(tǒng)計

開發(fā)者

啟用錯誤統(tǒng)計
定義
void enableCrashReport();
功能

啟用錯誤統(tǒng)計,捕捉應(yīng)用中發(fā)生崩潰時的堆棧信息,用于定位程序中引起錯誤的代碼,缺省為不啟用崩潰統(tǒng)計

用法

在 init 接口之后調(diào)用 enableCrashReport

需要把其他統(tǒng)計服務(wù)的錯誤收集功能關(guān)閉,例如:

友盟:setCrashReportEnabled

TalkingData:setExceptionReportEnabled

日志輸出設(shè)置
定義
void setDebugLog (int mode, int level);
功能

調(diào)試信息輸出控制

用法

mode 與 level 具體定義:

							
#define DEBUG_OFF       0    //不輸出調(diào)試信息
#define DEBUG_LOGCAT    1    //輸出到 logcat(用于聯(lián)機(jī)調(diào)試)
#define DEBUG_LOGFILE   2    //輸出到 文件(applogger.log), 用于脫機(jī)調(diào)試
#define DEBUG_LOGALL    3    //輸出到 logcat 和 文件(applogger.log)

#define DEBUG_LEVEL_VERBOSE    0    //輸出所有級別調(diào)試信息
#define DEBUG_LEVEL_INFO       1    //輸出INFO級別以上調(diào)試信息
#define DEBUG_LEVEL_WARN       2    //輸出WARN級別以上調(diào)試信息
#define DEBUG_LEVEL_ERROR      3    //輸出ERROR級別以上調(diào)試信息
					
開發(fā)者可以使用 AppDebug::info, AppDebug::warn, AppDebug::error 等接口輸出調(diào)試信息到指定輸出上

其他

啟動間隔控制參數(shù)
定義
void setSessionInterval (int v);
功能

設(shè)置合并間隔,當(dāng)上次退出時間與本次啟動時間間隔小于該參數(shù)所指定的值時,合并上次與本次啟動

為與其他統(tǒng)計工具保持一致,缺省情況下,在iOS 下間隔時間為0(不合并),Android 下間隔時間為30秒
聯(lián)網(wǎng)控制
定義
void setOnline (bool online);
功能

一般僅用于小范圍測試時(如,玩家輸入邀請碼才能進(jìn)入游戲)。邀請碼驗(yàn)證通過后,才算正常初始化 SDK

setOnline 接口應(yīng)在初始化(init)之前調(diào)用。

啟動時,調(diào)用 setOnline 接口設(shè)為 false,邀請碼驗(yàn)證通過后,setOnline 設(shè)為 true。

玩家/用戶參數(shù)
定義
void setUser (const char* level, int age = -1, const char* gender = NULL, const char* userId = NULL, const char* userService = NULL);
功能

設(shè)置用戶信息,包括用戶級別,年齡,性別, …

SDK 接口調(diào)用檢查

						
onStart // 應(yīng)用啟動
    onSubStart // 關(guān)卡或頁面的開始
        // 關(guān)卡中發(fā)生的事件
        onBuy, onUse, onEvent … 等事件接口
        onPassFail 關(guān)卡成功或失敗
    onSubEnd // 關(guān)卡或頁面的結(jié)束
    
    // 關(guān)卡外發(fā)生的事件
onEnd // 應(yīng)用退出,Back按鍵強(qiáng)制退出調(diào)用onExit
					

onStart, onEnd 在 iOS 版本的SDK中自動調(diào)用。

onSubStart, onSubEnd 表示一個關(guān)卡/頁面的開始與結(jié)束,可以嵌套,但不能交叉。

onSubStart 的第一個參數(shù)stage是關(guān)卡名稱,用版本號的形式,例如 “1”, “2”, “2.1”, “2.2”, … 。如果是字母開始,作為頁面。