@ a2f0/ ct 客户端
无框架,分批点击跟踪. 导入或构建跟踪器开始 没有收听者、计时器、存储器或请求。 明确调用 已部署的浏览器靴子, 在精确检查注册生产后 或中转原产地; 避免使用共享组件和测试.
安装方式 bun add @a2f0/ct-client 或者说 npm install @a2f0/ct-client。 。 。 .
import { createTracker } from "@a2f0/ct-client";
const tracker = createTracker({
site: "a2f0-net",
app: "desktop",
environment: "production",
capture: "all",
page: () => "/skyline-3d",
});
tracker.init();
await tracker.flush();
tracker.setOptOut(true);
tracker.destroy();
该地点必须登记在API的确切出处。 默认终点 实值 https://ct.a2f0.net/v1/点击。浏览器 MESM 已自成一体; TypeScript 类型 包含。 没有运行时间依赖. init 投放无效的站点/ 应用程序名称、 环境或端点 URL, 然后再添加听众 . 初始化跟踪器前验证配置 .
选项
| 选项 | 默认 | 行为 |
|---|---|---|
| 站点 | 需求 | 公共网站标识符,小写字母/数字/连字符 |
| 应用 | 无效 | 默认 App swit, 小写字母/数字/连字符, 1–64 个字符 |
| 环境 | 服务器推断 | 生产或中转; 必须与注册地点和确切来源相匹配 |
| 页 次 | () => '/' | 稳定路由模板,没有记录的ID或令牌,最多200个字符 |
| 捕获 | 交互式 | 所有元素、交互式控制或标记元素 |
| 批量大小 | 20国 | 每个请求1-50克 |
| 冲出相机 | 5000块 | 100至60 000毫秒 |
| 最大队列大小 | 500个 | 以批量大小和1,000为界 |
| 启用 | 真实 | 虚假使它变成惰性 |
| 覆盖Gpc | 虚假 | 只有真忽略了全局隐私控制;其他选择退出仍然适用 |
| 结束点 | CT 结束点 | HTTPS, 或关于本地主机促进发展的 HTTP |
抓取值为“ 全部” 、“ 交互式” 和“ 标记 ” 。 指定一个稳定的标签 data-ct="开通建设". 从不将用户内容放入此属性 。 使用 data-ct-ignore在元素或祖先上排除子树. 输入、文本区域、, 选择,并总是排除可编辑的内容。 打开影子DOM和SVG的工作.
将嵌入式应用程序包入 data-ct-app="skyline"中最接近的属性
点击的由路径构成的路径覆盖了跟踪器默认值,包括未标记的路径
画布在打开的阴影根内单击。 无效或空的最近属性
生成无效而不是继承另一个应用程序。 每个主机使用一个跟踪器
网站;网站保留 a2f0-net 而其桌面、天线和其他嵌入式
应用程序获得单独的应用程序值. 封闭的阴影根只暴露他们的宿主
跨原生的 iframe 点击需要该框架内部的跟踪器.
每个跟踪器固定环境,每批发送一次。 收藏家会得到 由注册网站和确切请求生成 值拒绝整个批次。 旧客户端可能忽略两个维度: app是 环境是无效的。 从不将用户数据放入应用程序名中. 初始化 仅涉及有意登记的生产或中产地,从未涉及当地, 预览、测试或自动页面.
init 拒绝 WebDriver 控制的浏览器: 它返回错误, 并添加无 听众 只有可信任的点击被捕获;合成的点击被忽略. 输入 是偶数,并返回当前是否允许抓取。 销毁删除 听取者, 中止请求, 并丢弃队列; 后进即可启动 再来一次 冲浪发送一个批次和时间表 剩余的工作。 网络错误, 超时, 408 和 429 重试并加盖回放; 其他 4xx 回复丢弃 被拒绝的批次。 事件ID使重试 象徵.
选择出去
设置 OptOut( true) 在 localStorage 中保存 ct: opt- out=1, 清除队列并停止 为这个网站捕获。 setOptOut(假)去除此偏好。 跟踪器 荣誉 DNT,全球隐私控制以及CT扩展的数据-ct-失效标记. 要明确仅覆盖全球隐私控制, 请通过覆盖Gpc: true to 在调用前创建 Tracker 。 违约是虚假的。 这适用于抓取 并且只交付给追踪器。 DNT, 保存和模拟的退出,扩展, 存储出错,自动浏览器守卫仍然无法跟踪. 选择退出无法撤回服务器已经收到的请求 。 存储出错 无法跟踪 。 扩展适用于所有地点,必须安装 每个浏览器/配置中分别显示。 首选项不同步 .
队列在记忆中 。 点击量满后会降低。 隐藏页面尝试 持续冲出,但关闭/挤出/下行导航可能会丢失未发送的事件. 这是最好的分析,不是审计线索或账单来源。 没有饼干, 访问者 ID 、 本地点击历史、 文本、 hrefs、 DOM ID 、 类或窗体值 由SDK收集。 页面默认为“/”所以动态的路由永远不会被推断.
默认的 CT 收藏器添加了全部请求的 IP 和 大致的国家, 州/地区,城市,大陆, 和时区 当一批货到达。 这些领域 最多储存了90天,可供提供设备的管理员在 认证仪表板和数据API. SDK没有发送仪表板证书。 IP可以链接活动;这不是匿名分析. 获得接受 即使明确启用了覆盖Gpc,批量还是收到此元数据. 见 收集数据政策 在决定向网站的访客披露什么时.