帮助文档
  • What's new
  • 增长平台全景图
  • 文档使用指南
  • 产品简介
    • 产品概述
    • 数据模型
      • 用户模型
        • 访问用户
        • 登录用户
        • 用户属性
      • 事件模型
        • 什么是事件
        • 无埋点事件
          • 概述
          • 访问事件及变量
          • 页面事件及变量
          • 元素事件及变量
        • 埋点事件
      • 统计模型
        • 指标-事件的度量
        • 维度-事件的属性
        • 预定义指标
        • 预定义维度
    • 数据定义
      • 用户变量
        • 登录用户变量
        • 访问用户变量
      • 页面级变量
      • 埋点事件及变量
        • 埋点事件和事件级变量
        • 转化变量
    • 数据安全
  • 开发者文档
    • SDK 集成
      • SDK 简介
      • 合规指南
        • Android SDK合规说明
        • iOS SDK合规说明
        • HarmonyOS SDK合规说明
        • Web JS SDK 合规说明
        • 小程序 SDK 合规说明
      • SDK 使用流程
      • Web JS SDK
        • Web JS SDK 更新日志
        • 概述
        • 集成最新SDK
        • SDK 版本1.x升级2.x指导
        • Web JS SDK API
          • API 2.x
        • Web半自动采集浏览事件
        • 常见问题
          • 为什么网站要允许iframe加载?
          • 为什么网站不能复写 window 对象?
          • 页面内部嵌入的 iframe 元素如何加载 SDK?
          • 同时集成了web sdk 和 hybrid sdk 会怎么处理?
          • 同时集成了web sdk 1.x 和web sdk 2.x会怎么处理?
          • 元素没有元素浏览量怎么处理?
          • display:none 的元素,其子元素中的a/button只采集一次浏览量,想每次曝光都采集怎么处理?
          • 设置了 growing-ignore 之后,其子元素也不采集怎么处理?
      • 原生 Android SDK
        • Android SDK更新日志
        • 无埋点 SDK 集成
        • 埋点 SDK 集成
        • Android SDK API
          • Gradle配置API
          • 初始化配置项API
          • 运行时API
          • 自定义数据上传API
        • Android半自动采集浏览事件
        • 1.x Android SDK 升级指导
        • 常见问题
          • 无埋点数据采集问题
          • 无埋点SDK中埋点API使用问题
          • SDK性能问题
          • 圈选问题
          • Gradle 常见问题
          • App内嵌H5页面常见问题
      • 原生 iOS SDK
        • iOS SDK 更新日志
        • 无埋点 SDK集成
        • 埋点 SDK集成
        • iOS SDK API
          • 初始化配置项API
          • 埋点SDK支持的其他接口
          • 动态添加属性说明
          • 自定义数据上传API
        • iOS半自动采集浏览事件
        • iOS SDK升级指导
        • 常见问题
        • 用户运营iOS SDK地址
      • 移动端第三方框架 SDK
        • React Native无埋点SDK
        • React Native埋点SDK
        • Flutter埋点SDK
        • Cordova埋点SDK
        • Weex埋点SDK
        • API Cloud埋点SDK
        • AppCan埋点SDK
        • uniapp 埋点SDK
        • Unity 埋点 SDK
        • 鸿蒙原生埋点 SDK
      • 小程序 SDK
        • 3.7及以下
          • 更新日志
          • 集成
            • 微信小程序
            • 支付宝小程序
            • 百度小程序
            • QQ小程序
            • 字节跳动小程序
            • 快应用
          • 数据采集API
          • 无埋点采集逻辑和高级配置
        • 3.8
          • 更新日志
          • 集成
            • 微信小程序
            • 阿里(支付宝)小程序
            • 百度小程序
            • 字节(抖音头条)小程序
            • QQ小程序
            • 快应用
          • 初始化配置
          • 数据采集API
          • 无埋点采集逻辑和高级配置
          • 旧版本与3.8对比
          • 旧版本升级到3.8
      • Hybrid JS SDK
      • 小程序和微信公众号H5 内嵌页 SDK
        • 更新日志
      • 微信小游戏 SDK
        • 更新日志
      • 服务端埋点SDK
        • Java埋点SDK
        • PHP埋点SDK
        • 常见问题
      • 仅集成埋点SDK的Hybrid JS SDK
    • SDK调试
      • 概述
      • Web Debugger
      • Mobile Debugger
      • 小程序&内嵌页Debugger
      • 验证埋点事件
        • 概述
        • 对 cstm(事件以及关联的事件级变量)上报进行验证
        • 对 pvar(页面级变量)进行验证
        • 对 evar(转化变量)进行验证
        • 对 ppl(用户变量)上报验证
    • API参考
      • 公共请求参数
      • 原始数据导出API V2
        • 概述
        • 事件表字段说明
          • 事件表关联
          • 无埋点事件字段
          • 埋点事件与变量字段
          • 广告相关字段
        • 接口定义
          • 获取不同类型原始数据下载链接
          • 获取全部事件类型原始数据的下载链接
        • 升级说明
        • 导出数据处理建议
      • 原始数据导出API V1
        • 概述
        • 字段说明
          • 事件类型
          • 无埋点事件字段
          • 埋点事件与变量字段
          • 广告相关字段
        • 接口定义
          • 获取原始数据下载链接
          • 来源管理数据导出 -- [接口下线 2020.11.02]
        • 导出数据处理建议
      • 统计数据导出API V3
        • V3接口概述
        • 接口定义
          • 获取事件分析数据
          • 获取漏斗分析数据
          • 获取留存分析数据
          • 获取分布分析数据
          • 获取用户分群的下载链接
          • 获取用户标签的下载链接
      • 统计数据导出API
        • 概述
        • 接口定义
          • 获取看板列表
          • 获取看板中的图表信息
          • 获取事件分析数据
          • 获取漏斗分析数据
          • 获取留存分析数据
          • 获取分群列表
          • 获取特定分群的用户列表
          • 获取圈选元素定义
      • 用户分群更新API
      • 广告监测链接创建API
        • 概述
        • 接口定义
          • 查询应用ID
          • 新建推广活动
          • 查询推广活动ID
          • 新建推广渠道
          • 查询推广渠道ID
          • 新建监测链接(吸引用户直接打开App)
          • 查询监测链接(吸引用户直接打开App)
          • 新建监测链接(增加APP下载量-同时推广iOS和Android)
          • 查询监测链接(增加APP下载量-同时推广iOS和Android)
          • 新建监测链接(增加App下载量-推广iOS或Android单个平台)
          • 查询监测链接(增加App下载量-推广iOS或Android单个平台)
          • 新建监测链接(推广网页)
          • 查询监测链接(推广网页)
          • 新建监测链接(微信小程序)
          • 查询监测链接(微信小程序)
      • 埋点数据上传API
      • 登录用户变量上传API
        • 登录用户变量上传
        • 维度分类上传
        • 既有登录用户ID上传
        • (旧)接口定义
          • 用户变量上传
          • 维度分类上传
      • 项目管理API
        • 概述
        • 从项目内移除成员
        • 获取埋点事件列表
        • 创建埋点事件
        • 更新埋点事件
        • 删除埋点事件
        • 获取事件级变量
        • 创建事件级变量
        • 获取页面级变量
        • 创建页面级变量
        • 获取登录用户变量
        • 创建登录用户变量
        • 获取访问用户变量
        • 获取埋点数量限额
      • 数据管理API(GDPR)
        • 数据保护
        • 删除原始数据
  • 产品使用文档
    • 产品分析
      • 数据监测
        • 概览
        • 实时
        • 分析看板
        • KPI看板
        • 小程序看数助手
      • 分析工具
        • 事件分析
          • 什么是事件分析
          • 创建事件分析
          • 视图介绍
        • 漏斗分析
          • 什么是漏斗分析
          • 创建漏斗分析
          • 漏斗分析结果解读
          • 案例解读
        • 留存分析
          • 什么是留存分析
          • 创建留存分析
          • 留存分析结果解读
          • 视图介绍
          • 应用场景
          • 常见问题
        • 分布分析
          • 什么是分布分析
          • 使用场景
          • 创建分布分析
        • 热图分析
          • 什么是热图分析
          • Web端热图
          • App热图
        • 事件流分析
      • 业务场景
        • 分享分析
        • 留存魔法师
    • 智能运营
    • 获客分析
      • 首页
        • 应用级数据
        • 数据指标说明
      • 分析
        • 渠道价值分析
        • 渠道归因分析
        • 落地页分析
        • 活动页分析
      • 获客追踪
        • 监测链接
          • 推广App
          • 推广网页
          • 推广小程序(微信)
            • 推广链接的投放和设置指南
            • 小程序码管理
        • 深度链接
        • 结合产品数据深度分析
      • 产品配置
        • 广告活动管理
        • 推广渠道管理
        • 深度链接配置
        • 广告数据权限控制
        • 日志数据导出
        • 维度配置(链接扩展维度)
        • 归因配置
      • 渠道配置指南
        • 苹果广告投放
        • 华为应用商oCPD
        • HUAWEI Ads
        • 腾讯社交广告(Marking API)
        • 今日头条(巨量纵横)
        • 百度原生信息流
        • 百度搜索_ocpc
        • 微信广告平台
        • 微博超级粉丝通
        • 爱奇艺
        • InMobi
        • 快手平台
        • 凤羽广告平台
        • bilibili(B站)
        • VIVO营销平台
      • 相关知识
        • UTM参数使用指南
        • 移动端转化归因
        • 默认的渠道来源跟踪
        • DeepLink启用新域名
      • 常见问题
    • 用户库
      • 用户分群
        • 用户分群
          • 什么是用户分群
          • 创建用户分群
            • 规则分群
          • 更新用户分群
          • 查看分群详情页
          • 常见问题
        • 用户细查
          • 什么是用户细查
          • 细查用户
          • 应用场景
          • 常见问题
      • 用户标签 - Beta
        • 创建标签
        • 标签模型使用
          • 基础指标值
          • 最大值 / 最小值
          • 最初 / 最终
          • 分层标签
      • 用戶分析
        • 活跃用户分析
          • 什么是活跃用户分析
          • 分析活跃用户
      • 业务场景
        • 微信应用用户分析
    • 数据中心
      • 数据管理
        • 无埋点事件
          • 概述
          • Web端数据定义
            • Web圈选
            • Chrome插件圈选
            • Chrome插件安装步骤
          • App端数据定义
          • App端数据定义(App圈选)
          • 小程序数据定义
          • 微信内嵌页数据定义
        • 埋点事件
        • 事件级变量
        • 页面级变量
        • 用户变量
          • 登录用户变量
          • 访问用戶变量
        • 转化变量
        • 业务标签管理
        • 批量操作
        • 自定义指标管理
          • 计算指标
          • 合并事件
        • 预定义维度
        • 预定义指标
      • 数据规划
        • 电商行业数据规划
      • 数据校验
        • 移动端数据校验
        • 小程序数据校验
        • Mobile Debugger
        • Web Debugger
      • 数据集成
        • 微信公众号集成
    • 项目管理
      • 如何进入项目管理?
      • 项目概览
      • 应用管理
      • 成员管理
      • 角色管理
        • 典型角色应用场景
        • 系统角色功能权限列表
      • 小组管理
      • 数据权限
      • 项目配置
        • IP及域名数据过滤
        • 爬虫预防
        • UTM映射管理
        • API Token管理
        • 获取项目UID
    • 组织管理
      • 组织概览
      • 组织项目
      • 组织成员
      • 费用中心(计费方案)
    • 个人中心
      • 个人信息
      • 安全设置
    • 学习平台
    • 工单管理
      • 提交工单
      • 查看进度
      • 邀请技术支持
    • 术语解释
  • 常见问题与解决
    • 基本问题
    • SDK集成
    • 圈选问题
    • 指标和维度
    • 数据安全
    • 产品使用
    • 数据统计差异
    • 如何删除不要的项目?
    • 为何收不到GIO的邮件?
    • 无效指标清理说明
    • 产品维护计划通告
