---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.1
alternate:
  - https://www.yandex.com/support/metrica/en/data/visit-params-data.md
  - https://www.yandex.com/support/metrica/es/data/visit-params-data.md
  - https://www.yandex.com/support/metrica/pt/data/visit-params-data.md
  - https://www.yandex.com/support/metrica/ru/data/visit-params-data.md
  - https://www.yandex.com/support/metrica/tr/data/visit-params-data.md
  - https://www.yandex.com/support/metrica/zh/data/visit-params-data.md
  - href: zh/data/visit-params-data.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/support/metrica/zh/llms.txt

# 传输事件

<!-- source: zh/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->
{% note warning %}

使用 JavaScript API 需要了解 HTML 和 JavaScript。 如果您不了解这些语言，请联系您的网站开发人员或站长。

{% endnote %}
<!-- endsource: zh/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->


大多数会话数据由 Yandex Metrica 计数器[自动收集](https://www.yandex.com/support/metrica/zh/general/how-it-works.md#data_extract_pull)。 但是，您可能会发现用您自己的数据补充此数据会对您有利。 例如，您可能对购买了哪些特定商品或登录的用户执行了哪些操作的统计数据感兴趣。

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

使用 JavaScript API 将会话参数传输到计数器存储。 数据可以在计数器初始化期间发送，也可以[会话超时](https://www.yandex.com/support/metrica/zh/general/counter-general.md#time-out)过期之前的任何时间发送。

在计数器初始化期间，会话参数在 [params](https://www.yandex.com/support/metrica/zh/code/counter-initialize.md#param-params) 参数中指定。

要在用户于您网站上的会话期间传递事件参数，请使用 [params](https://www.yandex.com/support/metrica/zh/objects/params-method.md) 方法，或者使用 [extLink](https://www.yandex.com/support/metrica/zh/objects/extlink.md)、[file](https://www.yandex.com/support/metrica/zh/objects/file.md)、[hit](https://www.yandex.com/support/metrica/zh/objects/hit.md)、[reachGoal](https://www.yandex.com/support/metrica/zh/objects/reachgoal.md) 方法的可选参数。

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

## 传输和处理数据 {#proc}

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

发送至 Yandex Metrica 的数据请求所含内容不得超过 8 KB（8,192 个字符）。 当您[发送分层结构化数据](https://www.yandex.com/support/metrica/zh/data/visit-params-example.md#level)时，Yandex Metrica 报表最多会显示 10 层嵌套层级。 如果在单个会话中，一个参数以不同的值传输，则 Yandex Metrica 将显示所有值。 需要注意的是，单一会话中最多可发送 512 个参数。

[数据传输限制](https://www.yandex.com/support/metrica/zh/general/limits.md)

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

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

传输数据示例：

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

其中：

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

有关更多示例，请参见[会话参数发送示例](https://www.yandex.com/support/metrica/zh/data/visit-params-example.md)部分。

## 按参数生成的报表 {#param}

事件作为[维度](*группировки)或[目标](https://www.yandex.com/support/metrica/zh/general/glossary.md#goal)传输至 Yandex Metrica。 通过处理数据计算出的数字是[指标](*метриками)。

要查看已传输事件的统计数据，请使用[“Event parameters”报表](https://www.yandex.com/support/metrica/zh/reports/event-params.md)或[“Session parameters”报表](https://www.yandex.com/support/metrica/zh/reports/visit-params.md)。 您还可以使用参数作为在其他 Yandex Metrica 报表中[创建细分](https://www.yandex.com/support/metrica/zh/general/segmentation.md)的条件。

{% note info %}

如果您使用 [reachGoal](https://www.yandex.com/support/metrica/zh/objects/reachgoal.md) 方法传递参数，但尚未为计数器创建 JavaScript 目标，或仅将其作为多步骤目标的一部分创建，则数据将不会显示在“Event parameters”报表中。

在计数器界面中创建单独的 JavaScript 目标，或使用其他方法传输参数：[params](https://www.yandex.com/support/metrica/zh/objects/params-method.md)、[extLink](https://www.yandex.com/support/metrica/zh/objects/extlink.md)、[file](https://www.yandex.com/support/metrica/zh/objects/file.md) 或 [hit](https://www.yandex.com/support/metrica/zh/objects/hit.md)。

{% endnote %}

<!-- source: zh/_includes/buttons/chat-button.md -->
[与我们聊天](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: zh/_includes/styles/href-to-button.md -->

<!-- endsource: zh/_includes/styles/href-to-button.md -->
<!-- endsource: zh/_includes/buttons/chat-button.md -->

<!-- source: zh/_includes/data/support-button-1.md -->
<div class="cut-button">

{% cut "发送电子邮件" %}

<!-- source: zh/_includes/popup/id-popup/wrong-sup.md -->
请注意：我们的支持团队永远不会主动给您打电话。 请勿按照自称为 Yandex Metrica 支持团队来电者的指示操作。
<!-- endsource: zh/_includes/popup/id-popup/wrong-sup.md -->

如果您需要调整目标，使其继续记录页面浏览以外的事件，请在表单中描述情况。

  <div style="padding: 15px;
       margin: 10px 0;
       background: #FFFFFF;
       border-radius: 10px;
       border: 1px solid var(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
          height="700"
          width="100%"
          frameborder="0"
          src="https://forms.yandex.com/surveys/10011834/?&iframe=1&lang=en">
    </iframe>
  </div> 

{% endcut %}

</div>

<!-- source: zh/_includes/styles/cut-button.md -->

<!-- endsource: zh/_includes/styles/cut-button.md -->
<!-- endsource: zh/_includes/data/support-button-1.md -->


[联系我们](https://yandex-ad.cn/contact){.button}


<!-- source: zh/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
实用链接

- [演示计数器](https://metrica.yandex.com/r/dashboard?)
- [添加计数器](https://metrica.yandex.com/add/)
- [免费计数器设置](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API](https://tech.yandex.com/metrika/)
- [提出您的想法](https://yandex.com/support/metrica/troubleshooting/idea.html)
|
线上培训



- [参加培训课程](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: zh/_includes/styles/table-style.md -->

<!-- endsource: zh/_includes/styles/table-style.md -->
<!-- endsource: zh/_includes/footer-links.md -->

<!-- source: zh/_includes/styles/href-to-button.md -->

<!-- endsource: zh/_includes/styles/href-to-button.md -->

<!-- source: zh/_includes/styles/cut-button.md -->

<!-- endsource: zh/_includes/styles/cut-button.md -->

[*группировки]: 表示由计数器统计的用户活动的属性（例如，会话、页面浏览、推荐、文件下载等）。 报表中发送的数据按属性分组。

[*метриками]: 基于会话或页面浏览属性的数值。 该数值可以是总数或平均值。 例如，页面浏览计算为值的总和，而会话深度为平均值。