Consentimento e identificação do visitante

O pixel registra a decisão de consentimento de cada visitante junto de cada evento. Esta página explica como informar essa decisão, o que a owiew faz com ela e como o visitante é identificado.

O pixel não bloqueia a coleta por conta própria

O pixel não exibe banner de consentimento e não interrompe o envio quando o visitante recusa. Ele grava a decisão para que os relatórios e a auditoria saibam com que base cada evento foi coletado.

Se a sua base legal exige consentimento prévio, carregue a tag somente depois que o visitante aceitar. Quem controla isso é o seu site ou o seu gerenciador de consentimento.

Informar o consentimento no navegador

Defina window.__vwConsent antes de a tag carregar e atualize-o quando o visitante decidir:

<script>
  window.__vwConsent = { analytics: true, ads: false };
</script>
<script src="https://px.exemplo.com.br/v/pk_00000000000000000000000000000000.js" defer></script>

A tag lê o objeto a cada evento e envia os campos ca (analytics) e cd (anúncios) como booleanos.

No endpoint de coleta direta, envie ca e cd no corpo do evento. Pelo Google Tag Manager, o template lê o modo de consentimento do Google (analytics_storage e ad_storage) e preenche os dois campos sozinho.

Como a owiew interpreta

Situação	Estado gravado	Base legal gravada
`ca` e `cd` ausentes	`nao_solicitado`	Legítimo interesse
Nenhum dos campos enviados é verdadeiro	`recusado`	Legítimo interesse
`ca` e `cd` enviados, os dois verdadeiros	`concedido`	Consentimento
`ca` e `cd` enviados, só um verdadeiro	`parcial`	Consentimento
Só um dos campos enviado e verdadeiro	`concedido`	Consentimento

Quem prefere ser explícito pode enviar o formato estruturado, que vence os booleanos:

Campo	Descrição
`cs`	Estado: `nao_solicitado`, `concedido`, `parcial`, `recusado` ou `retirado`.
`cf`	Finalidades consentidas: `analytics`, `ads`, `ad_user_data`, `ad_personalization`, `personalization`, `functionality`, `security`. Valores fora da lista são descartados.
`bl`	Base legal: `legitimo_interesse`, `consentimento`, `contrato` ou `obrigacao_legal`. Estado `concedido` ou `parcial` força `consentimento`.
`cv`	Versão do texto do banner que a pessoa viu.
`cem`	Instante da decisão, em milissegundos desde 1970.

Os estados nao_solicitado e recusado não guardam finalidades.

Valores de estado desconhecidos viram nao_solicitado. O estado retirado distingue quem consentiu e depois mudou de ideia: os eventos anteriores à retirada continuam lícitos.

Dois cuidados valem para quem integra:

Campo ausente significa que ninguém foi perguntado. Campo false significa que a pessoa recusou. Não envie false por padrão quando a pergunta não foi feita.
Consentimento no futuro (relógio do visitante errado) é ajustado para o instante em que a owiew recebeu o evento.

O estado de consentimento também controla o envio de dados da pessoa a plataformas de anúncio nas conversões: sem base legal ou com marketing recusado, o envio com dados pessoais não acontece.

Do Not Track

O pixel lê o sinal doNotTrack do navegador e o grava no campo dnt. Ele coleta o sinal e não o obedece sozinho. Como o valor fica gravado em cada evento, é possível decidir a política depois. Se o seu site precisa honrar o sinal, não carregue a tag quando navigator.doNotTrack valer "1":

<script>
  if (navigator.doNotTrack !== "1") {
    var s = document.createElement("script");
    s.src = "https://px.exemplo.com.br/v/pk_00000000000000000000000000000000.js";
    s.defer = true;
    document.head.appendChild(s);
  }
</script>

Identificação do visitante

Identificador	Quem cria	Onde fica	Duração
Dispositivo (`c`)	O servidor de coleta, por cookie de primeira parte `_vw`	Cookie `HttpOnly`, `Secure`, `SameSite=Lax`	Até 730 dias declarados
Sessão (`s`)	A tag, por cookie `_vws`	Cookie de navegador	30 minutos de inatividade, renovados a cada evento
Usuário (`u`)	Você, no endpoint direto	O seu sistema	A sua escolha

Pontos importantes:

O cookie de dispositivo é escrito pelo servidor de coleta, não pelo script. Por ser HttpOnly, o script da página não o lê.
O Safari limita cookies a 7 dias em domínio apontado por CNAME. Nesse navegador, o mesmo dispositivo volta a contar como novo a cada 7 dias. O painel avisa isso na métrica de usuários.
Os usuários do painel são dispositivos distintos, não pessoas.
O id de usuário (u) só existe no endpoint direto. Não envie CPF, e-mail ou outro dado pessoal em claro nele; use um identificador interno seu. O servidor também aplica uma limpeza de credenciais e de padrões de dados pessoais, mas ela é opcional por propriedade e não substitui o seu cuidado.