由 GitBook 提供支持
在本页
  • 访问数据
  • 页面数据
  • 行为数据
  • tap
  • longpress
  • change
  • submit
  • 采集标记​
  • 1、采集标记​
  • 2、补充数据标记​
  • 3、忽略采集标记​
  • 半自动埋点浏览事件​
  • 曝光逻辑​
  • 支持范围​
  • 使用方法一:
  • 使用方法二:​
  • 单次曝光
  • 手动更新半自动埋点监听​
  • 其他​

这有帮助吗?

  1. 开发者文档
  2. SDK 集成
  3. 小程序 SDK
  4. 3.8

无埋点采集逻辑和高级配置

访问数据

每次用户打开小程序的时候,发送一条访问事件的消息,对应的数据指标是打开次数。发送数据包含但不限于以下信息:进入页面、进入时间、场景值、来源小程序或 App、设备信息、微信应用信息、应用版本号。触发时机:onAppShow

每次用户关闭小程序的时候,关闭动作包括退出小程序回到微信、退出微信,会发送一条应用关闭消息,会根据这个消息来计算应用访问时长。发送数据包含但不限于以下信息:退出页面、退出时间。触发时机:onAppHide

页面数据

每次用户访问一个新的页面,发送一条页面浏览事件的消息,对应的数据意义是页面分析。发送数据包含但不限于以下信息:页面信息、打开时间、页面来源、页面标题、页面级变量。触发时机:onPageShow

