---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/support/metrica/en/code/counter-initialize.md
  - https://yandex.ru/support/metrica/es/code/counter-initialize.md
  - https://yandex.ru/support/metrica/pt/code/counter-initialize.md
  - https://yandex.ru/support/metrica/ru/code/counter-initialize.md
  - https://yandex.ru/support/metrica/tr/code/counter-initialize.md
  - https://yandex.ru/support/metrica/zh/code/counter-initialize.md
title: 计数器初始化
description: 如何初始化计数器和初始化参数，以及如何使用计数器管理系统启用计数器。
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/metrica/zh/llms.txt


# 计数器初始化


{% note tip %}

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

{% endnote %}


前往 `https://mc.yandex.ru/metrika/tag.js` 并下载计数器工作所需的 JavaScript 库。

启用该库的代码可在计数器编辑页面上找到。 该库可以异步（推荐）或同步加载，但其功能保持不变。

要创建和管理计数器，请使用 `ym` 方法。 它是在下载代码中创建的：
```javascript
(function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)};
m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)})
(window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym");
```

`ym` 需要计数器 ID 和正在调用的函数的名称。 该方法还可以传递被调用函数的参数。 例如，要初始化一个计数器，您需要传递计数器 ID、`init` 函数的名称和参数数组：

```javascript
ym(XXXXXXXX, "init", {clickmap: true, webvisor: true});
```

如果您不想将参数传递给函数，初始化如下所示：

```javascript
ym(XXXXXXXX, "init", {});
```

包含主要初始化参数的代码部分是在 **Settings** 页面上生成的。 初始化参数的完整列表如表所示。

可以通过 `ym` 方法调用的函数说明参见[方法参考](https://yandex.ru/support/metrica/zh/objects/method-reference.md)。

## 计数器初始化参数

#|

||
**名称**
|
**默认值**
|
**类型**
|
**描述**
||
||
`accurateTrackBounce`
|
`true`
|
布尔 \| 数字
|
准确的跳出率 参数可以接受这些值：

- `true` — 启用准确的跳出率，并在 15000 毫秒（15 秒）后统计非跳出事件。
- `false` — 不启用准确的跳出率。
- `<N>`（整数）— 启用准确的跳出率。 非跳出事件在 `<N> ms` 之后确定。
||
||
`childIframe`
|
`false`
|
布尔值
|
是否在子窗口中[记录 iframe 内容](https://yandex.ru/support/metrica/zh/webvisor/iframe-support.md)，不带计数器。
||
||
`clickmap`
|
`true`
|
布尔值
|
是否针对 click map 收集数据。
||
||
`defer`
|
`false`
|
布尔值
|
是否禁止在计数器初始化期间自动发送数据。
||
||
`ecommerce`
|
`false`
|
布尔 \| 字符串 \| 数组
|
[E-commerce](https://yandex.ru/support/metrica/zh/ecommerce/about.md) 数据收集。

- `true` — 启用 e-commerce 数据收集。 相当于 `dataLayer` 值（如果选项[在 Yandex Metrica 中启用](https://yandex.ru/support/metrica/zh/data/e-commerce.md#3)）。 数据通过全局命名空间中 (`window.dataLayer`) 名为 `dataLayer` 的 JavaScript 数组传输。
- `false` — 禁用 E-commerce 数据收集。
- `<objectName>`（字符串）— 启用 e-commerce 数据收集。 数据通过全局命名空间中 (`window.<objectName>`) 名为 `<objectName>` 的 JavaScript 数组传输。
- `<array>`（数组）— 启用 e-commerce 数据收集。 数据通过 JavaScript `<array>` 传输。
||
||
`params`
|
—
|
对象 \| 数组
|
计数器初始化期间传输的会话参数。

要在任何其他时间传输会话参数，请使用 [params](https://yandex.ru/support/metrica/zh/objects/params-method.md) 方法。
||
||
`userParams`
|
—
|
Object
|
初始化计数器时传输的网站用户参数。

要在任何其他时间传输用户参数，请使用 [userParams](https://yandex.ru/support/metrica/zh/objects/user-params.md) 方法。
||
||
`trackHash`
|
`false`
|
布尔值
|
跟踪浏览器地址栏中的散列值变化。
||
||
`trackLinks`
|
`true`
|
布尔值
|
跟踪出站链接的点击量。
||
||
`trustedDomains`
|
—
|
数组
|
表示用于[记录子 iframe 的内容](https://yandex.ru/support/metrica/zh/webvisor/iframe-support.md)的受信任域。包含父窗口的域地址。
||
||
`type`
|
`0`
|
数字
|
计数器类型。 1 代表 YAN。
||
||
`webvisor`
|
`false`
|
布尔值
|
是否使用 Session Replay。
||
||
`triggerEvent`
|
`false`
|
布尔值
|
是否检查计数器是否准备好。
||
||
`sendTitle`
|
`true`
|
布尔值
|
标题记录。 如果标题包含私有数据，则该参数应在初始化期间设置为 `false`：`sendTitle: false`。
||
||
`ssr`
|
`true`
|
布尔值
|
用于嵌入代码的技术参数。
||
|#

## 检查计数器初始化 {#check-initialize}

您可以使用特殊的 JavaScript 事件来查明计数器是否已准备好运行。 但是，您必须在代码片段中添加设置为 `true` 的 `triggerEvent` 参数：
```
ym(XXXXXXXX, "init", {triggerEvent: true});
```
 对于 jQuery，您可以在计数器初始化之前使用以下代码示例

```xml
jQuery(document).on('yacounterXXXXXXinited', function () {
    console.log('tag yaCounterXXXXXXXX ready');
});
```




<!-- 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/support-2.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(--yc-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/10011833/?&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/support-2.md -->

<!-- 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 -->