6.1 pageConfig

pageConfig為全局設置頁面的頁面編碼的方式，具體示例如下：

const aplusConfig = {
  metaInfo: {
   'appKey': 'testappkey', //QuickTracking 創建應用時填寫的Appkey, 必填
   'aplus-rhost-v': 'your_log_domain', //采集日志上報域名，必填
   '_user_id': 'testUserId',  //小程序自身的登錄賬號id，如需要計算分析用戶賬號緯度的數據，需上報
   '_anony_id': 'testOpenid', //小程序平臺用戶唯一標識，用于計算UV, 必填
   'DEBUG': true, //打開調試日志
   'appVersion': '您當前小程序的版本',

   //全局配置頁面編碼
   //若未設置頁面編碼默認為path
   //若未設置頁面標題微信小程序默認為頁面標題，其他小程序默認為""
   'pageConfig': {
      'pages/index/index': {
        'pageName': 'page_name_test_index', 
        'pageTitle': '首頁',
        'skipMe': true //忽略自動上報該頁面的頁面瀏覽事件， 默認為undefined
      },
      'pages/detail/detail': {
        'pageName': 'page_name_test_detail',
        'pageTitle': '詳情頁'
      },
    }
  }
};

其中pageName表示頁面編碼，pageTitle表示頁面標題，skipMe為是否關閉該頁面的自動采集（true表示關閉，false表示開啟；該設置的優先級高于關閉頁面瀏覽事件自動采集的總開關aplus-disable-apv）。

aplus.aplus_queue.push({
  action: 'aplus.setMetaInfo',
  arguments: ['aplus-disable-apv', true]
});

Page({
  onShow() {
    getApp().aplus.aplus_queue.push({
      action: 'aplus.updatePageProperties',
      arguments: [$properties, $page_path]
    })
  }
});

Page({
  onShow() {
    getApp().aplus.aplus_queue.push({
      action: 'aplus.updatePageProperties',
      arguments: [{
        page_name: 'home_page',
        param1: 1,
        param2: 2,
      }, 'pages/index/index']
    })
  }
});

6.3 頁面手動采集

接口

sendPV 方法將發送一條頁面 PV 日志，其 API 定義如下：

aplus.aplus_queue.push({
 action: 'aplus.sendPV',
  arguments: [pageEventConfig, userData]
});

其中：

• pageEventConfig 為頁面事件的配置，只需要寫死{ is_auto: false } 即可

• userdata 為本次頁面事件的擴展參數，其取值為一個 JSON 對象（平鋪的簡單對象，不能多層嵌套），若無可傳空對象'{}'

示例：

// 一個簡單的demo
aplus.aplus_queue.push({
  'action':'aplus.sendPV',
  'arguments':[{
    is_auto: false
  }, {
    
    page_title: "首頁", //默認為pageConfig中的值，如果這里設置了，則為這里設置的值 (非必傳)
    page_name: "yourCurrentPageName", //默認為pageConfig中的值，如果這里設置了，則為這里設置的值 (非必傳)
    
    //自定義事件屬性
    x: 111,
    y: 222
  }]
});

頁面標題（page_title）默認為pageConfig中的值，如果這里設置了，則為這里設置的值；

頁面編碼（page_name）默認為pageConfig中的值，如果這里設置了，則為這里設置的值；

效果如：

7.1 曝光事件

EXP特指曝光事件

aplus.aplus_queue.push({
  'action':'aplus.record',
  'arguments':['埋點方案中的事件編碼', 'EXP', {
    x: '111',
    y: '222',
    z: 333,
    page_name: "demoPageName", //您當前頁面的自定義頁面編碼（非必傳）
  }]
});

7.2 點擊事件

CLK特指點擊事件

aplus.aplus_queue.push({
  'action':'aplus.record',
  'arguments':['埋點方案中的事件編碼', 'CLK', {
    x: '111',
    y: '222',
    z: 333,
    page_name: "demoPageName", //您當前頁面的自定義頁面編碼（非必傳）
  }]
});

7.3 OTHER 其他事件埋點

OTHER特指除點擊和曝光事件外的其他自定義事件

aplus.aplus_queue.push({
  'action':'aplus.record',
  'arguments':['埋點方案中的事件編碼', 'OTHER', {
    x: '111',
    y: '222',
    z: 333,
    page_name: "demoPageName", //您當前頁面的自定義頁面編碼（非必傳）
  }]
});

