操作說明

1.快速集成

在QuickTracking后臺(tái)，為每一個(gè)小程序生成了專屬的集成代碼，可以根據(jù)產(chǎn)品內(nèi)的引導(dǎo)進(jìn)行集成。

產(chǎn)品路徑

Quick Tracking「首頁」-「管理控制臺(tái)」，在「管理控制臺(tái)」進(jìn)入「組織列表」功能，組織列表展示當(dāng)前已創(chuàng)建的組織，找到應(yīng)用歸屬組織，點(diǎn)擊「管理應(yīng)用」功能跳轉(zhuǎn)到「應(yīng)用管理]頁面，在已創(chuàng)建好的應(yīng)用小愛點(diǎn)擊去「去集成」。

點(diǎn)擊「去集成」按鈕跳轉(zhuǎn)到新頁面可以獲取專屬集成代碼，點(diǎn)擊下一步按引導(dǎo)進(jìn)入到「集成校驗(yàn)」，確認(rèn)集成是否成功。

2 集成代碼明細(xì)

如果因?yàn)樘囟ㄔ颍瑹o法抵達(dá)上述頁面，需要觀看文檔才可以進(jìn)行集成，具體集成代碼如下：

2.1 參數(shù)準(zhǔn)備

appkey：在應(yīng)用列表中獲取

收數(shù)域名：在“管理控制臺(tái)-采集信息”模塊中獲取

SDK鏈接：在“管理控制臺(tái)-采集信息”模塊中獲取

2.2 SDK引入

點(diǎn)擊SDK鏈接，將鏈接內(nèi)JS文件導(dǎo)入工程內(nèi)部。（建議導(dǎo)入路徑為src/utils）

const aplusConfig = {
	metaInfo: {
	'appKey': '', //平臺(tái)系統(tǒng)中創(chuàng)建應(yīng)用時(shí)填寫的Appkey, 必填
	'aplus-rhost-v': '', //采集日志上報(bào)域名，必填
	'DEBUG': true, //是否展示采集日志
	}
};
//聲明aplus采集sdk全局變量
const aplus = require('./utils/aplus_mini')(aplusConfig);

2.3 設(shè)置設(shè)備ID

由于小程序框架限制，QuickTracking SDK未自動(dòng)生成任何設(shè)備ID，需要開發(fā)者授權(quán)QuickTracking自動(dòng)獲取openid，或者開發(fā)者獲取openid/unionid等官方小程序ID后手動(dòng)上傳作為設(shè)備ID，否則，QT SDK將無法進(jìn)行任何日志上報(bào)。

手動(dòng)上傳方式如下：

// inside app.js
const aplusConfig = {
	metaInfo: {
		... //sdk部分配置
		'_hold': 'BLOCK' //阻塞日志上報(bào)，待openid&unionid成功獲取后再上報(bào)
		... //sdk部分配置
	}
};
//聲明aplus采集sdk全局變量
const aplus = require('./utils/aplus_mini')(aplusConfig);
		
