概述
通过 Singular Web SDK，您可以跟踪网站上的用户访问、转化和事件。如果实施得当，Singular 可将网站转化率归因于促成这些访问的营销活动，让您全面了解网络营销业绩。
信息：网站归因是一项企业功能。请联系您的客户成功经理，为您的账户启用该功能。
网络归因如何工作
Singular Web SDK 使用 JavaScript 通过浏览器识别用户，并跟踪他们访问网站的过程。当用户访问您的网站时，SDK 会确定该用户是首次访问，还是在网络营销活动后再次访问。
主要功能包括
- 跟踪页面访问和用户会话
- 记录转换事件（购买、注册、订阅）
- 测量与您的业务相关的自定义事件
- 将转换归因于营销活动
- 与移动 SDK 结合使用时的跨设备归因（需要订阅跨设备功能）
开始之前
在实施 Web SDK 之前，请确保您具备以下条件：
| 要求 | 说明 |
|---|---|
| SDK 密钥 | 您的 Singular SDK 密钥。请在开发工具 > SDK 集成 > SDK 密钥下的 Singular 账户中查找。 |
| 网站访问权限 | 在网站 HTML 中直接或通过标签管理系统添加 JavaScript 代码的权限。 |
| 事件规划 | 您要跟踪的事件（如购买、添加到购物车、注册）的文档列表。 |
| 隐私政策 | 如果启用跨子域跟踪（使用cookie），则更新隐私政策。 |
选择集成方法
Singular提供两种整合方式。请选择最适合您的技术设置的方法：
本地 JavaScript 实现
最适合可直接访问网站代码的团队、熟悉 JavaScript 的开发人员，或希望获得最大控制权且第三方依赖性最小的情况。
优点
- 不会被常见的广告拦截器拦截
- 更快的页面加载性能
- 更可靠的跟踪
- 直接控制实施
- 支持横幅广告
缺点
- 需要更改网站代码
- 更新需要开发人员的参与
小贴士在大多数情况下，Singular 建议使用本机 JavaScript 实现，因为它具有更好的可靠性，而且不太可能被广告拦截器拦截。
谷歌标签管理器实施
最适合已经使用 Google Tag Manager 的团队，需要在没有开发人员协助的情况下进行更改的营销团队。
优点
- 无需直接更改代码
- 非技术团队更容易管理
- 可通过 GTM 界面部署更改
缺点：
- 经常被广告拦截器拦截
- 依赖于 GTM 的正确加载
- 调试更加复杂
- 不支持横幅广告
重要！只实施一种方法。同时使用本地 JavaScript 和 Google 标签管理器会导致重复跟踪和指标膨胀。Singular 不会自动重复事件。
了解关键概念
产品 ID（应用程序捆绑 ID）
产品 ID 用于向 Singular 标识您的网站。它必须使用反向 DNS 符号，类似于移动应用程序捆绑标识符。
格式：com.website-name
示例：
- 正确：
com.acme - 不正确：
acme-store - 不正确：
www.acme.com
提示！在网站的所有页面上使用相同的产品 ID。如果同一网站有多个子域： (www.acme.com,shop.acme.com,store.acme.com) ，则应为所有子域使用相同的 Product IDcom.acme 。拥有不同域名的网站或网络属性：（www.site1.com,www.site2.com,www.site3.com ），应在您的Singular账户中为每个网站或网络属性创建单独的产品ID，并将其视为单独的应用程序。
会话和再参与
什么是会话？
在Singular跟踪中，会话代表用户与网站接触的一段不同时期。与HTTP会话（在页面请求中保持登录状态等技术状态）不同，Singular会话以分析为重点，测量用户的活动模式，用于归因和参与度指标。
会话创建时间
当出现以下情况时，Singular 会自动创建新会话
- 用户30 分钟或更长时间未活动（默认会话超时）
- 用户访问时使用了新的营销活动参数（不同的广告源）
- 用户来自不同的推荐网站
会话超时与重新参与不活跃窗口
了解两种不同的基于时间的设置非常重要：
会话超时（SDK 级别）
- 控制新会话开始的时间
- 默认值：WebSDK 为 30 分钟，移动 SDK 为 60 秒
- 可通过 SDK 初始化进行配置
- 每次检测到用户活动时重置
- 用于基于会话的指标（会话计数、会话持续时间等）
再参与非活动窗口（平台级）
- 控制何时符合重新吸引归因条件
- 默认：7 天
- 在 "设置">"应用程序 "中按应用程序配置
- 确定用户在重定向营销活动点击算作再参与事件之前必须保持非活动状态的最短时间
- 不影响常规会话创建
示例场景
考虑以下用户
- 访问您的网站，5 分钟后离开
- 45 分钟后通过重定向广告返回
会发生什么？
- 创建新会话（超过 30 分钟会话超时）
- 没有发生再参与归因（用户在 7 天内没有不活动）
- 访问将作为与前一个归因来源相关联的正常会话进行跟踪
如果同一用户在 10 天未活动后通过重定向广告返回：
- 创建一个新会话
- 触发再接触归因（超过 7 天未活动窗口期）
- 事件被记录为重新参与，并适当归因于重定向广告系列
配置选项
自定义会话超时：
会话超时可在 SDK 初始化期间进行调整。请查看我们文档中与您的实施方法相关的 WebSDK 初始化选项：本地 JavaScript或Google 标签管理器
自定义再参与非活动窗口：
通过导航到 "设置">"应用程序"，并扩展 Singular 平台中的 "显示高级设置 "选项，可为每个应用程序自定义用于重新吸引归因的 "重新吸引非活动窗口"。请根据典型的用户参与模式和重定向营销策略进行调整。
信息：如果需要，可以自定义非活动期。请在 "再参与常见问题 "中阅读更多相关信息。
活动：转换与标准
Singular 区分两种类型的事件：
转换事件：表明成功的关键业务行为（购买、订阅、注册、下载）。这些事件会出现在归因报告和投资回报率计算中。
标准事件：有助于了解用户行为的辅助操作（页面浏览、添加到购物车、视频播放）。这些会出现在原始数据报告中，有助于分析用户旅程。
提示！在 Singular 账户设置中配置哪些事件被归类为 "转换事件"。这样可以确保它们出现在正确的报告中。
隐私和 Cookie 使用
默认情况下，Singular 不使用 Cookie。但是，如果启用跨子域标识符持久性，Singular会设置一个第一方cookie，以跨子域维护用户身份。
Cookie 详情（启用时）：
| 属性 | 值 |
|---|---|
| Cookie 名称 | singular_device_id |
| 目的 | 为用户分配一个唯一的 ID，以便在不收集个人信息的情况下跟踪他们在不同会话中的活动和互动。 |
| 持续时间 | 1 年 |
| 类型 | 第一方 cookie（在您的域中设置） |
| 隐私政策 | https://www.singular.net/privacy-policy/ |
重要！如果启用跨子域跟踪，请更新网站的隐私政策，披露singular_device_id cookie 的使用情况。
下一步
- 选择集成方法（本地 JavaScript 或 Google 标签管理器）
- 按照所选方法的分步实施指南进行操作
- 使用提供的验证步骤测试您的实施
- 查看故障排除指南，了解最佳做法