Protocolo de Mensuração

Protocolo de Mensuração é 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.

Uso

Vinculação de sessões online a seus dados

O Protocolo de Mensuração 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 Protocolo de Mensuração, é 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 Protocolo de Mensuração 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

Com o Protocolo de Mensuração, você pode tanto criar sessões novas na tag quanto complementar as existentes.

O principal identificador para enviar dados é a ID de cliente 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.

Como configurar a transmissão de dados

1. Habilite o Protocolo de Mensuração 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 Protocolo de Mensuração nas configurações adicionais da tag. Você receberá um token que deverá ser enviado nas solicitações para mc.yandex.ru/collect. É possível criar até 5 tokens de autorização adicionais.

   Mais sobre como gerenciar a opção e gerar tokens via API

2. Lembre-se do identificador ID de cliente (ClientID) dos usuários.

   O principal identificador para envio de dados do Protocolo de Mensuração é a ID de cliente (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.

3. 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. Dentro de 20 minutos, os dados serão gravados na tag.

Limitação à atualização de sessões web

Com o Protocolo de Mensuração, é 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 ID de usuário (ClientID) usando o Protocolo de Mensuração da API.
2. 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.

Fale conosco