接入网站
追踪器是放在您网站页面上的一小段脚本。它统计页面浏览、传递客户行为（浏览商品、加入购物车、下单、登录）、展示推荐小组件，并为访客订阅 Web Push。接入所需的一切都在用户互动 → 网站板块中。
此板块对所有项目成员开放。“所有者”“管理员”和“经理”可以修改网站域名和小组件。“所有者”和“管理员”可以创建网站密钥。
安装追踪器
安装选项卡包含三个步骤。
1. 用于每个页面的代码
- 在写入密钥字段中选择密钥。如果没有密钥，请点击创建网站密钥。
- 点击复制按钮复制代码。
- 将代码粘贴到网站所有页面的
<head>中，通常放在公共页头模板里。
代码如下所示（板块中已填好地址和密钥）：
<script>
!function(w,d,u){var c=w.cdp=w.cdp||[];if(c.version)return;['init','page','track','identify','alias','reset','widgets','renderRecommendations'].forEach(function(m){c[m]=c[m]||function(){c.push([m].concat([].slice.call(arguments)))}});var s=d.createElement('script');s.async=1;s.src=u;d.head.appendChild(s)}(window,document,'https://cdp.onetrace.pro/tracker/cdp.js');
cdp.init('cdp_wk_…', { host: 'https://cdp.onetrace.pro' });
cdp.page();
</script>
脚本异步加载，不会拖慢网站。可以在代码之后立即调用 cdp.track()：这些调用会等待追踪器加载完成。追踪器会为每个浏览器分配一个持久的访客标识符（有效期一年的 cookie cdp_aid），并保存访问的 UTM 标签。
写入密钥在页面代码中可见，这是正常的：它只能用于发送事件。如果列表中的密钥不可选，说明它们是在此板块出现之前创建的，无法完整显示。请创建新的网站密钥，或使用网站上现有代码中的密钥。
2. 检查
安装后，打开网站的任意页面。几秒钟后，检查模块中会出现一个表格：域名、7 天内事件数和最新事件的时间。尚无事件时，板块会显示“正在等待首批事件”。板块打开期间，检查结果每 10 秒自动刷新一次。
3. 网站域名
为防止其他网站以您项目的名义发送事件和获取推荐，请指定您网站的域名：
- 输入域名，例如
shop.example.com，然后点击 +。检查表格中的域名可以通过添加到域名按钮添加。 - 点击保存。
域名同时允许其子域名：shop.ru 也允许 www.shop.ru。列表为空时，密钥可在任何网站上使用（“无限制”）。来自您服务器的请求不受此限制。最多可指定 20 个域名。
客户登录和退出
在登录或注册后，使用用户在您系统中的 id 调用 cdp.identify()，访问历史就会与客户的档案关联：
cdp.identify('user-42', { email: '[email protected]' });
请仅为已登录用户传递 User ID，并且不要使用 0 或 guest 之类的通用值：User ID 相同的档案会被合并。退出账户时请调用 cdp.reset()，让下一个使用这台电脑的人获得新的标识符。
商品事件
商品事件选项卡展示了四种操作的现成调用：商品浏览、加入购物车、订单以及登录和注册。事件名称和商品 id 属性（默认为 product_id）取自推荐板块的设置。如果那里尚未选择事件，您会看到警告，示例中将使用默认名称：product_viewed、add_to_cart、order_completed。
订单示例：所有商品都放在 products 数组中传递：
cdp.track('order_completed', {
order_id: 'A-1001',
amount: 9980,
products: [{ product_id: 'SKU-1', quantity: 2, price: 4990 }],
});
每个步骤都有一个标记：7 天内收到了多少事件以及最新事件的时间，或“7 天内没有事件”。这样可以看出哪些调用尚未生效。商品 id 必须与商品目录中的 id 一致。
订单和注册从您的服务器发送更可靠，参见服务器端集成。
Web Push
Web Push 选项卡显示渠道是否已接入以及订阅数量。如果尚无渠道，请通过打开集成链接创建，密钥会自动生成（参见集成与渠道）。然后：
- **Service worker 文件。**在网站根目录创建
cdp-sw.js文件，内容只有一行：importScripts('https://cdp.onetrace.pro/tracker/cdp-sw.js'); - **订阅按钮。**在网站上添加一个按钮，点击时调用
cdp.push.subscribe()。浏览器只会在访客主动操作时请求通知权限。
通知仅在使用 HTTPS 的网站上有效。订阅会与访客的档案关联。
CMS 和 Google Tag Manager
CMS 和 GTM 选项卡提供了针对自建网站、Google Tag Manager、1C-Bitrix、Tilda、WordPress 和 WooCommerce、InSales 的分步说明：在哪里插入安装代码、事件和小组件。
例如，在 Google Tag Manager 中创建一个“自定义 HTML”代码，填入安装代码，并使用“所有网页”触发器。商品事件需要单独的代码，调用 cdp.track，并使用基于 dataLayer 事件（view_item、add_to_cart、purchase）的触发器。发布容器后，请在安装选项卡中确认事件已开始到达。
借助 AI 智能体接入
如果开发人员借助 AI 智能体（Claude Code、Codex、Cursor 等）开发您的网站，请将现成的技能交给智能体。在 AI 智能体 选项卡中点击 下载 SKILL.md。文件中包含面向智能体的英文说明以及您项目的数据：OneTrace.pro 地址、所选的写入密钥、商品事件名称、小组件和 Web Push 状态。智能体可据此自行添加安装代码、商品事件、登录和退出、小组件以及通知订阅。
- 如果有多个写入密钥，请选择所需的密钥。
- 下载文件并放入网站项目：Claude Code 放在
.claude/skills/<技能名称>/SKILL.md，其他支持 Agent Skills 的智能体放在其技能文件夹中，例如.agents/skills/<技能名称>/SKILL.md。选项卡中显示了确切路径。也可以直接将文件附加到您发给智能体的消息中。 - 向智能体说明任务——选项卡中有示例文本。
秘密密钥绝不会写入技能。如果您在推荐设置中更改了事件或添加了小组件，请重新下载技能。