常见场景与埋点建议

1 页面跳转前的事件发送

场景描述

当用户在网页「点击 href 属性 www.xxxx.com 的 a 标签」时,触发的点击事件可能会因为页面立刻跳转而未发送出去,若希望该场景下保证数据的发送,请在页面跳转前上报点击事件。

示例:

// 点击链接
function targetLinkCLK(url) {
  aplus_queue.push({
    action: 'aplus.record',
    arguments:['track_alink_clk', 'CLK', {
      param1: "xxxx",
      param2: "xxxx",
    }],
  });
  window.location.href = url;
};

极端情况下若存在事件无法正常发送的情况,可以进行页面延迟跳转,示例代码如下:

// 点击链接
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 在App中的H5如何埋点?

Android中的H5埋点详见:

Android AppH5桥接操作文档

iOS中的H5埋点详见:

iOS AppH5桥接操作文档

3 在小程序中的H5如何埋点?

在小程序中H5埋点详见:

小程序内H5嵌入埋点操作文档

4 H5全埋点

全埋点功能

功能含义

操作文档

页面事件

当页面加载,触发生命周期中onload函数时,自动上报页面浏览事件。其默认事件参数为:

url:页面URL带参数

ref_url:页面的document.referrer

page_name:页面URL不带参数

page_title:页面的document.title

开启/关闭/配置页面全埋点

点击事件

设置标签类型,当该类型标签被点击时,自动上报控件点击事件。其默认事件参数为事件触发时的:

url:页面URL带参数

ref_url:页面的document.referrer

page_name:页面URL不带参数

page_title:页面的document.title

以及控件ID、控件类型、控件筛选器、控件位置、控件内容、控件名字、控件样式名

任意控件点击自动捕获

指定元素class,当该class元素被点击时,自动上报控件点击事件。其默认事件参数为事件触发时的:

url:页面URL带参数

ref_url:页面的document.referrer

page_name:页面URL不带参数

page_title:页面的document.title

指定元素的自动点击

曝光事件

设置标签类型,当在该类型标签被曝光(出现在可视区域)时,自动上报控件曝光事件。其默认事件参数为事件触发时的:

url:页面URL带参数

ref_url:页面的document.referrer

page_name:页面URL不带参数

page_title:页面的document.title

指定元素的自动曝光

5 自定义SDK写入cookie的过期时间

随着隐私合规政策趋于严格,某些地区要求cookie默认过期时间不可以超过 1 年以上,因此SDK新增自定义SDK写入cookie的过期时间,单位为天

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="qt-cookie-expires" content="180">
    ....js
</head>
<body></body>
</html>

如代码中所示,如需自定义SDK写入的cookie过期时间,需添加名为 qt-cookie-expires 的 meta tag。

详细说明:

名称

含义

说明文档

qt-cookie-expires

sdk 自定义cookie过期时间

代表基于当前访问时间开始的过期天数。

数字最小值:1

数字最大值:20*365

默认过期时间 365 天