--- metadata: - name: generator content: Diplodoc Platform v5.63.1 alternate: - https://www.yandex.com/support/metrica/en/general/measurement-protocol.md - https://www.yandex.com/support/metrica/es/general/measurement-protocol.md - https://www.yandex.com/support/metrica/pt/general/measurement-protocol.md - https://www.yandex.com/support/metrica/ru/general/measurement-protocol.md - https://www.yandex.com/support/metrica/tr/general/measurement-protocol.md - href: https://www.yandex.com/support/metrica/pt/general/measurement-protocol.md type: text/markdown title: Markdown version - href: https://www.yandex.com/support/metrica/pt/llms.txt?revision=r21566194 rel: describedby title: Measurement Protocol description: Você pode usar esta ferramenta para enviar dados de interação do usuário diretamente do seu servidor para os servidores do Yandex Metrica através de solicitações HTTP. --- > **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/support/metrica/pt/llms.txt?revision=r21566194 # Measurement Protocol **Measurement Protocol** é uma ferramenta que permite enviar dados de interação do usuário diretamente do seu servidor para os servidores do Yandex Metrica através de solicitações HTTP. Ele aprimora as capacidades de coleta e análise de dados, complementando os dados coletados pela tag web padrão. {% note alert %} A melhor forma de usar o **Measurement Protocol** é em acréscimo à coleta automática de dados pela tag Yandex Metrica, e não em substituição a esta. {% endnote %} ## Uso {#app} **Vinculação de sessões online a seus dados**   : O **Measurement Protocol** permite combinar dados coletados pela tag Yandex Metrica em seu site com os dados que a tag web não consegue rastrear. Por exemplo: - complementar a sessão de um usuário com informações sobre páginas onde a tag Yandex Metrica não está instalada; - enviar dados sobre a qualidade de um lead que preencheu um formulário de sessão gravado pela tag web. Adicione um evento de conversão a esta sessão para uma análise mais aprofundada. **Rastreamento de ações tanto da parte do cliente quanto do servidor**   : Com o **Measurement Protocol**, é possível transmitir dados tanto da parte do cliente quanto do servidor. Isso é especialmente útil quando a coleta de dados da parte do cliente é limitada devido a bloqueadores de anúncios ou configurações do navegador. **Transmissão mais precisa de dados de eventos de e-commerce**   : O **Measurement Protocol** permite transmitir dados de eventos de e-commerce diretamente do seu servidor. Isso é útil quando os usuários não retornam ao site após a página de aquisição ou quando a tag web não consegue capturar dados por algum outro motivo, como a presença de bloqueadores de scripts de terceiros no site do usuário. ## Dados transmitidos {#data} Com o **Measurement Protocol**, você pode tanto criar sessões novas na tag quanto complementar as existentes. O principal identificador para enviar dados é a [ClientID](https://www.yandex.com/support/metrica/pt/general/clientid-userid.md) do Yandex Metrica. Ela permite vincular os dados transmitidos com o histórico e as sessões do usuário na tag. É possível enviar: - visualizações de página; - conclusão de objetivos JavaScript; - eventos de e-commerce (visualizações de produto, compras, adições ou remoções do carrinho); - [parâmetros de sessão](https://www.yandex.com/support/metrica/pt/reports/visit-params.md). ## Como configurar a transmissão de dados {#set} 1. Habilite o **Measurement Protocol** nas configurações da tag e obtenha um token de autorização. Para poder enviar dados, acesse a seção **Segurança e uso de dados** na interface do Yandex Metrica ou na API e habilite a opção **Measurement Protocol** nas configurações adicionais da tag. Você receberá um token que deverá ser enviado nas solicitações para [mc.yandex.ru/collect](https://mc.yandex.ru/collect). É possível criar até 5 tokens de autorização adicionais. [Gerenciamento da opção e geração de tokens via API](https://yandex.com/dev/metrika/en/data-import/manage-protocol) 1. Lembre-se do identificador ClientID dos usuários. O principal identificador para envio de dados do **Measurement Protocol** é a ClientID de um usuário do Yandex Metrica. Lembre-se dessa ID no seu servidor durante a sessão de usuário gravada pelo Yandex Metrica para transmissões de dados posteriores. 1. Envie os dados. Envie uma solicitação POST ou GET listando os parâmetros necessários e o token obtido no passo 1 para [mc.yandex.ru/collect](https://mc.yandex.ru/collect). Dentro de 20 minutos, os dados serão gravados na tag. ## Limitação à atualização de sessões web {#limit} Com o **Measurement Protocol**, é possível transmitir dados sobre eventos que ocorreram nas últimas 12 horas. Em virtude disso, só é possível **atualizar uma sessão existente** caso ela tenha terminado há menos de 12 horas. Caso você queira adicionar mais eventos ao histórico de um usuário e as últimas sessões dele tiverem terminado há mais de 12 horas, **crie uma nova sessão**: 1. Crie uma nova sessão com a mesma ClientID usando o [Measurement Protocol da API](https://yandex.com/dev/metrika/en/data-import/measurement-about). 1. Envie os dados do evento. Esses dados irão atualizar o histórico do usuário. Caso precise adicionar dados a sessões mais antigas sem criar sessões novas, experimente [enviar dados offline](https://www.yandex.com/support/metrica/pt/data/offline-params.md). [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.
{% 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) || |#