阿里云首页 移动开发平台 mPaaS

上报埋点

此接口为前端能用到的最原始的埋点接口。

remoteLog 接口的使用方法

AlipayJSBridge.call('remoteLog', {
  bizType: "Nebula",    // 业务类型
  logLevel: 1,          // 1 - high, 2 - medium, 3 - low
  actionId: "event",    // 埋点类型,固定为 "event"
  seedId: "Login",      // 埋点唯一标识
  param1: "",
  param2: "",
  param3: "",
  param4: {key1:"value1",key2:"value2"}, // 自定义参数
});
说明

  • 如果您需要添加自定义埋点参数,可以通过 key:"value" 的格式添加至上述代码的 param4 中,例如:key1:"value1"

  • 添加多个自定义埋点参数时,在 param4 中添加的内容格式如下:param4: "key1:"value1",key2:"value2",key3:"value3"

代码示例

<h1>点击按钮会记录相关信息</h1>

<a href="javascript:void(0)" class="btn read">点一点</a>

<script>
function ready(callback) {
  // 如果 jsbridge 已经注入则直接调用
  if (window.AlipayJSBridge) {
    callback && callback();
  } else {
    // 如果没有注入则监听注入的事件
    document.addEventListener('AlipayJSBridgeReady', callback, false);
  }
}
ready(function() {
  document.querySelector('.read').addEventListener('click', function() {
    AlipayJSBridge.call('remoteLog', {
      type: "behavior",
      bizType: "Nebula",
      spmId: "a1.b2",
      logLevel: 1, // 1 - high, 2 - medium, 3 - low
      actionId: "event"
      seedId: "xxx",
      param1: "xxx",
      param2: "xxx",
      param3: "xxx",
      param4: "xxx",
    });
  });
});
</script>

API 说明

AlipayJSBridge.call('remoteLog', {
  type, seedId, ucId, bizType, logLevel,
  actionId, spmId, param1, param2, param3, param4
});

入参

属性

类型

描述

必填

默认值

type

string

埋点类型:

  • monitor:监控类型。

  • monitorWithLocation:监控类型,自动在 param4 里带上经纬度。

  • behavior:行为类型。

  • behaviorAuto:自动行为类型。

  • performance:性能类型。

  • error:异常类型,9.6.8 版本开始支持。

  • 135:135 业务相关,9.9 版本开始支持。

N

“monitor”

seedId

string

埋点 ID。

Y

“”

bizType

float

业务类型标识,该参数传值时,会生成单独的日志文件。

N

-

logLevel

int

1 - high

2 - medium

3 - low,低级别的日志可能会被限流。

N

-

actionId

string

埋点类型,固定为 event。

Y

“”

spmId

string

spm 编码。当编有 spmId 时,忽略 seedId。

Y

“”

param1

string

埋点参数 1。

N

“”

param2

string

埋点参数 2。

N

“”

param3

string

埋点参数 3。

N

“”

param4

string

埋点参数 4。

N

“”