1 SDK原理概述

aplus.aplus_queue.push({
 'action': "$APIName", 
  'arguments': [$arguments] //arguments 為指定 API 的入?yún)ⅲ?})

//變更 SDK 的默認(rèn)設(shè)置
aplus.aplus_queue.push({
 action: 'aplus.setMetaInfo',
  arguments: [metaName, metaValue]
});

//獲取 SDK 的當(dāng)前配置
aplus.getMetaInfo(metaName);

//用于發(fā)送事件日志
aplus.aplus_queue.push({
 action: 'aplus.record',
  arguments: [trackerEventCode, eventType, eventParams]
});

//用于發(fā)送頁(yè)面日志
aplus.aplus_queue.push({
 action: 'aplus.sendPV',
  arguments: [pageEventConfig, userData]
});

//開啟調(diào)試模式
const aplusConfig = {
	metaInfo: {
	'appKey': '', //平臺(tái)系統(tǒng)中創(chuàng)建應(yīng)用時(shí)填寫的Appkey, 必填
	'aplus-rhost-v': '', //采集日志上報(bào)域名，必填
	'DEBUG': true, //開啟調(diào)試模式
	}
};

3 日志發(fā)送策略

QuickTracking 小程序 SDK默認(rèn)事件上報(bào)時(shí)機(jī)為：事件觸發(fā)就立刻上報(bào)。為兼容更多業(yè)務(wù)場(chǎng)景，也提供了日志聚合上報(bào)，當(dāng)觸發(fā)事件個(gè)數(shù)達(dá)到設(shè)置的個(gè)數(shù)時(shí)進(jìn)行上報(bào)，具體設(shè)置方式見「4 日志聚合上報(bào)」。

注意：微信小程序要求“短時(shí)間內(nèi)發(fā)起太多請(qǐng)求會(huì)觸發(fā)小程序并行請(qǐng)求數(shù)據(jù)量的限制，同時(shí)太多請(qǐng)求也可能導(dǎo)致加載慢等問(wèn)題，應(yīng)合理控制請(qǐng)求數(shù)量，甚至做請(qǐng)求的合并”，使用默認(rèn)QuickTracking 小程序 SDK默認(rèn)事件上報(bào)策略可能觸發(fā)該限制，建議使用「4 日志聚合上報(bào)」。

4 日志聚合上報(bào)

從1.8.2版本開始支持

聚合上報(bào)是指將多條日志信息合并為一條請(qǐng)求上報(bào)至服務(wù)端，在數(shù)據(jù)端拆解為多條日志并落庫(kù)。

var aplus = require('./utils/aplus_mini.js')({
  metaInfo: {
    'max-queue-count': [number]  // 控制聚合日志條數(shù)，默認(rèn)不聚合
  }
});

如下圖所示：若設(shè)置為max-queue-count = 5，則會(huì)在收集到5條日志時(shí)，才會(huì)向服務(wù)端上報(bào)請(qǐng)求；

若未滿5條，則會(huì)在退出小程序時(shí)自動(dòng)上報(bào)。

注意：微信小程序要求“短時(shí)間內(nèi)發(fā)起太多請(qǐng)求會(huì)觸發(fā)小程序并行請(qǐng)求數(shù)據(jù)量的限制，同時(shí)太多請(qǐng)求也可能導(dǎo)致加載慢等問(wèn)題，應(yīng)合理控制請(qǐng)求數(shù)量，甚至做請(qǐng)求的合并”，因此建議使用上述的「日志聚合上報(bào)」。

5 應(yīng)用基礎(chǔ)信息配置

在SDK引入部分，可以修改或者追加一些默認(rèn)設(shè)置

const aplusConfig = {
	metaInfo: {
    'appKey': 'testappkey', //QuickTracking 創(chuàng)建應(yīng)用時(shí)填寫的Appkey, 必填
    'aplus-rhost-v': 'your_log_domain', //采集日志上報(bào)域名，必填
    '_user_id': 'testUserId',  //小程序自身的登錄賬號(hào)id，如需要計(jì)算分析用戶賬號(hào)緯度的數(shù)據(jù)，按需上報(bào)
    'autoGetOpenid': true, //自動(dòng)獲取openid設(shè)置 (推薦！目前僅支持微信小程序 )
    'DEBUG': true, //打開調(diào)試日志
    // '_hold': 'BLOCK', // 如果是異步場(chǎng)景，需先阻塞日志上報(bào)，待openid等設(shè)置成功后，再上報(bào)
    'appVersion': '您當(dāng)前小程序的版本'
	}
};
//聲明aplus采集sdk全局變量
const aplus = require('./utils/aplus_mini')(aplusConfig);