监控
会话回放
浏览器 SDK 可以按用户看到的样子录制页面,并上传出错或提交问题报告前的那一分钟。控制台中每个项目的会话回放设置决定何时录制,所以无需改代码即可使用,Odoo 中也一样。录制器是一个独立的 61 KB 插件,只有在回放开启时才从 blipit.io 加载,核心脚本依然很小。
1选择何时录制
在 app.blipit.io 中打开项目并选择会话回放设置。“出错和提交问题报告时”是每个项目的默认设置:在浏览器内存中保留最近 60 到 120 秒,只有在捕获到错误或有人提交问题报告时才上传,之后继续录制;没有问题的访问从不上传。“所有访问(抽样)”会从头录制你选择的访问比例(1% 到 100%),无论是否出问题,其余访问保留错误缓冲。“关闭”不加载任何内容。所有者、管理员和可以编辑该项目的人都能更改,浏览器约在一小时内获取更改。
2哪些可见,哪些被遮盖
遮盖在浏览器中、发送任何内容之前完成。输入的值、页面文字、表格单元格和记录名称都会变成星号,所以表单字段显示为 客户: ******。标签和按钮保持可读,方便你看清访客做了什么:表单标签、图例、表格和列表的列标题、表格标题、按钮、标签页、菜单项、导航链接,以及 Odoo 中的字段标签、状态栏、笔记本标签页、应用菜单和控制面板按钮。即使在这些地方,数字、日期、邮箱、链接和 @用户名也会被遮盖,按钮显示为 Pay $**.**,title、alt、aria-label 和 placeholder 属性同样被遮盖。字段值、表格单元格、看板卡片、活动或聊天中的内容即使显示为按钮也始终遮盖,看板列标题可能是分组值,因此也会遮盖。即使位于标签或按钮内也始终遮盖:输入框、文本区域、下拉选择及其选项、可编辑区域、表格单元格和字段值、标题、面包屑、聊天记录(chatter)、看板卡片、账户/用户/个人资料菜单,以及搜索和自动补全列表。图片、视频、音频、canvas、iframe 和密码字段会变成同样大小的空框,带 data-blipit-block 的内容会被屏蔽,页面 URL 中类似令牌的值会被脱敏。如需像以前一样遮盖所有文字,请在项目的会话回放面板中关闭“在回放中显示标签和按钮”。给元素加上 data-blipit-mask 可始终遮盖它,加上 data-blipit-unmask 可显示你选定元素的文字;data-blipit-mask 优先。
<div data-blipit-mask>Always masked</div>
<span data-blipit-unmask>Plan</span>3观看回放
“回放”按项目列出录制,可筛选有无错误,也可按 URL 筛选。播放器支持播放、1x、2x、4x、跳过无操作时段,每个错误有一个红色标记并链接到其问题。最新事件带有回放的问题会显示“观看回放”。
4在代码中覆盖
Blipit.init 中的 replay 选项在该网站上优先于项目设置:onErrorSampleRate(默认 1)是保留错误缓冲的访问比例,sessionSampleRate(默认 0)是从头录制的访问比例,labels: false 会遮盖该网站上的所有文字。replay: false 会在该网站关闭回放,无论项目如何设置。
Blipit.init({
key: "<public key>",
release: "2026.09.28",
replay: { sessionSampleRate: 0.05, onErrorSampleRate: 1 }
});5移动应用:Android
移动端会话回放适用于使用 blipit-android 0.3.0 或更高版本的 Android 应用,也适用于华为设备,因为该 SDK 不依赖 Google Play 服务或 Firebase。iOS、React Native 和 Flutter 即将推出。使用同一个项目设置:“出错和提交问题报告时”会在设备内存中保留最近 30 秒,只有在发生错误或有人提交问题报告时才上传;“所有访问(抽样)”会完整录制你选择比例的应用会话。回放需要 Android 8.0(API 26)或更高版本;旧设备仍会上报错误,但没有回放。
implementation("com.github.blipit-io:blipit-android:v0.7.5")Blipit.init(this) {
key = "<public key>"
project = "<project id>"
}6先征得同意
在你的应用调用 Blipit.setReplayConsent(true) 之前,不会录制任何内容;默认值为 false。先展示你的告知说明(见下文),在用户同意后调用。该选择保存在设备上,只有在选择改变时才需要再次调用。Blipit.setReplayConsent(false) 会立即停止录制并丢弃缓冲区,请在应用设置中提供此选项。Blipit.hasReplayConsent() 返回当前的选择。
allowButton.setOnClickListener { Blipit.setReplayConsent(true) }
replaySwitch.isChecked = Blipit.hasReplayConsent()
replaySwitch.setOnCheckedChangeListener { _, on -> Blipit.setReplayConsent(on) }7移动端回放会录制什么
大约每秒一帧你应用自身的界面,在设备上编码为一个小的 H.264 视频,另外还有点按、界面切换、面包屑、设备型号、Android 版本和应用版本。其他应用、系统界面、通知以及应用处于后台时的任何内容都不会被录制:应用一进入后台录制就会暂停,在后台 30 秒后停止。Blipit 从不使用 AccessibilityService 或 MediaProjection,因此不会弹出录屏授权,也没有前台服务。在按流量计费的(移动)网络上会降低视频质量,所有数据只通过 HTTPS 发送给 Blipit。
8在设备上遮盖哪些内容
遮盖在设备上完成,发生在保存任何一帧之前:所有文字、所有图片、所有输入框(EditText 和 Jetpack Compose 文本框)、WebView 和视频播放器都会画成实心色块。在 Blipit.init 中设置 replayLabels = true,可让基于 View 的界面上的标签和按钮文字保持可读;输入框和图片仍被遮盖,Jetpack Compose 界面仍完全遮盖。给某个视图加上 android:tag="blipit-mask" 可让它始终被遮盖。
<TextView
android:id="@+id/balance"
android:tag="blipit-mask" />9面向儿童的应用
面向儿童的应用请保持回放关闭(Google Play 家庭政策、COPPA、App Store 儿童类别)。在 Blipit.init 中设置 childDirected = true,或调用 Blipit.disableReplayForChildApp();这样即使用户同意,回放也永远不会启动。
Blipit.init(this) {
key = "<public key>"
project = "<project id>"
childDirected = true
}10应用商店合规清单
- 在录制任何内容之前征得同意:只有在用户同意后才调用 Blipit.setReplayConsent(true)。
- 在征求同意之前,用下面的文字在应用内显著告知。
- 在隐私政策中提及 Blipit 和会话回放;下面的 AppGallery 段落适用于所有应用商店。
- 用下面的答案填写 Google Play 的“数据安全”表单和 AppGallery 的隐私标签。
- 面向儿童的应用请保持回放关闭。
- 尊重撤回:在应用设置中提供一个调用 Blipit.setReplayConsent(false) 的开关。
11Google Play“数据安全”表单答案
在 Play Console 的“应用内容 > 数据安全”中使用这些答案。类别和用途名称按英文版控制台的显示保留。
- App activity > App interactions:收集,不共享,可选。用途:App functionality、Analytics。
- App info and performance > Crash logs:收集,不共享。用途:App functionality、Analytics。
- App info and performance > Diagnostics:收集,不共享。用途:App functionality、Analytics。
- 你的应用收集的所有用户数据在传输过程中是否都经过加密?是。
- 你是否为用户提供了请求删除其数据的方式?是。
12可直接粘贴的应用内告知
在征求同意之前展示这段文字,放在单独的页面或带有“允许”和“暂不”按钮的对话框中,并把设置路径改成与你的应用一致。
- 本应用会在发生错误或提交问题报告前,录制最长 30 秒的屏幕和点按的遮盖视频,并发送给我们的错误监控服务提供商 Blipit,用于修复问题。文字、图片和你输入的内容都会被隐藏。你可以在“设置”中关闭此功能。
13华为 AppGallery 隐私声明
把这段文字粘贴到你的隐私声明中,并替换方括号内的部分;它也适用于 Google Play 和其他应用商店。在 AppGallery Connect 中,在应用的隐私标签里声明有第三方 SDK 收集应用活动(交互)和诊断数据(崩溃日志),不共享、不用于广告。
- 错误监控与会话回放。我们使用 Blipit(由 Louward Labs FZC LLC 运营的错误监控服务,位于阿联酋阿治曼)作为数据处理者。在你同意后,本应用会保留一段简短的、经过遮盖的应用自身界面录像(文字、图片和你输入的内容在保存前就已在你的设备上隐藏),以及你的点按和界面切换、设备型号、操作系统和应用版本。只有在发生错误、你提交问题报告或针对一小部分抽样会话时,才会通过加密连接(HTTPS)发送,且仅用于查找和修复应用中的问题。不会出售,也不会用于广告。录像会在 [7/14/30] 天后自动删除。你可以随时在 [设置 > 隐私] 中撤回同意,并通过 [联系方式] 申请访问或删除你的数据。
14App Store 隐私标签(用于 iOS 版本)
适用于即将推出的 iOS SDK。在 App Store Connect 的 App Privacy 中声明:
- Usage Data > Product Interaction:App Functionality、Analytics。
- Diagnostics > Crash Data 和 Other Diagnostic Data:App Functionality、Analytics。
- 不与用户身份关联,除非你调用了 Blipit.setUser;那样请标记为已关联。
- 不用于跟踪(tracking)。
须知
- 每月回放数:Free 25 条,Solo 500 条,Team 2,500 条,Scale 5,000 条;Free 保留 7 天,Solo 14 天,Team 和 Scale 30 天。当月回放用完后,项目设置在下个月前一律返回“关闭”,不会产生任何费用。
- 录制在 60 分钟、500 个片段或 20 MB 后停止。数据块每 10 秒或达到 1 MB 时以 gzip 发送,标签页关闭时发送最后一块。
- 在网站上,Blipit 浏览器脚本录制回放;在 Android 应用中,由 Blipit Android SDK 发送回放。
- 移动端回放与网页回放共用每月额度和保留期限,视频文件会随回放一起删除。
遇到问题?发邮件至 support@blipit.io。每个项目的密钥和项目 id 在 app.blipit.io 的“API 密钥”下。