一、电商平台插件快速集成
适合使用 Shopify、Magento、WooCommerce、PrestaShop、BigCommerce 等主流电商平台的用户。
- 登录 Criteo Commerce Growth 控制面板，点击 Assets > Events Tracking
- 选择所在电商平台，按照页面提示完成 OneTag 和商品目录插件的安装。
- 插件自动将 pixel 部署至所有页面，无需手动编码。
注意：部分国家/地区要求用户同意 cookie 才能触发像素，需额外处理用户隐私授权
二、通过 Google Tag Manager（GTM）管理部署
适用于使用 GTM 的开发环境，无需改动页面源码。
- 在 GTM 中新增变量（如 partnerID、siteType、email、productIDs 等）。
- 创建触发器（如 DOM Ready、页面类型匹配等）。
- 使用 Criteo 提供的 GTM 模板，配置标签类型为 OneTag，传入变量。
- 预览并调试通过后发布，GTM 自动注入 OneTag。
三、手动在网页源码中插入（适合开发者）
适合自行管理源码的团队，灵活配置事件追踪。
1. 在 <head>标签中添加异步加载脚本：
<script src="//static.criteo.net/js/ld/ld.js" async></script>
2. 在 <head>间插入以下 JavaScript 代码：
window.criteo_q = window.criteo_q || [];
var deviceType = /iPad/.test(navigator.userAgent) ? 't' :
/Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent)
? 'm' : 'd';
window.criteo_q.push(
{ event: "setAccount", account: YOUR_ACCOUNT_ID },
{ event: "setSiteType", type: deviceType },
{ event: "viewHome" } // 可按需替换为 viewItem/viewBasket/trackTransaction 等
);
在商品页用viewItem并传入item数组；
加入购物车用viewBasket；
交易完成用trackTransaction并传递订单号、商品列表、价格等。
3. 发布上线后
使用浏览器 DevTools 或 GTM preview 工具检测触发是否正常。
四、OneTag 性能与隐私保障机制
- 异步加载，不影响页面体验，平均响应不超过 25ms。
- 智能缓存与带宽检测：根据设备与网络条件调整请求数量 。
- 嵌套 iFrame & HTTP‑GZIP 压缩调用：确保用户体验与隐私安全。
✅ 推荐部署流程概览
- 确定部署方式（插件 / GTM / 手动）
- 获取 Criteo Account ID
- 插件安装或代码配置
- 使用 viewHome, viewItem, addToCart, trackTransaction等事件定义追踪
- 发布并验证：通过 GTM 预览或开发者工具检查请求是否正确发送
五、优化建议
搭配隐私策略处理 cookie 同意；
数据层变量命名清晰，一目了然；
商城快速迭代版本建议优先使用 GTM 管理；
运行环境复杂时考虑动态或子域代理 OneTag 引入。