每次当用户点击转发按钮时,会弹出转发框,这时会发送一条要转发事件的消息。这是一个自定义事件,数据包含以下信息:事件时间、所在页面、转发动作来源、转发页面标题和转发页面路径。注意这个事件不代表用户真正转发了消息到聊天里面,而是用户触发了转发动作。如果要跟踪成功转发消息事件,建议在 onShareAppMessage 的 success callback 里面发送一个自定义事件。触发时机:onShareAppMessage

行为数据

对于用户在页面发生的行为,如果这个行为有绑定事件比如 bindtap,并且在您的小程序里面进行处理,那么 GrowingIO 的小程序 SDK 会自动采集这些事件,发送一条行为事件的消息。目前,我们支持的事件有 tap、longpress、confirm 和 change 事件。

tap

tap 事件是手指触摸后马上离开时触发的事件。当 wxml 中的 view 绑定了 bindtap 事件以后,在事件处理函数执行的时候,SDK 会自动采集 tap 事件,发送数据包含但不限于以下信息:点击事件时间、事件发生所在页面、点击控件相关信息。

longpress

longpress 事件是手指触摸后,超过350ms再离开时触发的事件。当 wxml 的 view 绑定了 bindlongpress 事件以后,在事件处理函数执行的时候,SDK 会自动采集 longpress 事件,发送数据包含但不限于以下信息:点击事件时间、事件发生所在页面、点击控件相关信息。

