传输事件

大多数会话数据由 Yandex Metrica 计数器自动收集。 但是，您可能会发现用您自己的数据补充此数据会对您有利。 例如，您可能对购买了哪些特定商品或登录的用户执行了哪些操作的统计数据感兴趣。

Yandex Metrica 允许您将自定义数据集连接到会话。 这些集合称为_事件参数_。 该数据可以显示在报表中，或用于分组和细分的条件中。

使用 JavaScript API 将会话参数传输到计数器存储。 数据可以在计数器初始化期间发送，也可以会话超时过期之前的任何时间发送。

在计数器初始化期间，会话参数在 params 参数中指定。

要在用户于您网站上的会话期间传递事件参数，请使用 params 方法，或者使用 extLink、file、hit、reachGoal 方法的可选参数。

事件参数以对象或对象数组的形式进行传输。

传输和处理数据

数据作为 JavaScript 对象传输到 Yandex Metrica。

发送至 Yandex Metrica 的数据请求所含内容不得超过 8 KB（8,192 个字符）。 当您发送分层结构化数据时，Yandex Metrica 报表最多会显示 10 层嵌套层级。 如果在单个会话中，一个参数以不同的值传输，则 Yandex Metrica 将显示所有值。 需要注意的是，单一会话中最多可发送 512 个参数。 有关更多信息，请参阅限制。

根据字段值的类型，按如下方式处理字段值：

• object —— 为每个对象键创建一个新的树分支，并为每个值递归调用算法。
• string —— 计算字符串中每个不同值出现的次数。
• number —— 计算所有数字的总值和与平均值。
• array —— 创建一个 [Parameters] 树分支，计算该值是数组的次数，并为数组中的每个项目递归调用该算法。
• true、false 或 null —— 计算每个值出现的次数。

传输数据示例：

// 对象传输示例。最大嵌套深度：10 层。
ym(XXXXXX, "params", { 
  level1_1: {
    level2_1: {
      level3_1: "example1" ,
      level3_2: "example2",
    },
    ...
    level2_2: "example3"
  }
})

其中：

• XXXXXX 是计数器编号。
• level1_1、level1_2、level2_1 —— 事件参数的结构。
• example1、example2、example3 —— 参数的值。

有关更多示例，请参见会话参数发送示例部分。

按参数生成的报表

事件作为维度或目标传输至 Yandex Metrica。 通过处理数据计算出的数字是指标。

要查看已传输事件的统计数据，请使用“Event parameters”报表或“Session parameters”报表。 您还可以使用参数作为在其他 Yandex Metrica 报表中创建细分的条件。

与我们聊天

联系我们