小程序SDK有哪些常见场景与埋点建议-阿里云帮助中心

1 页面跳转前的事件发送

场景描述

当用户在页面上「点击会立刻进行页面跳转的按钮」时，触发的点击事件可能会因为页面立刻跳转而未发送出去，若希望该场景下尽量保证数据的发送，可以进行页面延迟跳转，事例代码如下：

//点击链接
function targetLinkCLK(url) {
  // 延迟页面跳转，给SDK预留发数时间
  setTimeOut(function(){
    window.location.href = url;
  }, 500);
	aplus_queue.push({
    action: 'aplus.record',
    arguments: ['track_alink_clk', 'CLK', { 
      param1: xxxx, 
      param2: xxxx
    }]
  });
}

2 插件中使用小程序SDK埋点

受小程序框架层面的限制，在小程序插件中使用SDK埋点有如下功能限制：

不支持自动pv
不支持自动点击、自动曝光埋点
不支持可视化埋点
因为SDK统计不到插件内的页面地址，插件内的页面上报必须在事件属性中指定page_name页面编码，否则无法做统计关联计算

步骤1：首先参考小程序集成文档完成SDK集成，见上文『引用&配置SDK』

代码工程目录示例：

步骤2：导出SDK环境变量供插件调用

创建exportToPlugin.js文件，并实现如下逻辑

const aplus = require('./utils/aplus');
module.exports = {
  getAplusCTX() {
    return aplus;
  }
}

然后在app.json中将需要暴露给插件的js文件通过export导出

步骤3：埋点示例

页面浏览事件示例：

const aplus = requireMiniProgram().getAplusCTX()
Page({
  data: {
    message: '插件内页面',
  },
  onLoad() {

  },
  onShow() {
    aplus.aplus_queue.push({
      action: 'aplus.sendPV',
      arguments: [{is_auto:false}, {
        // 插件内的页面编码必填，因为插件内获取不到页面的地址
        page_name: 'plugin_page'
      }]
    });
  }
})

自定义事件示例：

// plugin/components/hello-compoenent.js
const aplus = requireMiniProgram().getAplusCTX()
Component({
  /**
   * 组件的属性列表
   */
  properties: {},

  /**
   * 组件的初始数据
   */
  data: {},

  /**
   * 组件的方法列表
   */
  methods: {
    testTap: function(){
      aplus.aplus_queue.push({
        action: 'aplus.record',
        arguments: ['test_clk', 'CLK', {
          page_name: 'plugin_page',
          param1: 'test_param1',
          param2: 'test_param2'
        }]
      })
    }
  }
})

3 小程序场景含义

QuickTracking采集的为各平台官方场景值，其含义映射文档链接如下：

百度场景值：https://smartprogram.baidu.com/docs/data/scene/

微信场景值：https://developers.weixin.qq.com/minigame/dev/reference/scene-list.html

字节场景值：https://microapp.bytedance.com/docs/zh-CN/mini-game/develop/framework/scene-value/

支付宝场景值：https://opendocs.alipay.com/mini/framework/scene

QQ场景值：https://q.qq.com/wiki/develop/game/frame/scene/

4 小程序分享回流定义

QuickTracking后台中，定义的分享回流指标是使用场景值确定的，具体定义如下：

1.微信："单人聊天会话中的小程序消息卡片"、"群聊会话中的小程序消息卡片"、"App 分享消息卡片"、"带 shareTicket 的小程序消息卡片"、"聊天记录，打开小程序"、"#话题页打开小程序"、"朋友圈内打开“单页模式”"

2.支付宝："单人聊天会话中的小程序消息卡片（分享）"

3.字节系："微信对话"、"微信朋友圈"、"QQ对话"、"Qzone"、"钉钉"、"系统分享"、"复制链接"、"口令分享"、"分享的微头条"

4.百度："分享"、"分享原中间页"、"分享Web化中间页"、"百度好友聊天页回流入口"