change

change 事件是针对 checkbox、radio、picker-view 这些控件,当选择项发生改变时触发的事件。当 wxml 的 view 绑定了 bindchange 事件以后,在事件处理函数执行的时候,SDK 会自动采集 change 事件,发送数据包含但不限于以下信息:选择事件的发生时间、事件发生所在页面。

submit

有时我们表单页面中可能需要获取用户选择框、单/多选框的值进行上报以准确分析用户行为。此时,我们可以通过数值采集标记 data-growing-track 来获取值。例:

<checkbox-group bindchange='checkboxChange' data-growing-track>
    <label class='checkbox'>
        <checkbox value='GrowingIO' checked='true' /> GrowingIO
    </label>
    <label class='checkbox'>
        <checkbox value='CDP' checked='false' /> GrowingIO CDP
    </label>
</checkbox-group>

免责声明警告:

请勿尝试在密码框上标记 data-growing-track 采集数据,会明文暴露用户填写的密码信息。GrowingIO不承担由此直接或间接产生的数据风险和法律风险。

3.8.0版本开始,SDK会自动忽略带有 autoplay 属性且值为 true 组件的 change 事件(例如swiper、video)。如果您期望采集它,请添加 data-growing-track 标记。

有时SDK自动采集的节点数据并不能完全满足上报分析需要。此时,我们可以通过额外信息的标记 data-title 来补充SDK采集的内容。例:

