# @aranova/tracking-browser 中文文档规范地址：https://npmcn.com/package/%40aranova/tracking-browser/ 版本：1\.21\.1 npm 元数据更新时间：2026-11-07T08:47:17.335Z 中文译文更新时间：2026-11-07T02:18:32.179Z 软件包许可：未声明本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。原始 npm 页面：https://www.npmjs.com/package/%40aranova/tracking-browser 原文对照：https://npmcn.com/package/%40aranova/tracking-browser/?lang=original 项目主页：https://github.com/AranovaIO/aranova_internal/tree/master/packages/tracking-browser 源码仓库：https://github.com/AranovaIO/aranova_internal ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.5 MB，4 个文件 - TypeScript 类型：未声明 - 运行依赖：1 个 - 首次发布：2026-04-10T07:47:27.445Z - 最新版本发布：2026-11-07T08:47:17.154Z - 近 30 天下载量：2070（2026-10-07 至 2026-11-05，npm 官方下载统计） - 已发布版本数：85（近 12 个月 85 个） ## 中文简介 Aranova 跟踪全局浏览器脚本( CDN /) ## 安装 ```sh npm install @aranova/tracking-browser ``` 也可以使用：`pnpm add @aranova/tracking-browser`、`yarn add @aranova/tracking-browser`、`bun add @aranova/tracking-browser` ## README # @aranova/ 跟踪浏览器 Aranova 追踪无法使用 React 或 Next.js 软件包的网站的全局浏览器脚本 . 此软件包用于CDN/script-tag安装,而非应用程序导入. ## 安装将脚本放入文档 `` 在剩余页面运行之前. ```html ``` 例如,在可能时将精确的版本用于生产 `@aranova/tracking-browser@0.5.1`。。。 . 追踪是默认的(同意v2,选择退出模式)——脚本船没有同意横幅和旧的 `renderConsentBanner` 选项是已贬值的无操作。拨接页脚 “ cookie 偏好” 控制到同意的 API (参见 **同意** (见下文)并披露在网站隐私政策中跟踪+选择退出. ## 遗留的静态 gtag 标识 `gtagId` 财务报告和审定财务报表 `gtagIds` 继续兼容 API。不为新安装使用 : 静态ID不编辑网站,无法消耗仪表板标记更改或墓碑. 若为维持一个遗留装置, `gtagIds` 装入每个条目并优先于 `gtagId`。。。 . ```html ``` ## 手动事件浏览器包在运行时验证手动事件. 如果某一事件未登记在以下 `triggers.manual`,或元数据形状无效,SDK警告并放弃事件. ```html ``` `fields[].value` 可以是任意的 JSON 值:字符串,数字,布尔,无效,数组,或对象并被存储为第一当事方 JSONB. 有意提交的牵头字段可能包括生名,电子邮件,电话号码,地址,选取,自由文本消息,以及提交用于第一当事方分析及牵头操作的文件数据. 从提交表单中明确构建数组; SDK 从未刮出任意 DOM 字段 . `File`编号 :`Blob` 对象必须转换为 JSON 表示; 单独上传更大的文件并发送其存储引用。事件元数据上没有执行字节限制——但是在导航冲出之前,一个提交文件已发射 `keepalive`,它的浏览器在64 KB附近并静静地下降,所以保持内嵌的有效载荷小. 从不发送密码,认证符,付款卡/银行证书,或私人密钥. 适用客户的隐私通知、同意、保留和规范的数据要求。 Google离线匹配使用正常的,服务器侧 SHA-256-hashed标识符——而不是原始的自由文本/文件元数据. ### 电话点击数 (`tel:` • 手动或自动抓取选择到 **自动抓取** 和每个 `tel:` 链接被跟踪,没有每个链接代码——添加 `autoCapture` 页:1 `phone_click` 在 `init()`数字 : ```js manual: { phone_click: { autoCapture: {} }, // default selector: a[href^="tel:"] // or narrow it: { autoCapture: { selector: "a.call" } } }, ``` 然后使用普通的电话链接——其他的都是由一个授权的听众操作的: ```html (416) 555-0199 ``` 数字是从 `href` (已正式改为E.164); `section` 来源于可选 `data-aranova-section`。。。 . **与 `cta_click`页:1 `phone_click` 还炒了Google广告转换** 联系电话目标(a) `CLICK_TO_CALL` ——自动点火窃听器被捕获了,所以你从不打电话 `trackConversion`. (消防需要) `trackingConfig` 有线;见页:1 喜欢用仪器连接自己吗? 以每个元件进行射击 —— 将转换同样的方式: ```html (416) 555-0199 ``` ### CTA 点击- 手动或自动抓取开火 `cta_click` 每个有内置处理器的元素,或选择使用 **自动抓取** 跳过处理者完全。添加 `autoCapture` 页:1 `cta_click` 在 `init()`数字 : ```js manual: { cta_click: { autoCapture: {} }, // default selector: [data-aranova-cta] // or target existing classes: { autoCapture: { selector: "a.cta, .btn-primary" } } }, ``` 然后标记您带有数据属性的 CTA —— 其余部分由单个授权的听器执行 : ```html Book now ``` `cta_name` 决定: `data-aranova-cta` 值, 否则元素的修剪文本 (封顶120个字符),其他 `tag#id`。。。 . `section` 来源于可选 `data-aranova-section`· ; `href`编号 :`destination_url` 和一个短 `element` 描述器是自动捕获的。点真实的 CTAs 选择器( 一个明确的属性是安全默认) — 每次匹配点击计数,包括后面的 `stopPropagation`。。。 . ### 自动居中+退出( E)`page_exit`(中文(简体) ) `page_exit` 自动捕获——没有注册。导航、标签隐藏和页面卸下记录 **活动** 在页面上花费的时间加上最大卷轴深度到达,通过一个恒定信标交付所以最后一页仍然算数。这种权力每页在“仪表盘分析”标签中停留和卸下;没有配置. ## 全球API ```js window.AranovaTracking.init(config); window.AranovaTracking.trackEvent(eventType, metadata); window.AranovaTracking.captureTrackingParams(); window.AranovaTracking.getTrackingParams(); window.AranovaTracking.sales().record({ ... }); // record a sale / conversion ``` ## 同意(v2——选择退出模式) 默认跟踪; 仅存储一个未过期的已忽略的已忽略块 gtag Meta Pixel, 和转换射击。降级是值得的 **90天时间**; 赠款从未过期。将页脚控制线连接到 : ```js window.AranovaTracking.optOut(); // explicit decline (90 days) window.AranovaTracking.optIn(); // explicit grant (never expires) window.AranovaTracking.resetConsent(); // clear the choice → back to default-granted window.AranovaTracking.getConsentChoice(); // { state, source, updatedAt, expiresAt } window.AranovaTracking.getConsentState(); // effective "granted" | "denied" ``` ```html ``` `setConsentState('granted' | 'denied')` 用于兼容性. `sales()` 返回绑定到 **公开** 键和终点 `init()`,所以只能这样 **写入** 改划(`record`) (中文(简体) ). 所有内容——列表, `summary` 电话键 `customers.*` 名册, `business.config()`,更新, 删除 - 要求a **隐藏** 键`aranv_sk_…`),并且必须通过 React/Next 运行服务器侧软件包。见 [销售跟踪指南](https://github.com/AranovaIO/aranova_internal/blob/master/docs/tracking-package/sales-tracking.md)。。。 . ## 现场转换射击通过生成 `ARANOVA_TRACKING_CONFIG` 参考文献 `init()`。浏览器 SDK 共享一个 R2运行时间用于Google标签加载,页面查看,自动目标,以及 `AranovaTracking.sales()` 开火它在Google命令之前确认当前对象; 仪表板标签更改、目标再映射和更高版本的已禁用墓碑 `public, max-age=60, must-revalidate` 没有运行或站点重新部署. ```html ``` 射击是经同意的,由 `transaction_id`。重新绘制现有密钥不需要代码源。 A 类 **新手动目标键** 仍然需要 `tracking-cli gen` 以刷新生成调用密钥列表和站点代码 `trackConversion(key)`。。。 . `conversionConfig: { cdnUrl }` 财务报告和审定财务报表生成 `ARANOVA_CONFIG_URL` 仍然是遗留的相容性 API; 不要用于新建安装。见 [转换-配置-schema.md](https://github.com/AranovaIO/aranova_internal/blob/master/docs/tracking-package/conversion-config-schema.md)。。。 . ## 自动事件配置自动事件由 SDK 发射: - `page_view` - `time_on_site` - `specific_page_visit` - `scroll_depth` - `multi_page_session` - `form_start` ## 常见问题 ### @aranova/tracking-browser 是什么？ Aranova 跟踪全局浏览器脚本\( CDN /\) ### 如何安装 @aranova/tracking-browser？在项目目录运行 npm install @aranova/tracking-browser，或使用 pnpm add / yarn add / bun add。 ### @aranova/tracking-browser 支持 TypeScript 吗？该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aranova\_\_tracking-browser 是否存在。 ### @aranova/tracking-browser 可以商用吗？ @aranova/tracking-browser 使用未声明许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @aranova/tracking-browser 的下载量有多少？根据 npm 官方下载统计，@aranova/tracking-browser 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,070 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @aranova/tracking-browser 还在维护吗？最新版本 1\.21\.1 发布于 2026/11/07（今天）；至今共发布 85 个版本，其中过去 12 个月发布了 85 个；首次发布于 2026/04/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。