快應(yīng)用統(tǒng)計(jì)接入
1.登錄輕粒子官網(wǎng)饲常，申請(qǐng)app_key
注冊(cè)賬號(hào)并登錄 輕粒子官網(wǎng) 在 “ 我的快應(yīng)用 ” 頁面點(diǎn)擊創(chuàng)建快應(yīng)用蹲堂，成功創(chuàng)建快應(yīng)用后即可獲取到對(duì)應(yīng)快應(yīng)用 app_key。
2.接入 SDK
2.1 下載SDK[點(diǎn)擊下載]
下載 SDK文件并解壓贝淤，將其中的 appStatistics.min.js柒竞、statistics.config.js 拷貝到app.ux同級(jí)的目錄（src目錄下）。
2.2 SDK 導(dǎo)入項(xiàng)目
把?sdk?中的?appStatistics.min.js播聪、statistics.config.js?拷貝到項(xiàng)目中和?app.ux?同級(jí)的目錄朽基。
2.3 配置 app_key
用編輯器打開?statistics.config.js?，填入從官網(wǎng)獲取的?app_key?：
exportdefault{'app_key':'0000000000000'//請(qǐng)?jiān)诖诵刑顚懡y(tǒng)計(jì)平臺(tái)獲取的 app_kye}
2.4 權(quán)限依賴
2.4.1 添加接口權(quán)限
在您項(xiàng)目中的?manifest.json?文件中的?features?屬性中添加權(quán)限聲明代碼离陶。如下：
// manifest.json 文件"features":[{"name":"system.fetch"},{"name":"system.storage"},{"name":"system.device"},{"name":"system.network"},{"name":"service.account"},{"name":"system.shortcut"}]
2.5 引入 SDK 代碼
在項(xiàng)目的?app.ux?文件的?script?標(biāo)簽中引入統(tǒng)計(jì)代碼：
// app.ux 文件import"./appStatistics.min.js"
2.6 添加打點(diǎn)代碼
2.6.1 初始化打點(diǎn)
在?app.ux?的?onCreate?函數(shù)頂部（其他代碼之前）稼虎，增加統(tǒng)計(jì)打點(diǎn)代碼：
// app.ux 文件<script>import"./appStatistics.min.js"exportdefault{onCreate:function(){//統(tǒng)計(jì)打點(diǎn)APP_STATISTICS.app_sta_init(this);// 其他業(yè)務(wù)代碼...}}</script>
2.6.2 頁面打點(diǎn)
在快應(yīng)用的所有頁面文件（?manifest.json 中 router > pages?對(duì)象下聲明的頁面對(duì)應(yīng)的.ux文件中 ）中增加統(tǒng)計(jì)代碼，有兩種接入方法：
方法一：在 App 中每個(gè)路由頁面的onShow和onHide方法中調(diào)用APP_STATISTICS.page_show()和APP_STATISTICS.page_hide()方法招刨，添加如下代碼:
// 頁面文件 xx.ux<template><div><text>這是首頁</text></div></template><script>exportdefault{onShow(){APP_STATISTICS.page_show(this);//在onShow方法的第一行加入此代碼//App業(yè)務(wù)代碼},onHide(){APP_STATISTICS.page_hide(this);//在onHide方法的第一行加入此代碼//...業(yè)務(wù)代碼}data:{a:1,b:[]},onInit(){//...業(yè)務(wù)代碼},onReady(){//業(yè)務(wù)代碼...}}</script>
方法二：這種方式更加簡(jiǎn)潔霎俩，開發(fā)者無需自己調(diào)用?APP_STATISTICS.page_show()和APP_STATISTICS.page_hide()?方法，而是通過?sdk?提供的的全局函數(shù)?Custom_page()?實(shí)頁面計(jì)埋點(diǎn)沉眶。參考代碼如下:
// 頁面文件 xx.ux<template><div><text>這是首頁</text></div></template><script>exportdefaultCustom_page({data:{a:1,b:[]},onInit(){//業(yè)務(wù)代碼...},onReady(){//業(yè)務(wù)代碼...}//業(yè)務(wù)代碼...})</script>
2.7 接入完成
確認(rèn)完成以上步驟之后打却，就可以使用我們提供的基礎(chǔ)統(tǒng)計(jì)統(tǒng)計(jì)功能啦。關(guān)于如何檢查統(tǒng)計(jì)?sdk?接入是否成功請(qǐng)移步 “FAQ常見問題”沦寂。
3. 注意事項(xiàng)
一個(gè)?app_key?只能對(duì)應(yīng)一個(gè)快應(yīng)用学密，請(qǐng)不要重復(fù)使用淘衙，否則會(huì)造成數(shù)據(jù)不準(zhǔn)確传藏；
確保在路由中配置的所有頁面都增加統(tǒng)計(jì)代碼，否則會(huì)造成數(shù)據(jù)不準(zhǔn)確、統(tǒng)計(jì)數(shù)據(jù)缺失毯侦；
請(qǐng)開發(fā)者慎重調(diào)用?storage.clear(OBJECT)?接口哭靖！統(tǒng)計(jì)SDK會(huì)將用戶相關(guān)操作數(shù)據(jù)緩存在客戶端數(shù)據(jù)存儲(chǔ)模塊。若調(diào)用該接口可導(dǎo)致數(shù)據(jù)統(tǒng)計(jì)不準(zhǔn)確的問題侈离。