wx.login({
	success: (res) => {
	// 通過 code 換取openid
		if (res.code) {
				wx.request({
					url: 客戶業(yè)務(wù)側(cè)后端獲取openid的接口,
					method: "post",
					data: {
						code: res.code,
					},
					success: (res) => {
						if (res.data && res.data.openid) {
								// 獲取的 openid 存入storage，方便之后使用
								wx.setStorageSync("openId", res.data.openid);
								wx.setStorageSync("unionId, res.data.unionid);

								getApp().aplus.aplus_queue.push({
									action: 'aplus.setMetaInfo',
									arguments: ['_anony_id', res.data.openid]
								});

						} else {
							getApp().aplus.aplus_queue.push({
								action: 'aplus.setMetaInfo',
								arguments: ['_anony_id', 業(yè)務(wù)側(cè)自己待實(shí)現(xiàn)的偽id]
							});
						}
				},
			});
		}
	},
	fail: () => {
		// 失敗提示信息等
	},
	complete: () => {
		getApp().aplus.aplus_queue.push({
			action: 'aplus.setMetaInfo',
			arguments: ['_hold', 'START']
		});
	},
});

自動(dòng)獲取微信小程序openid方式如下：

目前QuickTracking支持自動(dòng)采集微信小程序openid，需要在產(chǎn)品中進(jìn)行授權(quán)。授權(quán)方式如下，點(diǎn)擊后按照要求填寫內(nèi)容即可。

授權(quán)后，設(shè)置設(shè)備ID代碼方式為：

const aplusConfig = {
	metaInfo: {
		... //sdk部分配置
		'autoGetOpenid': true //開啟openid自動(dòng)采集  
		... //sdk部分配置
	}
};
//聲明aplus采集sdk全局變量  
const aplus = require('./utils/aplus_mini')(aplusConfig);

如果之前已經(jīng)使用了手動(dòng)設(shè)置openid，現(xiàn)希望改為上述的QuickTracking自動(dòng)采集微信小程序openid，還需要注意以下內(nèi)容：

1. 移除metainfo中設(shè)置_hold=BLOCK的SDK阻塞上報(bào)邏輯

2. 注釋掉之前手動(dòng)設(shè)置「_anony_id=openid」的相關(guān)邏輯代碼，也就是移除從wx.login中獲取openid的相關(guān)代碼。

3. 注意，務(wù)必確保關(guān)于設(shè)置appKey和收數(shù)域名的內(nèi)容不受影響。

示例代碼如下：

// inside app.js
const aplusConfig = {
	metaInfo: {
		... //sdk部分配置
    
    //1.移除設(shè)置_hold=BLOCK的SDK阻塞上報(bào)邏輯
		//'_hold: 'BLOCK' //阻塞日志上報(bào)，待openid&unionid成功獲取后再上報(bào)
    
		... //sdk部分配置
	}
};
//聲明aplus采集sdk全局變量
const aplus = require('./utils/aplus_mini')(aplusConfig);

/**
2.移除 wx.login中獲取openid的相關(guān)代碼
wx.login({
	success: (res) => {
	// 通過 code 換取openid
		if (res.code) {
				wx.request({
					url: 客戶業(yè)務(wù)側(cè)后端獲取openid的接口,
					method: "post",
					data: {
						code: res.code,
					},
					success: (res) => {
						if (res.data && res.data.openid) {
								// 獲取的 openid 存入storage，方便之后使用
								wx.setStorageSync("openId", res.data.openid);
								wx.setStorageSync("unionId, res.data.unionid);

								getApp().aplus.aplus_queue.push({
									action: 'aplus.setMetaInfo',
									arguments: ['_anony_id', res.data.openid]
								});

						} else {
							getApp().aplus.aplus_queue.push({
								action: 'aplus.setMetaInfo',
								arguments: ['_anony_id', 業(yè)務(wù)側(cè)自己待實(shí)現(xiàn)的偽id]
							});
						}
				},
			});
		}
	},
	fail: () => {
		// 失敗提示信息等
	},
	complete: () => {
		getApp().aplus.aplus_queue.push({
			action: 'aplus.setMetaInfo',
			arguments: ['_hold', 'START']
		});
	},
});
*/

說明

在授權(quán)微信小程序時(shí)需要提供小程序的AppID和AppSecret，可從微信小程序管理后臺(tái)的「開發(fā)-開發(fā)管理-開發(fā)設(shè)置」中獲取。

2.4 設(shè)置域名白名單

以微信小程序?yàn)槔旱卿浶〕绦蚝笈_(tái)，進(jìn)入開發(fā)設(shè)置-> 服務(wù)器域名白名單，把您的收數(shù)域名添加至白名單

2.5 初始化SDK

在app.js的onLaunch中，引入aplus

App({
	aplus, //全局引入aplus
	onLaunch(){},
	onShow(){},
	onHide(){}
})

3 常見問題

3.1 如何獲取離線SDK？

在QuickTracking后臺(tái)的“管理控制臺(tái)-采集信息”模塊中獲取SDK鏈接后，點(diǎn)擊SDK鏈接并“ctrl+s”或者“command+s”進(jìn)行下載保存。