1 SDK原理概述

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

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

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

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

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

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

3 日志發(fā)送策略

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

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

4 日志聚合上報

從1.8.2版本開始支持

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

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

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

若未滿5條，則會在退出小程序時自動上報。

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

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

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

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