--- metadata: - name: generator content: Diplodoc Platform v5.54.1 alternate: - https://yandex.com/support/metrica/en/data/visit-params-data.md - https://yandex.com/support/metrica/es/data/visit-params-data.md - https://yandex.com/support/metrica/pt/data/visit-params-data.md - https://yandex.com/support/metrica/ru/data/visit-params-data.md - https://yandex.com/support/metrica/tr/data/visit-params-data.md - https://yandex.com/support/metrica/zh/data/visit-params-data.md - href: pt/data/visit-params-data.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/pt/llms.txt # Transmissão de eventos {% 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](https://yandex.com/support/metrica/pt/general/how-it-works.md#data_extract_pull) pela tag Yandex Metrica. No entanto, há grandes chances de você querer complementar esses dados com os seus próprios dados. Por exemplo, você pode estar interessado em estatísticas sobre quais itens específicos foram comprados ou quais ações os usuários que estavam logados realizaram. O Yandex Metrica permite que você conecte um conjunto personalizado de dados a uma sessão. Esses conjuntos são chamados de _parâmetros de evento_. Esses dados podem ser mostrados em relatórios ou usados como condições para dimensões e segmentação. Os parâmetros de sessão são transmitidos para o armazenamento do contador usando a API JavaScript. Os dados podem ser enviados durante a inicialização da tag ou a qualquer momento antes do [tempo-limite da sessão](https://yandex.com/support/metrica/pt/general/counter-general.md#time-out) esgotar. Durante a inicialização da tag, os parâmetros de sessão são especificados no parâmetro [params](https://yandex.com/support/metrica/pt/code/counter-initialize.md#param-params). Para transferir parâmetros de evento durante a sessão de um usuário no seu site, use o método [params](https://yandex.com/support/metrica/pt/objects/params-method.md) ou um argumento opcional dos métodos [extLink](https://yandex.com/support/metrica/pt/objects/extlink.md), [file](https://yandex.com/support/metrica/pt/objects/file.md), [hit](https://yandex.com/support/metrica/pt/objects/hit.md), [reachGoal](https://yandex.com/support/metrica/pt/objects/reachgoal.md). Os parâmetros de evento são transmitidos como objetos ou arranjo de objetos. ## Transferência e processamento de dados {#proc} Os dados são transferidos para o Yandex Metrica como objetos JavaScript. A solicitação de dados enviada para o Yandex Metrica pode conter no máximo 8 KB (8.192 caracteres). Quando você [envia dados hierarquicamente estruturados](https://yandex.com/support/metrica/pt/data/visit-params-example.md#level), os relatórios do Yandex Metrica exibem até 10 níveis de aninhamento. Se, no espaço de uma única sessão, um parâmetro tiver sido transmitido com diferentes valores, o Yandex Metrica exibirá todos os valores. Observe que é possível enviar até 512 parâmetros em uma só sessão. [Restrições a transferência de dados](https://yandex.com/support/metrica/pt/general/limits.md) 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. - **arranjo** — Cria um ramo de árvore [Parâmetros], calcula o número de vezes que o valor é um arranjo e invoca o algoritmo recursivamente para cada item do arranjo. - **true**, **false** ou **null** — Calcula o número de vezes que cada valor ocorre. Exemplo de dados transferidos: ```javascript // Exemplo de transferência de objeto. Máxima profundidade de aninhamento: 10 níveis. ym(XXXXXXXX, "params", { level1_1: { level2_1: { level3_1: "exemplo1" , level3_2: "exemplo2", }, ... level2_2: "exemplo3" } }) ``` Onde: - XXXXXXXX é o número da tag. - level1_1, level1_2, level2_1 — estrutura dos parâmetros de evento. - exemplo1, exemplo2, exemplo3 — valores de parâmetros. Para mais exemplos, consulte a seção [Exemplos de envio de parâmetros de sessão](https://yandex.com/support/metrica/pt/data/visit-params-example.md). ## Relatórios por parâmetros {#param} Os eventos são transferidos para o Yandex Metrica como [dimensões](*группировки) ou [objetivos](https://yandex.com/support/metrica/pt/general/glossary.md#goal). Os números que são calculados pelo processamento dos dados são as [métricas](*метриками). Para visualizar estatísticas sobre eventos transmitidos, use o relatório ["Parâmetros de evento"](https://yandex.com/support/metrica/pt/reports/event-params.md) ou o relatório ["Parâmetros de sessão"](https://yandex.com/support/metrica/pt/reports/visit-params.md). Você também pode usar os parâmetros como condição para a [criação de segmentos](https://yandex.com/support/metrica/pt/general/segmentation.md) em outros relatórios do Yandex Metrica. {% note info %} Caso você informe parâmetros usando o método [reachGoal](https://yandex.com/support/metrica/pt/objects/reachgoal.md), mas ainda não tenha criado um objetivo JavaScript para a tag ou só o tenha criado como parte de um objetivo multietapas, os dados não aparecerão no relatório "Parâmetros de evento". Crie um objetivo JavaScript distinto na interface da tag ou use algum outro métodos para transferir parâmetros: [params](https://yandex.com/support/metrica/pt/objects/params-method.md), [extLink](https://yandex.com/support/metrica/pt/objects/extlink.md), [file](https://yandex.com/support/metrica/pt/objects/file.md) ou [hit](https://yandex.com/support/metrica/pt/objects/hit.md). {% endnote %} [Fale conosco](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
{% cut "Escrever um e-mail" %} Observe, por gentileza, que nossa equipe de suporte jamais iniciará uma chamada com você. Se alguém ligar para você e se apresentar como a equipe de suporte do Yandex Metrica, não siga as instruções dessa pessoa. Caso você precise ajustar o objetivo para que ele continue a registrar outros eventos além das visualizações de página, por gentileza descreva a situação no formulário.
{% endcut %}
- - -
#| || 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) || |#
[*группировки]: Atributo que representa ações do usuário registradas pela tag (por exemplo, sessão, visualização de página, referência, download de arquivo, etc.). Os dados enviados em um relatório são agrupados por atributo. [*метриками]: Valor numérico baseado em um atributo de uma sessão ou visualização de página. Esse montante pode ser o total ou a média. Por exemplo, as visualizações de página são calculadas como soma de valores, ao passo que a profundidade de sessão é calculada como valor médio.