帮助文档
  • 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 提供支持
在本页
  • 圈选指标
  • 1. 什么时候应该重新圈选已经圈选过的元素?
  • 2. 同一个元素出现在 web 端和 WAP 端,可以只圈选一次吗?
  • 3. 能否一次圈选多组页面?
  • 4. 圈选模式里的高亮实线和高亮虚线分别表示什么?
  • 5. 圈选时有数,保存后指标管理里面暂无数据?
  • 6. 为什么我页面的 PV 会小于页面上元素的浏览量 (impression)?
  • 7. 今天创建的指标,我点进去选过去 7 天和过去 14 天,为什么数据是一样的?
  • web 圈选
  • 1. 为什么 web 圈选的元素只有点击量,没有浏览量?
  • 2. 如果提示 iframe 被禁用而无法进行圈选怎们办?
  • 3. 如何对带 hashtag 的 URL 进行各页面浏览量统计?
  • 4. web 搜索框里的内容可以采集吗?
  • 5. web 圈选时候页面加载不完全?错位?
  • 6. web 端已经装了 SDK,但是仍不能进行圈选。
  • 7. 圈选时提示目前无法使用圈选及热图
  • 移动端圈选
  • 1. App 上页面的定义是什么?
  • 2. 用 GrowingIO 的 APP 圈选 APP 时提示 url Scheme 不正确?
  • 3. 扫描圈选二维码,但是无法正常圈选

这有帮助吗?

  1. 常见问题与解决

圈选问题

上一页SDK集成下一页指标和维度

最后更新于3年前

这有帮助吗?

圈选指标

1. 什么时候应该重新圈选已经圈选过的元素?

简单说在元素的 XPath 改变的时候,大多数情况是在您上次圈选后,页面经历过重构后,需要重新圈选。

圈选一个元素,我们使用的是元素的 XPath 来唯一定位一个元素的,所以保存圈选的指标就是这个元素的 XPath 为主的一些信息。

什么是 XPath 呢?

引用维基百科介绍:

The XPath language is based on a tree representation of the XML document, and provides the ability to navigate around the tree, selecting nodes by a variety of criteria.In popular use (though not in the official specification), an XPath expression is often referred to simply as "an XPath".

大致译为:

XPath 其实是描述基于 XML 文档这种树型结构的语言,它以一些信息就可以定位这种树形结构的每一个元素。

XPath 中都有什么内容呢?

我们使用一条伪 XPath 来举个例子,下图中 “帮助文档” 区域的 XPath 为:

//*[@id="root"]/div/div/div[3]/div/div/div[3]/div/div[1]/div[1]/div[1]/div/div[1]

XPath 的规则是:

/          满足该绝对路径的元素//         所有满足其后面的规则的元素*          所有元素[表达式]    限定表达式[数字]:    第几个元素[last()]:  最后一个[@属性]:   满足该属性|          逻辑或,将多个路径合并到一起

XPath 图示

如果您依然半知半解,请遵循以下原则也可:

您圈选的元素和上次圈选时不一样了、位置变化、文字变化、页面变化等,都需要重新圈选。

2. 同一个元素出现在 web 端和 WAP 端,可以只圈选一次吗?

  • 如果 URL 完全一样,是可以的;

  • 如果 URL 不一样,圈选时就需要分别圈选。

3. 能否一次圈选多组页面?

GrowingIO 可以让用户方便的圈选定义一组多个页面。例如,在定义整页时,如果关闭路径,那么就可以直接定义整个域名下的所有页面。同时,我们也可以利用通配符 「*」 来定义同一域名下一组路径相似的页面。

具体使用可以参考圈选-定义页面。

4. 圈选模式里的高亮实线和高亮虚线分别表示什么?

高亮实线代表已经被圈选的元素,高亮虚线代表已经被圈选的同类元素。

5. 圈选时有数,保存后指标管理里面暂无数据?

可能是圈选该元素的所在页面带查询条件 query,保存带 query 的元素不会回溯过去不带 query 的数据,所以数据会从保存后开始匹配 query 的数据(iOS 用户圈选 H5 时是关不了query 的)。

6. 为什么我页面的 PV 会小于页面上元素的浏览量 (impression)?

  1. 元素有可能有跨页面的展示,您又进行了跨页面的圈选定义;

  2. 页面上的元素被多次展示,浏览量增加而页面没有再次加载;

  3. 定义了同类元素,元素 impression 是多个元素的和。

7. 今天创建的指标,我点进去选过去 7 天和过去 14 天,为什么数据是一样的?

如果是新创建的指标,指标需要回溯,而且只会回溯创建过去 7 天的数据,因此过去 14 天到过去 7 天都没数。

​

web 圈选

1. 为什么 web 圈选的元素只有点击量,没有浏览量?

  • 如果被圈选元素是 a, button, input,img,并且在倒数两层以下,只会统计点击量,不会统计浏览量。

  • 如果用户使用的是 IE8 及以下的 IE 浏览器版本,GrowingIO 无法统计元素浏览量 ,只会统计点击量。

2. 如果提示 iframe 被禁用而无法进行圈选怎们办?

GrowingIO 是使用 iframe 来加载目标网页进行可视化定义的。如果目标网站禁止了 iframe 加载,就无法正常定义标签,当点击某个按钮的时候,页面无法发生跳转且命令行显示:

Refused to display '**' in a frame because it set 'X-Frame-Options' to 'SAMEORIGIN'.

此时只允许同个顶级域名加载,所以需要设置http响应头允许 iframe 加载。

如果你的网站使用https协议,需向响应头添加配置