7.4 自動曝光（全埋點）

從aplus_mini.js@1.1.0開始，由SDK內部幫助開發者處理曝光時機，并自動采集元素曝光行為。觸發時機為控件展示在可視區域內面積超過50%，時間超過300ms。

以微信為例， UI部分：

// 頁面WXML文件根節點埋點capture-bind:touchstart：
<view capture-bind:touchstart="onAplusTouch">
  
// 待曝光節點添加class和data-tracker(對應app.js中自動點擊的配置)，如:
<view class="button-section">
  <button 
     class="auto-exposure"
     data-pagename="自定義當前事件的頁面編碼" 
     data-page_title="自定義當前事件的頁面標題" 
     data-name="btn-navigator" 
     data-index="num1"
     bindtap="onNavigatorTap">導航</button>
  <button 
     class="autotrack_exp" 
     data-itemName='讀書' 
     data-itemzoon='abc' 
     data-itemid='a_product_id' 
     data-promotioninformation='abc' 
     data-pagename='首頁'>autoExp</button>
</view>

SDK 配置部分：

var aplus = require('./utils/aplus_mini.js')({
  metaInfo: {
    'aplus-auto-exp': [{
      'cssSelector':'.auto-exposure', // 你要曝光的元素的class 
      'logkey':'auto-exp-id', // 埋點方案中對應的事件編碼
      // 注意：
      // 1、如果CSSSelector能匹配上多個元素則一定要在頁面節點上埋data-tracker,否則aplusJS無法識別元素唯一性，進而導致一個列表多個元素只能觸發一次曝光；
      // 2、目前支付寶小程序不支持該屬性采集
      'props': ['data-name', 'data-index', 'data-pagename', 'data-page_title']
    }, {
      'cssSelector':'.autotrack_exp', // 你要曝光的元素的class 
      'logkey':'autotrack_exp', // 埋點方案中對應的事件編碼
    }],
//自動曝光的前置回調函數，用于支持定制化參數上報，如駝峰寫法等（html數據屬性默認只支持小寫）
//1.9.25版本及以上支持
    'aplus-auto-exp-userfn': function(e, selector) {
      if (selector.indexOf('autotrack_exp') != -1) {
        var dataset = e.dataset;
        var obj = {};
        obj.itemID = dataset.itemid;
        obj.itemName = dataset.itemname;
        obj.itemZoon = dataset.itemzoon;
        obj.promotionInformation = dataset.promotioninformation;
        obj.pageName = dataset.pagename;          
        return obj;
      }
    }
  }
});

或開發者在某個時機，通過setMetaInfo 或 appendMetaInfo 更改自動曝光配置，之后的再觸發元素時才會生效

aplus.aplus_queue.push({
	action: 'aplus.setMetaInfo',
  arguments: ['aplus-auto-exp', [{
      'cssSelector':'.auto-exposure',
      'logkey':'demoEventCode', //埋點方案中對應的事件編碼
      'props': ['data-name', 'data-index', 'data-pagename', 'data-page_title'], // 埋點方案中的自定義屬性
    }, {
      'cssSelector':'.autotrack_exp', // 你要曝光的元素的class 
      'logkey':'autotrack_exp', // 埋點方案中對應的事件編碼
    }]
  ]
});

//或者

aplus.aplus_queue.push({
	action: 'aplus.appendMetaInfo',
  arguments: ['aplus-auto-exp', [{
      'cssSelector':'.auto-exposure',
      'logkey':'demoEventCode', //埋點方案中對應的事件編碼
      'props': ['data-name', 'data-index', 'data-pagename', 'data-page_title'], // 埋點方案中的自定義屬性
    }, {
      'cssSelector':'.autotrack_exp', // 你要曝光的元素的class 
      'logkey':'autotrack_exp', // 埋點方案中對應的事件編碼
    }]
  ]
});

// 自動曝光事件的前置回調函數，用于支持定制化參數上報，如駝峰寫法等（html數據屬性默認只支持小寫）
//1.9.25版本及以上支持
aplus.aplus_queue.push({
	action: 'aplus.setMetaInfo',
  arguments: ['aplus-auto-exp-userfn', function(e, selector) {
      if (selector.indexOf('autotrack_exp') != -1) {
        var dataset = e.dataset;
        var obj = {};
        obj.itemID = dataset.itemid;
        obj.itemName = dataset.itemname;
        obj.itemZoon = dataset.itemzoon;
        obj.promotionInformation = dataset.promotioninformation;
        obj.pageName = dataset.pagename;          
        return obj;
     }
  }]
});

