---
metadata:
- name: generator
content: Diplodoc Platform v5.54.1
alternate:
- https://yandex.com/support/metrica/en/data/user-params-data.md
- https://yandex.com/support/metrica/es/data/user-params-data.md
- https://yandex.com/support/metrica/pt/data/user-params-data.md
- https://yandex.com/support/metrica/ru/data/user-params-data.md
- https://yandex.com/support/metrica/tr/data/user-params-data.md
- https://yandex.com/support/metrica/zh/data/user-params-data.md
- href: es/data/user-params-data.md
type: text/markdown
title: Markdown version
- href: ../llms.txt
type: text/markdown
title: llms.txt
title: Transmisión de parámetros de usuario
description: "Yandex\_Metrica le permite enviar cualquier dato personalizado, denominado parámetros de usuario. Para los parámetros de usuario, recomendamos transmitir características del usuario que no cambien de sesión a sesión y que no contengan datos personales como el nombre del usuario."
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/es/llms.txt
# Transmisión de parámetros de usuario
{% note warning %}
Para trabajar con la API de JavaScript se requieren conocimientos de HTML y JavaScript. Si no conoce estos idiomas, contacte a su desarrollador web o webmaster.
{% endnote %}
La mayoría de los datos de la sesión se recopilan automáticamente por la etiqueta de Yandex Metrica. Para complementarlos con sus propios datos, transmita los [parámetros de sesión](https://yandex.com/support/metrica/es/data/visit-params-data.md). Sin embargo, quizás descubra que la información sobre los propios usuarios es más útil que las estadísticas de la sesión.
Yandex Metrica le permite enviar cualquier dato personalizado, denominado _parámetros de usuario_. Para los parámetros de usuario, recomendamos transmitir características del usuario que no cambien de sesión a sesión y que no contengan datos personales como el nombre del usuario. [Diferencia entre parámetros de usuario y parámetros de sesión](https://yandex.com/support/metrica/es/general/how-it-works.md#difference)
Si desea que los parámetros que pasó se reflejen en los informes, Yandex Metrica debe vincularlos a los usuarios del sitio web. Para hacer esto, se utilizan los siguientes IDs especiales: [ClientID](*ClientID) e [UserID](*UserID). Los parámetros están vinculados a sesiones para usuarios que visitaron el sitio web dentro de los 90 días antes de que los datos fueran enviados a Yandex Metrica.
{% note info %}
Al transmitir parámetros de usuario especificando el ClientID e UserID, el número total de usuarios en los informes de Yandex Metrica puede diferir del número de IDs pasados debido a la forma en que el UserID está vinculado al ClientID.
{% endnote %}
Los informes se actualizarán con la nueva información dentro de unas pocas horas. Para ver estadísticas, use el [informe Parámetros de usuario](https://yandex.com/support/metrica/es/reports/user-params.md).
{% note info %}
Los parámetros enviados a Yandex Metrica se almacenan durante dos años desde la última carga. Cuando finaliza el período de almacenamiento, el informe ya no mostrará los datos.
{% endnote %}
{% cut "Cuándo debe transmitirse el ClientID" %}
Recomendamos usar el [ClientID](*ClientID) en los datos transmitidos si no necesita obtener sus propios IDs en un informe.
{% endcut %}
{% cut "Cuándo debe transmitirse el UserID" %}
Recomendamos usar el [UserID](*UserID) si, por ejemplo, su sitio ya tiene un sistema de ID de usuarios y necesita obtener un informe que las incluya.
{% endcut %}
Puede enviar parámetros de usuario a Yandex Metrica de varias maneras:
- [Durante una sesión del sitio](#online).
- Use un [archivo CSV en cualquier momento](#offline).
## Transmisión de datos durante una sesión del sitio {#online}
Este método es útil cuando se genera un informe a partir de los datos recibidos mientras el usuario está visualizando el sitio.
Los parámetros de usuario se transmiten a Yandex Metrica a través de la API de JavaScript. La información enviada usando este método no se puede eliminar de Yandex Metrica.
Para transmitir los parámetros en cualquier otro momento, utilice el método [userParams](https://yandex.com/support/metrica/es/objects/user-params.md). Para transmitir parámetros durante la inicialización de la etiqueta, especifique datos en el parámetro [userParams](https://yandex.com/support/metrica/es/code/counter-initialize.md). La información es transmitida como objeto de JavaScript.
El valor del campo se procesa de la siguiente manera, según el tipo:
-
**objeto** — Crea una nueva rama del árbol para cada clave del objeto e invoca el algoritmo recursivamente para cada valor.
-
**string** — cuenta la cantidad de veces que aparece cada valor diferente de la cadena.
-
**number** — calcula el valor total y promedio de todos los números.
-
**true**, **false** o **null** — calcula la cantidad de veces que aparece cada valor.
Los datos se vincularán al [ClientID](*ClientID) solo si el método `userParams` fue llamado durante la sesión del usuario. Para obtener estadísticas más completas, espere hasta que se haya transmitido un mayor volumen de datos a Yandex Metrica.
> ## Ejemplo
>
> Veamos una tienda en línea que tiene dos tipos de clientes: “normal” y “VIP”. Los datos de estado del cliente se almacenan en la base de datos propia del sitio. Después de que los usuarios inician sesión en el sitio, ven sus nombres de usuario en lugar del enlace **Iniciar sesión** en cada página. Si un usuario tiene un estado especial, se muestra junto a su nombre: **Jane/VIP**. Junto con el estado, también puede transmitir el ID de usuario que está almacenado en su base de datos.
>
> Para enviar datos a Yandex Metrica, agregue código a todas las páginas del sitio que llamarán al método `userParams`.
>
> Para enviar datos sobre usuarios con estado especial, el código tendrá un aspecto similar al siguiente:
>
>
> {% list tabs %}
>
> - En cualquier momento
>
>
> ```javascript
> ym(XXXXXXXX, 'userParams', {
> vip_status: true,
> child: 1,
> child_age: 13,
> UserID: 12345
> });
> ```
>
>
> - Al inicializar una etiqueta
>
>
> ```javascript
> ym(XXXXXXXX, 'init', {
> clickmap: true,
> webvisor: true,
> userParams: {
> vip_status: true,
> child: 1,
> child_age: 13,
> UserID: 12345
> }
> });
> ```
>
> {% endlist %}
>
>
> Si se está transmitiendo información sobre un usuario “normal”, el código se verá así:
>
> {% list tabs %}
>
> - En cualquier momento
>
>
> ```javascript
> ym(XXXXXXXX, 'userParams', {
> vip_status: false,
> child: 1,
> child_age: 13,
> UserID: 12345
> });
> ```
>
>
> - Al inicializar una etiqueta
>
>
> ```javascript
> ym(XXXXXXXX, 'init', {
> clickmap: true,
> webvisor: true,
> userParams: {
> vip_status: false,
> child: 1,
> child_age: 13,
> UserID: 12345
> }
> });
> ```
>
> {% endlist %}
>
> donde `XXXXXXXX` es su número de etiqueta.
>
> Si un cliente “normal” obtiene estado VIP, el método `userParams` envía los datos nuevos a Yandex Metrica la siguiente vez que ese usuario inicia sesión en el sitio. Este nuevo estado se aplicará a todo el historial de sesiones de este usuario, como si el cliente siempre hubiera sido VIP.
## Transmisión de datos en un archivo CSV en cualquier momento {#offline}
Con este método, Yandex Metrica recibe los datos recopilados tanto durante la sesión del sitio como después de que el usuario haya dejado el sitio.
[Especificación para el formato del archivo .csv](http://www.rfc-editor.org/rfc/rfc4180.txt)
[Descripción del formato CSV](https://en.wikipedia.org/wiki/Comma-separated_values)
#|
## Обязательные поля для передачи данных {#offline}
||
**Nombre del campo**
|
**Descripción**
|
**Ejemplo**
||
||
`ClientID` \| `UserID`
|
ID del usuario del sitio
|
P12345
||
||
`key`
|
ID de usuario. Máximo de 1000 por usuario
|
edad \| cliente.edad
||
||
`valor`
|
Valor de la ID del usuario
|
40
||
|#
Para enviar una estructura jerárquica de parámetros, use el símbolo “.” (punto). Por ejemplo, para transmitir múltiples valores del campo `key`, especifique `cliente.demografía.edad`.
El número máximo de caracteres en los campos mostrados en los informes de Yandex Metrica:
- `key`: 255;
- `valor`: 50.
Para pasar información con un parámetro:
{% list tabs %}
- ClientID
1. Obtenga el ClientID usando el método [getClientID](https://yandex.com/support/metrica/es/objects/get-client-id.md).
1. Genere un archivo CSV especificando el ClientID y envíelo en la interfaz de Yandex Metrica.
- UserID
1. Envíe su UserID usando el método [setUserID](https://yandex.com/support/metrica/es/objects/set-user-id.md).
1. Genere un archivo CSV especificando el UserID y envíelo en la interfaz de Yandex Metrica.
{% endlist %}
### Cómo trabajar con un archivo {#data-send}
La interfaz de Yandex Metrica le permite cargar datos y eliminarlos. Puedes gestionar el archivo en **Configuraciones** (encuentre la pestaña **Cargar datos** y elija **Parámetros de usuario**).
{% list tabs %}
- Cómo cargar datos
Para enviar un archivo CSV generado a Yandex Metrica:
1. Haga clic en **Cargar datos**.
1. En la ventana que aparece, seleccione el tipo de archivo dependiendo del tipo de ID que desea cargar ([UserID](*UserID) o [ClientID](*ClientID)).
1. Seleccione el archivo en su equipo y agregue comentarios para la carga, si lo considera necesario.
1. Haga clic en **Cargar datos**.
[Archivo CSV de muestra para cargar datos](https://download.cdn.yandex.net/from/yandex.com/support/en/metrica/files/upload-data-example.csv)
- Cómo eliminar datos
Para eliminar datos o partes de datos cargados previamente del servicio, prepare un archivo CSV. El archivo solo debe contener el campo `key` para los datos que desea eliminar. A continuación, siga estos pasos:
1. Haga clic en **Eliminar datos**.
2. En la ventana que aparece, seleccione el tipo de archivo al que desea aplicar cambios, dependiendo del ID ([UserID](*Идентификатор-посетителя-сайта,-заданный-владельцем-сайта,-например-при-входе-посетителя-сайта-в-личный-кабинет.) o [ClientID](*Идентификатор-уникального-посетителя-сайта,-который-Яндекс-Метрика-задает-автоматически.)).
3.
Seleccione el archivo en su equipo y agregue comentarios para la carga, si lo considera necesario.
4.
Haga clic en **Cargar datos**.
[Archivo CSV de muestra para eliminar datos](https://download.cdn.yandex.net/from/yandex.com/support/en/metrica/files/delete-data-example.csv)
{% endlist %}
El servicio tarda un tiempo en procesar el archivo. Una vez completado el procesamiento, la información que envió estará disponible en el informe de Parámetros de usuario.
[Chatee con nosotros](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
Enlaces útiles
- [Etiqueta de demostración](https://metrica.yandex.com/r/dashboard?)
- [Agregar una etiqueta](https://metrica.yandex.com/add/)
- [Configuración gratuita de etiquetas](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/)
- [Sugiera su idea](https://yandex.com/support/metrica/troubleshooting/idea.html)
- [Discutir en Telegram](https://t.me/yandexmetrika)
|
Capacitación en línea
- [Obtener un certificado de Yandex Metrica](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
- [Tomar un curso de capacitación](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
||
|#
[*ClientID]: Identificador único de sesión del sitio web creado automáticamente por Yandex Metrica.
[*UserID]: ID de usuario establecido por el propietario del sitio (por ejemplo, cuando el usuario del sitio inicia sesión en su cuenta personal).
[*Идентификатор-посетителя-сайта,-заданный-владельцем-сайта,-например-при-входе-посетителя-сайта-в-личный-кабинет]: ID de usuario establecido por el propietario del sitio (por ejemplo, cuando el usuario del sitio inicia sesión en su cuenta personal).
[*Идентификатор-уникального-посетителя-сайта,-который-Яндекс-Метрика-задает-автоматически]: Identificador único de sesión del sitio web creado automáticamente por Yandex Metrica.