Content-Security-Policy: frame-ancestors 'self' https://www.growingio.comX-Frame-Options: Allow-From https://www.growingio.com

如果你的网站使用http协议,需向响应头添加配置

Content-Security-Policy: frame-ancestors 'self' http://www.growingio.comX-Frame-Options: Allow-From http://www.growingio.com

由于 Chrome 浏览器已经不再支持 X-Frame-Options 配置项,如果你只需在 Chrome 浏览器中进行圈选,建议通过浏览器检查后,只给 Chrome 请求的响应头添加配置

Content-Security-Policy: frame-ancestors 'self' http://www.growingio.com https://www.growingio.com

3. 如何对带 hashtag 的 URL 进行各页面浏览量统计?

我们默认不会把 hashtag 识别成页面 URL 的一部分。

对于使用 hashtag 作为单页应用页面切换的网站来说,可以使用 enableHT 来监听 hashtag 的变化,并区分页面来收集页面数据,每次 hashtag 改变都会触发一次 PV,hashtag 的信息也会记录在页面 URL 中。

4. web 搜索框里的内容可以采集吗?

可以。但是需要集成 SDK 时设置开启内容采集。

5. web 圈选时候页面加载不完全?错位?

部分浏览器存在不兼容的情况,推荐使用 Chrome 浏览器。

6. web 端已经装了 SDK,但是仍不能进行圈选。

  1. 有可能是工程师没有成功加载 JS;

  2. 可能是该网站禁止了 iframe 的加载,请联系工程师修改配置(参见第 3 点);

  3. 可能是工程师加载 JS 代码时的项目 ID 填写有误(项目 ID 没有空格)。

7. 圈选时提示目前无法使用圈选及热图

说明这个页面中加载的JS代码中的项目ID与当前圈选所在项目的ID不一致,您需要现在GrowingIO平台将项目切换至集成此应用的项目下再进行圈选。

移动端圈选

1. App 上页面的定义是什么?

  • Android:一个 Activity 或者 Fragment 是一个页面;

  • iOS:一个 ViewController 是一个页面。

2. 用 GrowingIO 的 APP 圈选 APP 时提示 url Scheme 不正确?

请参考我们的 APP SDK 接入部分。

注意安卓在添加 URL Scheme 时要加一整个 intent-filter 区块,并确保其中只有一个 data 字段。

3. 扫描圈选二维码,但是无法正常圈选

扫描二维码完毕后,点击落地页按钮是否正常唤起了APP呢?如果没有唤起APP, 有以下两种情况:

Android:

URL Scheme 填写错误, 请检查您的 manifest.xml 文件中 Url Scheme 是否和您官网的应用管理中的一致,示例代码如下:AndroidManifest.xml

<activity    android:name=".LauncherActivity"    android:theme="@style/AppTheme"    tools:replace="screenOrientation">    <intent-filter>        <action android:name="android.intent.action.MAIN" />        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>    <!-- GrowingIO Url Scheme 配置,请从官网的应用管理中获取,正确填写 -->    <intent-filter>        <data android:scheme="growing.您的 URL Scheme" />         <action android:name="android.intent.action.VIEW" />        <category android:name="android.intent.category.DEFAULT" />        <category android:name="android.intent.category.BROWSABLE" />    </intent-filter>    <!-- 即使含有自定义 scheme 也能正常唤醒,不互斥,不相互影响 -->    <intent-filter>        <data            android:host="share"            android:scheme="will" />        <action android:name="android.intent.action.VIEW" />        <category android:name="android.intent.category.DEFAULT" />        <category android:name="android.intent.category.BROWSABLE" />    </intent-filter></activity>

iOS:

如果能够唤起APP,但是看不到小红点:

Android:

(1)安卓移动端圈选在小米开发者版本和 MIUI8 稳定版下调不起小红点,是因为这两个系统版本禁止了悬浮框权限,您可以尝试授予 App 的悬浮框权限,或者换台手机圈选。

步骤:安全中心 - 授权管理 - 应用权限管理 - 找到您要设置权限的 App - 找到悬浮框权限 - 进行授权信任。当然也可以换用其他安卓手机进行圈选。

(2)请找开发确认以下事项:

i. 是否将<intent-filter/> 代码块配置在了 “闪屏页面”,并且在短时间内finish了这个 Activity ?

解答: 请将闪屏页面停留时间稍微延长,Gio 会在唤醒页面中检测是否登录了圈选,这时被 finish 将无法正常唤醒圈选。或者如果您不需要圈选闪屏页面, 请将<intent-filter/> 代码块放在主页的 Activity 中。

ii. 是否在配置 <intent-filter/> 代码块中的 Activity 中使用了 getIntent 呢?

解答: 请在您的逻辑中过滤掉 Gio 的 Intent ,我们的 Intent 大致格式是这样:

growing.xxxxxxxxxxx://growing/oauth2/token?loginToken=xxxxx.........

请您在代码逻辑中判断如果是以 growing 开头的 scheme 不处理它,代码示例:

// 请注意自己判断 intent 是否为空Uri data = intent.getData();if (data.getScheme().startsWith("growing.")){    Log.d(TAG, "GrowingIO url scheme, not process");}

iOS:

例如,GrowingIO 博客文章的地址如下: 具体路径,那么我们在路径中输入 /posts/* 就会圈选出所有的博客单篇文章的页面。注意此时的路径开关需要打开。

这部分需要在 时开启设置。

​,并检查确认和官网中的应用管理中的一致。

​。

https://blog.growingio.com/post/
SDK 集成
请参照文档正确配置 URL Scheme
是否添加了圈选激活代码