自動曝光前置回調函數，默認值為undefined，如需開啟，需設置：

aplus_queue.push({
action: 'aplus.setMetaInfo',
arguments: ['aplus-auto-exp-userfn', function(e， selector) { 
/**
  * e: DOM元素
  * selector: 元素的選擇器，取值為自動點擊中傳入的cssSelector
  * @return 自定義屬性對象
  */
       }]
 })

7.5 自動點擊（全埋點）

從aplus_mini.js@1.1.0開始，為減少開發者埋點工作量，SDK也支持通過配置部分信息，讓SDK自動采集頁面內的點擊事件。（支付寶、百度小程序需要基礎庫2.x版本以上才支持）

以微信為例， UI部分：

// 頁面WXML文件根節點埋點catchtap：
<view catchtap="onAplusClk">
  
// 待曝光節點添加class和data-tracker(對應app.js中自動點擊的配置)，如:
<view class="button-section">
  <button 
     class="auto-click" 
     data-pagename="自定義當前事件的頁面編碼" 
     data-page_title="自定義當前事件的頁面標題" 
     bindtap="onNavigatorTap">導航</button>
  <button 
     class="autotrack_clk" 
     data-itemName='讀書' 
     data-itemzoon='abc' 
     data-itemid='a_product_id' 
     data-promotioninformation='abc' 
     data-pagename='首頁'>autoClk</button>
</view>

SDK 配置部分：

var aplus = require('./utils/aplus_mini.js')({
  metaInfo: {
    'aplus-auto-clk': [{
      'cssSelector':'.auto-click',
      'logkey':'demoEventCode', //埋點方案中對應的事件編碼
      'props': ['data-name', 'data-pagename', 'data-page_title'], // 埋點方案中的自定義屬性
    }, {
      'cssSelector':'.autotrack_clk',
      'logkey':'autotrack_clk', //埋點方案中對應的事件編碼
    }],
    // 自動點擊事件的前置回調函數，用于支持定制化參數上報，如駝峰寫法等（html數據屬性默認只支持小寫）
    'aplus-auto-clk-userfn': function(e, selector) {
      if (selector.indexOf('autotrack_clk') != -1) {
        var dataset = e.dataset;
        var obj = {};
        obj.itemID = dataset.itemid;
        obj.itemName = dataset.itemname;
        obj.itemZoon = dataset.itemzoon;
        // obj.promotionInformation = dataset.promotioninformation;
        obj.pageName = dataset.pagename;          
        return obj;
      }
    },
  }
});

或開發者在某個時機，通過setMetaInfo 或 appendMetaInfo 更改自動點擊配置，之后的再觸發元素時才會生效

aplus.aplus_queue.push({
	action: 'aplus.setMetaInfo',
  arguments: ['aplus-auto-clk', [{
      'cssSelector':'.auto-click',
      'logkey':'demoEventCode', //埋點方案中對應的事件編碼
      'props': ['data-name', 'data-pagename', 'data-page_title'], // 埋點方案中的自定義屬性
    }, {
      'cssSelector':'.auto-click',
      'logkey':'demoEventCode', //埋點方案中對應的事件編碼
    }]
  ]
});

//或者

aplus.aplus_queue.push({
	action: 'aplus.appendMetaInfo',
  arguments: ['aplus-auto-clk', [{
      'cssSelector':'.auto-click',
      'logkey':'demoEventCode', //埋點方案中對應的事件編碼
      'props': ['data-name', 'data-pagename', 'data-page_title'], // 埋點方案中的自定義屬性
    }]
  ]
});
// 自動點擊事件的前置回調函數，用于支持定制化參數上報，如駝峰寫法等（html數據屬性默認只支持小寫）
aplus.aplus_queue.push({
	action: 'aplus.setMetaInfo',
  arguments: ['aplus-auto-clk-userfn', function(e, selector) {
      if (selector.indexOf('autotrack_clk') != -1) {
        var dataset = e.dataset;
        var obj = {};
        obj.itemID = dataset.itemid;
        obj.itemName = dataset.itemname;
        obj.itemZoon = dataset.itemzoon;
        // obj.promotionInformation = dataset.promotioninformation;
        obj.pageName = dataset.pagename;          
        return obj;
     }
  }]
});