Instalar o pixel

O pixel da owiew coleta visitas e comportamento do seu site num domínio seu (primeira parte). Esta página cobre a instalação pela tag e pelo Google Tag Manager. Para mandar eventos sem a tag, veja Enviar eventos direto.

Como a owiew decide de quem é um evento

Três coisas trabalham juntas, e confundi-las causa quase toda falha de instalação:

Elemento	O que decide
Chave pública do stream (`pk_...`)	De quem é o evento. Viaja em todo evento e aparece no HTML da página. É pública por desenho.
Origem (`Origin` do navegador)	Se o evento é aceito. Cada propriedade declara os hosts de onde aceita eventos.
Host de coleta (`px.<seu-dominio>`)	Por onde o evento é entregue. Pertence à organização e serve todas as propriedades.

Em resumo: a chave diz quem, a origem diz se pode, o host diz por onde.

Pré-requisitos

Acesso de administração ao painel do pixel da sua organização.
Acesso à zona DNS do seu domínio.
Uma propriedade e um stream criados no painel, com a chave pública do stream.

Passo 1: provar a posse do domínio

Faça isto uma vez por organização.

No painel do pixel, abra a tela de domínio de coleta e use Provar a posse de um domínio.
Digite o seu domínio. Pode ser qualquer subdomínio, como www.exemplo.com.br. O painel deduz o domínio registrável (exemplo.com.br).
Crie na zona DNS o registro TXT que o painel mostra. O nome começa com _owiew. seguido do domínio registrável. Copie o nome e o valor exatamente como aparecem na tela.
Volte ao painel e clique em verificar.

Provada a zona, todos os subdomínios dela ficam autorizados, os já cadastrados e os futuros. Não existe um TXT por subdomínio.

Passo 2: cadastrar e apontar o host de coleta

No painel, cadastre o subdomínio de coleta (por exemplo px). O painel mostra o destino do CNAME.
Só depois crie o registro na zona DNS:

px.exemplo.com.br    CNAME    cname.owiew.com

A ordem importa. O certificado é emitido sob demanda e só para hosts já ativos no painel. Se o DNS chegar antes do cadastro, a emissão é recusada e a tentativa conta contra o limite da autoridade certificadora.

Passo 3: colar a tag

Cole no HTML das páginas, de preferência no head:

<script src="https://px.exemplo.com.br/v/pk_00000000000000000000000000000000.js" defer></script>

A chave do exemplo é inventada. Use a do seu stream. O endereço de envio dos eventos não é escrito na página: o arquivo servido já traz o endereço do host que o entregou. Não escreva o endpoint à mão, para que a coleta continue funcionando se o host mudar.

Uma chave por domínio. Se o mesmo aplicativo serve dois domínios (um site e um painel, por exemplo), cada um precisa da chave da sua propriedade. Usar uma só chave nos dois faz com que parte dos eventos seja recusada por origem não declarada, sem aviso.

Ao carregar, a tag envia um evento page_view automaticamente.

Instalação pelo Google Tag Manager

A owiew fornece um template de tag para o Google Tag Manager. Ele é importável hoje: em Modelos, Novo, menu de três pontos, Importar, escolhendo o arquivo do template. A publicação na galeria de templates do Google é planejada.

Campos do template:

Campo	O que preencher
Endereço de coleta	O host de coleta da sua zona, por exemplo `https://px.exemplo.com.br`.
Chave pública do stream	A chave `pk_...` do stream certo.
Nome do evento	Padrão `page_view`.
Parâmetros	Pares nome e valor. Número entra como número e texto como texto.
Valor da conversão	Em unidades da moeda, por exemplo `189.90`. Vazio quando não houver.
Moeda	Padrão `BRL`.

O template envia por requisição GET (o ambiente do Tag Manager só permite isso) e lê o modo de consentimento do Google (analytics_storage e ad_storage). Por ser GET, a owiew remove do evento o que a tag coletaria sozinha: a query string da página, o referrer, o título e o id de usuário. Ficam o caminho da URL e o que você configurou no Tag Manager. O corpo do GET é limitado a 512 bytes.

Regra de aceitação de origem

Stream sem nenhum domínio ativo: aceita qualquer origem. Isso permite que uma tag recém-colada funcione antes de alguém declarar o domínio.
Stream com algum domínio ativo: aceita só as origens ativas.
Origem vazia: aceita. Coleta servidor a servidor e navegadores antigos não a enviam.

Efeito prático: ativar o primeiro domínio de um stream tira esse stream do modo permissivo. Qualquer outra origem ainda pendente passa a ser recusada naquele instante, sem aviso no site.

Resultado esperado

Ao abrir uma página do seu site, a aba de tempo real do painel mostra a visita em alguns segundos.

Se algo der errado

O pixel nunca avisa falhas pelo navegador. Veja Testar e diagnosticar o pixel.