<button data-title="额外的上报信息">节点</button>

有时我们页面中可能存在类似列表类的Dom结构相似或一致使得SDK上报数据出现无法区分的情况。此时,我们可以通过索引标记 data-index 来准确描述节点信息。例:

<view>
    <button data-index="1">节点1</button> 
    <button data-index="2">节点2</button> 
    <button data-index="3">节点3</button>
</view>

有时页面中有需要跳转的链接(尤其是navigator组件)时,为了上报完整的用户目标去向。此时,我们可以通过链接标记 data-src 来上报点击链接的目标去向。例:

<navigator
    url="/pages/h5/h5?from=navigate"
    data-src="/pages/h5/h5?from=navigate"
    bindtap="onNavigatorTap"
> 
    <view >  ...  </view>
</navigator>

<view data-src="/pages/h5/h5?from=navigate" bindtap="onLinkTap"> 
    模拟一个链接
</view>

注意: 在有上述3种额外采集标记的节点上,必须绑定一个点击事件,SDK才能实现点击的额外数据采集。如果没有,需要您手动绑定一个空的点击事件。

示例:

Page({
  onLoad: {
    wx.setNavigationBarTitle({
      title: 'NewTitle'
    });
  }
});

注意:

1)指定title仅支持 String 格式。该功能适配SDK版本>=3.8.10支持。

2)想要设置页面标题并同时生效于SDK时,该方法必须在onLoad中调用;如果您业务中无法调整位置,则在不影响原逻辑的情况下无法生效于SDK。

3)部分框架可能会建议该方法调用时机为onReady(例如uni-app)或其他生命周期中,我们实际测试中在onLoad调用并无影响,因此您可放心在onLoad中使用。

4)在3.8.0-rc.9版本开始,我们提供了gioPageTitle字段供基础使用,但我们发现它无法覆盖大多数场景(例如需要动态修改时),因此我们废弃了它,高版本SDK仍会为您保持基础的向下兼容,请尽快修改为setNavigationBarTitle方式。

提示: SDK中事件title取值优先级为 setNavigationBarTitle > data.gioPageTitle(仅保持向下兼容,不保证能取到) > 页面config.json配置 > 全局app.json中tabBar配置

有时我们会根据业务中不同的需要使用一些自己开发的组件或第三方组件,可能会触发SDK的 chng 事件,但我们并不期望它发生。

此时,我们可以通过忽略采集标记 data-growing-ignore 来让SDK忽略对该组件的数据采集。

注意标记在事件绑定的节点上,没事件绑定的节点默认不会采集。例:

<view data-growing-ignore bindtap="onLinkTap">要忽略的节点</view>

用户标记一个元素并提供埋点事件,SDK 负责监控指定元素,当此元素出现在屏幕可视区域中时发送用户配置的埋点事件。因此您同样需要参考埋点事件在平台上进行事件类型和变量的预定义。

always:只要从屏幕不可见区域到可见区域即可计为一次曝光并上报。(默认值)

once:从屏幕不可见区域到可见区域曝光只上报一次。

微信小程序、阿里(支付宝)小程序(基础库>=2.7.0)、百度小程序、字节跳动小程序、QQ小程序。

快应用不支持。

使用方法一:

1、在需要标记的元素上添加 growing_collect_imp 样式名。

2、在节点上添加 data-gio-imp-track 和 data-gio-track-xxxx进行设置参数。

示例

<view  
    class="growing_collect_imp"  
    data-gio-imp-track="imp_user_var"  
    data-gio-track-name="Mike"  
    data-gio-track-age="16"
    data-gio-track-sex="boy"
