测量协议
测量协议是一种工具,允许您通过 HTTP 请求将用户交互数据直接从您的服务器发送到 Yandex Metrica 服务器。 它通过补充标准网站计数器所收集的数据,增强了数据收集和分析能力。
注意
测量协议最好与 Yandex Metrica 计数器自动收集数据的功能配合使用,而不是将其作为替代。
使用情况
将在线会话与您的数据相关联
-
测量协议允许您将 Yandex Metrica 计数器在您的网站上收集的数据与网页计数器无法跟踪的数据相结合。
例如:
- 为用户的会话补充有关未安装 Yandex Metrica 计数器的页面的信息;
- 发送关于通过网页计数器记录的、填写了会话表单的潜在客户质量的数据。 为此会话添加一个转化事件以进行深入分析。
在客户端和服务器端跟踪操作
- 借助测量协议,您可以从客户端和服务器端传输数据。 当广告拦截器或浏览器设置导致客户端数据收集受限时,这尤其有用。
更精准地传输 E-commerce 事件数据
- 测量协议允许您直接从服务器传输 E-commerce 事件数据。 当用户在获取页面之后不再返回网站,或者由于用户网站上存在第三方脚本拦截器等其他原因,导致网页计数器无法捕获数据时,此功能非常有用。
传输的数据
借助测量协议,您既可以在计数器上创建新的会话,也可以对现有会话进行补充。
发送数据时使用的主要标识符是 Yandex Metrica 的 ClientID。 它能让您将传输的数据与用户在计数器上的历史记录和会话关联起来。
您可以发送:
- 页面浏览次数;
- JavaScript 目标完成情况;
- E-commerce 事件(产品浏览、购买、加入购物车或从购物车移除);
- 会话参数。
如何设置数据传输
-
在计数器设置中启用测量协议并获取授权令牌。
要发送数据,请转到 Yandex Metrica 界面或 API 中的数据安全与使用部分,并在计数器的附加设置中启用测量协议选项。 您将收到一个令牌,必须在向 mc.yandex.ru/collect 发送请求时附上该令牌。 您最多可以创建 5 个额外的授权令牌。
-
记住用户的 ClientID 标识符。
发送测量协议数据时使用的主要标识符是 Yandex Metrica 用户的 ClientID。 在 Yandex Metrica 记录的用户会话期间,请在您的服务器上记住此 ID,以便进一步传输数据。
-
发送数据。
向 mc.yandex.ru/collect 发送一个 POST 或 GET 请求,其中列出必要的参数和在第 1 步中获取的令牌。 20 分钟内,数据将被记录到计数器中。
更新网络会话的限制
借助测量协议,您可以传输过去 12 小时内发生的事件数据。 因此,只有当现有会话结束时间距今不足 12 小时时,您才可以更新该会话。
如果您想在用户历史记录中添加更多事件,且其上一次会话结束时间已超过 12 小时,请创建新会话:
- 使用 API 测量协议,用相同的用户 ID (ClientID) 创建新会话。
- 发送事件数据。 该数据将更新用户的历史记录。
如果您需要在不创建新会话的情况下为旧会话添加数据,请尝试发送离线数据。