---
metadata:
- name: generator
content: Diplodoc Platform v5.52.0
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: pt/data/user-params-data.md
type: text/markdown
title: Markdown version
- href: ../llms.txt
type: text/markdown
title: llms.txt
title: Transmissão de parâmetros de usuário
description: "O Yandex\_Metrica permite que você envie dados personalizados, referidos como parâmetros de usuário. Para parâmetros de usuário, recomendamos a transmissão de características do usuário que não mudem de sessão para sessão e que não contenham dados pessoais, como o nome do usuário."
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/pt/llms.txt
# Transmissão de parâmetros de usuário
{% note warning %}
Trabalhar com a API JavaScript exige conhecimentos de HTML e JavaScript. Se você não conhece essas linguagens, entre em contato com o desenvolvedor ou webmaster do seu site.
{% endnote %}
A maior parte dos dados de sessão é coletada automaticamente pela tag Yandex Metrica. Você pode complementá-los com dados próprios, transmitindo para isso [parâmetros de sessão](https://yandex.com/support/metrica/pt/data/visit-params-data.md). No entanto, você talvez ache que as informações sobre os usuários em si são mais úteis que as estatísticas de sessão.
O Yandex Metrica permite que você envie dados personalizados, referidos como _parâmetros de usuário_. Para parâmetros de usuário, recomendamos a transmissão de características do usuário que não mudem de sessão para sessão e que não contenham dados pessoais, como o nome do usuário. [Diferença entre parâmetros de usuário e parâmetros de sessão](https://yandex.com/support/metrica/pt/general/how-it-works.md#difference)
Caso queira que os parâmetros que você informou se reflitam nos relatórios, o Yandex Metrica deve vinculá-los aos usuários. Para isso, são usadas as seguintes IDs especiais: [ClientID](*ClientID) e [UserID](*UserID). Os parâmetros são vinculados às sessões dos usuários que tiverem visitado o site nos 90 dias que precederam o envio dos dados para o Yandex Metrica.
{% note info %}
Quando você transmite parâmetros de usuário especificando a UserID e a UserID, o número total de usuários nos relatórios do Yandex Metrica pode divergir do número de IDs informadas, devido à forma como a UserID é vinculada à ClientID.
{% endnote %}
Os relatórios serão atualizados com as novas informações dentro de algumas horas. Para visualizar estatísticas, use o [relatório Parâmetros de usuário](https://yandex.com/support/metrica/pt/reports/user-params.md).
{% note info %}
Os parâmetros enviados para o Yandex Metrica são armazenados por dois anos, contados a partir do último upload. Ao fim do período de armazenamento, o relatório deixa de exibir os dados.
{% endnote %}
{% cut "Quando transmitir a ClientID" %}
Recomendamos usar a [ClientID](*ClientID) nos dados transmitidos caso não precise obter suas próprias IDs no relatório.
{% endcut %}
{% cut "Quando transmitir a UserID" %}
Recomendamos usar a [UserID](*UserID) se, por exemplo, seu site já tiver um sistema de ID de usuários e você precise obter um relatório que utilize essas IDs.
{% endcut %}
Há várias maneiras possíveis de enviar parâmetros de usuário para o Yandex Metrica:
- [Durante uma sessão no site](#online).
- Usando um [arquivo CSV, a qualquer momento](#offline).
## Informar dados durante uma sessão no site {#online}
Este método é útil quando o relatório está sendo gerado com base em dados recebidos enquanto o usuário está visualizando o site.
Os parâmetros de usuário são transmitidos para o Yandex Metrica através da API JavaScript. As informações enviadas usando esse método não podem ser deletadas do Yandex Metrica.
Para transmitir os parâmetros em qualquer outro momento, use o método [userParams](https://yandex.com/support/metrica/pt/objects/user-params.md). Para transmitir parâmetros durante a inicialização da tag, especifique dados no parâmetro [userParams](https://yandex.com/support/metrica/pt/code/counter-initialize.md). As informações são transmitidas como objetos JavaScript.
O valor do campo é processado da seguinte forma, a depender do seu tipo:
-
**objeto** — Cria um novo ramo de árvore para cada chave de objeto e invoca o algoritmo recursivamente para cada valor.
-
**string** — Conta o número de vezes que cada valor da string ocorre.
-
**número** — Calcula o valor total e o médio de todos os números.
-
**true**, **false** ou **null** — Calcula o número de vezes que cada valor ocorre.
Os dados só serão vinculados à [ClientID](*ClientID) se o método `userParams` tiver sido convocado durante a sessão do usuário. Para obter estatísticas mais completas, aguarde até que um volume maior de dados tenha sido transmitido para o Yandex Metrica.
> ## Exemplo
>
> Vamos considerar uma loja online que possui dois tipos de clientes: “normais” e “VIP”. Os dados de status dos clientes estão armazenados no banco de dados do próprio site. Após logarem no site, os usuários passam a ver seus nomes de usuário em todas as páginas ao invés do link **Fazer login**. Se o usuário tiver status especial, isto será mostrado ao lado do nome: **Maria/VIP**. Junto com o status, você também pode transmitir a ID de usuário que está armazenada no seu banco de dados.
>
> Para enviar dados para o Yandex Metrica, adicione código a todas as páginas do site que irão convocar o método `userParams`.
>
> Para enviar dados sobre usuários com status especial, o código ficará assim:
>
>
> {% list tabs %}
>
> - A qualquer momento
>
>
> ```javascript
> ym(XXXXXXXX, 'userParams', {
> vip_status: true,
> child: 1,
> child_age: 13,
> UserID: 12345
> });
> ```
>
>
> - Ao inicializar uma tag
>
>
> ```javascript
> ym(XXXXXXXX, 'init', {
> clickmap: true,
> webvisor: true,
> userParams: {
> vip_status: true,
> child: 1,
> child_age: 13,
> UserID: 12345
> }
> });
> ```
>
> {% endlist %}
>
>
> Se informações sobre um usuário "normal" estiverem sendo transmitidas, o código ficará assim:
>
> {% list tabs %}
>
> - A qualquer momento
>
>
> ```javascript
> ym(XXXXXXXX, 'userParams', {
> vip_status: false,
> child: 1,
> child_age: 13,
> UserID: 12345
> });
> ```
>
>
> - Ao inicializar uma tag
>
>
> ```javascript
> ym(XXXXXXXX, 'init', {
> clickmap: true,
> webvisor: true,
> userParams: {
> vip_status: false,
> child: 1,
> child_age: 13,
> UserID: 12345
> }
> });
> ```
>
> {% endlist %}
>
> onde `XXXXXXXX` é o número do seu contador.
>
> Se um cliente "normal" receber status VIP, o método `userParams` enviará os novos dados para o Yandex Metrica da próxima vez que esse usuário logar no site. Esse novo status se aplicará a todo o histórico de sessões desse usuário, como se o cliente sempre tivesse sido VIP.
## Transmissão de dados por arquivo CSV, a qualquer momento {#offline}
Com este método, o Yandex Metrica recebe os dados coletados tanto durante a sessão no site quanto após o usuário sair do site.
[Especificação para o formato CSV](http://www.rfc-editor.org/rfc/rfc4180.txt)
[Descrição do formato CSV](https://en.wikipedia.org/wiki/Comma-separated_values)
#|
## Обязательные поля для передачи данных {#offline}
||
**Nome do campo**
|
**Descrição**
|
**Exemplo**
||
||
`ClientID` \| `UserID`
|
ID do usuário do site
|
P12345
||
||
`chave`
|
ID de usuário. No máximo, 1.000 por usuário
|
idade \| client.age
||
||
`valor`
|
Valor da ID de usuário
|
40
||
|#
Para enviar uma estrutura hierárquica de parâmetros, use o símbolo "." (ponto). Por exemplo, para transmitir diversos valores do campo `key`, especifique `cliente.demografia.idade`.
Número máximo de caracteres nos campos mostrados nos relatórios do Yandex Metrica:
- `chave` — 255;
- `valor` — 50.
Para passar informações com um parâmetro:
{% list tabs %}
- ClientID
1. Obtenha a ClientID usando o método [getClientID](https://yandex.com/support/metrica/pt/objects/get-client-id.md).
1. Gere um arquivo CSV especificando a ClientID e envie na interface do Yandex Metrica.
- UserID
1. Envie sua UserID usando o método [setUserID](https://yandex.com/support/metrica/pt/objects/set-user-id.md).
1. Gere um arquivo CSV especificando a UserID e envie na interface do Yandex Metrica.
{% endlist %}
### Trabalhando com um arquivo {#data-send}
A interface do Yandex Metrica permite fazer o upload de dados ou deletá-los. Você pode gerenciar o arquivo em **Configurações** (encontre a aba **Fazer upload de dados** e escolha **Parâmetros de usuário**).
{% list tabs %}
- Upload de dados
Para enviar ao Yandex Metrica um arquivo CSV gerado:
1. Clique em **Fazer upload de dados**.
1. Na janela que aparece, selecione o tipo de arquivo, conforme o tipo de ID que você deseje transmitir ([UserID](*UserID) ou [ClientID](*ClientID)).
1. Selecione o arquivo no seu computador e, se necessário, adicione comentários ao upload.
1. Clique em **Fazer upload de dados**.
[Exemplo de arquivo CSV para upload de dados](https://download.cdn.yandex.net/from/yandex.com/support/en/metrica/files/upload-data-example.csv)
- Deleção de dados
Para remover do serviço dados carregados anteriormente, ou partes deles, prepare um arquivo CSV. O arquivo deve conter apenas o campo `key` com os dados que você deseja remover. Em seguida, siga estas etapas:
1. Clique em **Deletar dados**.
2. Na janela que aparece, selecione o tipo de arquivo ao qual você deseja aplicar as alterações, conforme a ID ([UserID](*Идентификатор-посетителя-сайта,-заданный-владельцем-сайта,-например-при-входе-посетителя-сайта-в-личный-кабинет.) ou [ClientID](*Идентификатор-уникального-посетителя-сайта,-который-Яндекс-Метрика-задает-автоматически.)).
3.
Selecione o arquivo no seu computador e, se necessário, adicione comentários ao upload.
4.
Clique em **Fazer upload de dados**.
[Exemplo de arquivo CSV para deleção de dados](https://download.cdn.yandex.net/from/yandex.com/support/en/metrica/files/delete-data-example.csv)
{% endlist %}
Leva algum tempo para o serviço processar o arquivo. Encerrado o processamento, as informações enviadas estarão disponíveis no relatório Parâmetros de usuário.
[Fale conosco](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
Links úteis
- [Tag de demonstração](https://metrica.yandex.com/r/dashboard?)
- [Adicionar uma tag](https://metrica.yandex.com/add/)
- [Configuração gratuita de tag](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [API do Yandex Metrica](https://tech.yandex.com/metrika/)
- [Sugerir uma idea](https://yandex.com/support/metrica/troubleshooting/idea.html)
- [Debater no Telegram](https://t.me/yandexmetrika)
|
Treinamento online
- [Obter um certificado do Yandex Metrica](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
- [Fazer um curso](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
||
|#
[*ClientID]: ID exclusiva de usuário do site criada automaticamente pelo Yandex Metrica.
[*UserID]: A ID de usuário definida pelo dono do site (por exemplo, quando o usuário do site faz login numa conta pessoal).
[*Идентификатор-посетителя-сайта,-заданный-владельцем-сайта,-например-при-входе-посетителя-сайта-в-личный-кабинет]: A ID de usuário definida pelo dono do site (por exemplo, quando o usuário do site faz login numa conta pessoal).
[*Идентификатор-уникального-посетителя-сайта,-который-Яндекс-Метрика-задает-автоматически]: ID exclusiva de usuário do site criada automaticamente pelo Yandex Metrica.