>
监听的元素,必须有内容或额外样式来让节点有实际大小
</view>

1、在需要标记的元素上添加 growing_collect_imp 样式名。

2、在节点上添加data-gio-imp-track、data-gio-imp-attrs 属性。

data-gio-imp-attrs 允许接受一个Object或者JSON.stringify后的Object字符串,SDK会自动尝试进行格式化。

示例

Page({ 
    data: {    
        impAttrs: { name: 'Mike', age: '16', sex: 'boy' }
        // 或者
        impAttrs: JSON.stringify({ name: 'Mike', age: '16', sex: 'boy' })
    }
})
<view  
    class="growing_collect_imp"  
    data-gio-imp-track="imp_user_var"  
    data-gio-imp-attrs="{{ impAttrs }}"
>
监听的元素,必须有内容或额外样式来让节点有实际大小
</view>

以上两种使用方法对应产生的 cstm 事件相当于: ↓↓↓

gio(
    'track', 
    'imp_user_var', 
    { name: 'Mike', age: '16', sex: 'boy' }
);

单次曝光

如果您的曝光事件只需要统计一次或触发过于频繁导致曝光事件量过大,可以在节点上添加data-gio-imp-type="once"并设置唯一的节点id,来使得曝光逻辑变为单次上报。

<view
    class="growing_collect_imp"
    id="imp_1"
    data-gio-imp-type="once"
    data-gio-imp-track="imp_picture_var"
    ...
>
  监听的元素,必须有内容或额外样式来让节点有实际大小
</view>

当您需要添加半自动埋点的节点是动态渲染时(例如根据接口数据渲染不同的内容),SDK 可能会因为无法感知节点渲染时机而失去对标记节点的监听。此时,您需要调用 updateImpression 手动更新 SDK 的监听来保证您的动态渲染节点能够被监听到。

const { gio } = global;
Page({
  data: {
    impData: [],
  },
  onShow() {
    // 这里通过一个Promise来模拟调用接口
    const getData = new Promise((resolve) => {
      setTimeout(() => {
        resolve({ name: 'Lily', age: 18 });
      }, 3000);
    });
    getData.then((result) => {
      this.setData({ impData: result }, () => {
        // 在setData回调中调用 updateImpression 即可
        gio('updateImpression');
      });
    });
  },
});

注意: 1)被标记的节点必须有实际的大小,一个没有内容和样式的节点标记可能不会触发事件。

2)请勿在同一页面中大量标记半自动埋点浏览事件(如商品列表),可能会严重影响页面性能导致卡顿。

3)data-gio-imp-type配置项SDK版本>=3.8.4支持。

4)updateImpression 方法SDK版本>=3.8.11支持。

SDK文档中指定参数值为 Object类型 时,请注意以下限制:(非指定类型值均会被替换为空字符串,长度超限均会被截断)

key: String,length <=50

value: String | number 时 length <=1000

上一页数据采集API下一页旧版本与3.8对比

最后更新于2年前

这有帮助吗?

当点击 form表单中 form-type 为 submit 的 button 组件时,会将表单组件中的 value 值进行提交,SDK 会自动采集 submit 事件,发送数据包含但不限于以下信息:提交事件的发生时间、事件发生所在页面。

采集标记

1、采集标记

提示

2、补充数据标记

1)data-title

2)data-index

3)data-src

4)设置页面标题

默认情况下SDK会自动采集页面title,但当SDK可能无法识别或您使用了自定义标题时,可以通过在页面的onLoad生命周期中调用setNavigationBarTitle方法来设置原生页面标题并同时指定SDK上报事件时的title值。

注:阿里(支付宝/淘宝)小程序是setNavigationBar

3、忽略采集标记

半自动埋点浏览事件

曝光逻辑

支持范围

使用方法二:

手动更新半自动埋点监听

示例

其他

Object参数限制

button
​
​
​
​
​
​
​
​
参考文档
参考文档
​
​
​
​
​
​
​
​
​