---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.1
alternate:
  - https://yandex.com/support/metrica/en/objects/user-params.md
  - https://yandex.com/support/metrica/es/objects/user-params.md
  - https://yandex.com/support/metrica/pt/objects/user-params.md
  - https://yandex.com/support/metrica/ru/objects/user-params.md
  - https://yandex.com/support/metrica/tr/objects/user-params.md
  - https://yandex.com/support/metrica/zh/objects/user-params.md
  - href: zh/objects/user-params.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: userParams
description: 传输网站用户的自定义参数。
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/zh/llms.txt


# userParams

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


传输网站用户的自定义参数。

```javascript
ym(XXXXXXXX, 'userParams', parameters);
```


#|
||
**参数**
|
**默认值**
|
**类型**
|
**描述**
||
||
`参数`[*](*parametr)
|
—
|
Object
|
[用户参数](https://yandex.com/support/metrica/zh/data/user-params-data.md)。
```javascript 
ym(XXXXXXXX, 'userParams', {
    status: "Gold",
    child: 1,
    child_age: 13,
    UserID: 12345 
}); 
```
||
|#


要传输您自己的用户 ID，请使用 `UserID` 参数。 您可以为其他用户参数选择任何名称。

单个会话最多可发送 512 个参数。 当您[发送分层结构化数据](https://yandex.com/support/metrica/zh/data/user-params-example.md#example4)时，Yandex Metrica 报表最多会显示 10 层嵌套层级。

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

`userParams` 方法中传递的信息将出现在报表中几个小时。

Yandex Metrica 报表中显示的最大字符数：
- 在字段中 —— 255。
- 在值中 —— 50。

<!-- 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/reports/support-button.md -->
[联系我们](https://yandex-ad.cn/contact){.button}


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

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

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

<!-- endsource: zh/_includes/styles/href-to-button.md -->
<!-- endsource: zh/_includes/reports/support-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 -->

[*parametr]: 必填参数。