# 追踪概览 (https://talivia.com/zh-CN/docs/tracking)



Talivia 浏览器追踪器会自动记录页面浏览，并提供一组精简的 JavaScript 接口，用于自定义事件、身份识别和结账归因。

## 脚本 [#脚本]

```html
<script
  defer
  src="https://talivia.com/script.js"
  data-website-id="YOUR_WEBSITE_ID"
  data-domain="example.com"
></script>
```

脚本会读取浏览器上下文、监测客户端路由变化并发送页面浏览。默认情况下，Talivia 将匿名访客 Cookie 保存一年，并维护一个活动后延长 30 分钟的会话 Cookie。

只有一个主机名时，不设置 `data-domain` 也能正常工作。Talivia 云服务生成的代码片段会包含它，因此 `example.com`、`app.example.com` 和其他子域名可以在需要时共享同一访客与会话。请保留**设置 → 数据追踪**中的完整代码片段，不要根据本示例自行重新拼装。

可选脚本设置请参阅[追踪器配置](https://talivia.com/zh-CN/docs/tracker-configuration)，完整的共享 Cookie 配置请参阅[子域名追踪](https://talivia.com/zh-CN/docs/subdomain-tracking)。

## 运行时接口 [#运行时接口]

脚本加载后会创建 `window.talivia`：

```js
window.talivia.track();
window.talivia.track('signup-click');
window.talivia.identify('user_123', { email: 'founder@example.com' });
window.talivia.getSessionId();
```

## 数据采集接口 [#数据采集接口]

追踪器会向 Talivia 的采集接口发送数据，并接收签名缓存令牌和跨域令牌。这些令牌有效期很短，只包含匿名追踪键，不包含账户或付款凭据。

## 收入上下文 [#收入上下文]

结账流程请按照已连接服务商的收入指南操作。Stripe 和 Yolfi 会在浏览器返回时使用唯一的结账会话编号。无法提供返回信号的服务商，可以在其支持的结账元数据中使用 `window.talivia.getSessionId()`。