---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.2
alternate:
  - https://yandex.com/support/metrica/en/objects/clickmap.md
  - https://yandex.com/support/metrica/es/objects/clickmap.md
  - https://yandex.com/support/metrica/pt/objects/clickmap.md
  - https://yandex.com/support/metrica/ru/objects/clickmap.md
  - https://yandex.com/support/metrica/tr/objects/clickmap.md
  - https://yandex.com/support/metrica/zh/objects/clickmap.md
  - href: zh/objects/clickmap.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://yandex.com/support/metrica/zh/llms.txt

# clickmap


{% note alert %}

过时方法。 向后兼容支持该方法，但可能随时弃用。 我们强烈不建议使用该方法。

要管理点击数据的收集，请在计数器初始化期间使用 [clickmap](https://yandex.com/support/metrica/zh/code/counter-initialize.md#param-clickmap) 参数。

{% endnote %}


管理生成 [click map](https://yandex.com/support/metrica/zh/behavior/click-map.md) 的信息的收集。

```javascript
ym(XXXXXXXX, 'clickmap', properties);
```


#|
||
**参数**
|
**默认值**
|
**类型**
|
**描述**
||
||
`特性`[*](*Параметр)
|
—
|
布尔值 | Object
|
默认情况下，收集有关页面上所有点击的信息。

您可以通过将参数设置为 `false` 来禁用点击跟踪。
```javascript ym(XXXXXXXX, ’clickmap’, false); ```
指定的点击跟踪参数（“Object”类型）会被记住。 因此，如果点击跟踪已被禁用，调用 `clickmap(true)` 将使用之前指定的参数重新开始跟踪点击。
||
||
`properties` 对象的字段
||
||
`properties.filter`
|
—
|
Function
|
针对特定 DOM 元素的点击筛选
||
||
`properties.ignoreTags`
|
—
|
String[]
|
不对其跟踪点击的 HTML 标签列表
||
||
`properties.quota`
|
—
|
数字
|
跟踪的最大页面点击次数
||
|#

<sup >*</sup>必填参数。

> # 示例
> 
> ```javascript
> ym(XXXXXXXX, 'init', {});
> ym(XXXXXXXX, 'clickmap', {
>     mode: 'default',
>     quota: 1,
>     delay: 10,
>     ingoreTags: ['input', 'textarea'],
>     filter: function(domElement) {
>         if (
>                domElement.className == 'menu-item'
>                ||
>                domElement.id == 'footer'
>            ) {
>             return false; // Ignore click
>         }
>         return true;
>     }
> });
> ```
> 
> 您还可以使用 [ym-disable-clickmap](https://yandex.com/support/metrica/zh/code/html-markup.md#class-ym-disable-clickmap) 类禁用点击跟踪。

<!-- 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/buttons/support-button.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/1706/?&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/buttons/support-button.md -->


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


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

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

[*Параметр]: <sup >*</sup>必填参数。