Avaliar as jornadas do cliente nos domínios

O vinculador de domínios permite que dois ou mais sites relacionados em domínios diferentes sejam avaliados como um. A estrutura do gtag.js é um jeito comum de os produtos aceitos do Google avaliarem a atividade quando as jornadas dos seus clientes se estenderem por vários domínios.

O vinculador de domínios compartilha cookies primários de avaliação entre o domínio de origem e de destino. Esses cookies são armazenados em um navegador da Web e só podem ser acessados por páginas no mesmo domínio.

A configuração da avaliação de vários domínios é um processo de duas etapas:

  1. O domínio de origem decora os URLs que apontam para o de destino, de modo que eles contenham os valores do cookie primário de avaliação do domínio de origem.
  2. O domínio de destino verifica a presença de cookies de avaliação vinculados.

A avaliação de vários domínios com a gtag.js adiciona um parâmetro de vinculador aos URLs que apontam para o domínio de destino. O parâmetro correspondente é identificado pela chave _gl nos parâmetros de consulta de URL:

https://www.example.com/?_gl=1~abcde5~

No domínio de destino, a gtag.js verifica os parâmetros do vinculador no URL. Se um valor válido for encontrado, ela extrairá os cookies primários de avaliação e os armazenará.

Configuração básica

Configure a avaliação de vários domínios na origem dos URLs que apontam para o destino, use o comando set e crie um objeto linker. O vinculador detectará os cliques nesses links e adicionará um parâmetro aos URLs deles de forma automática.

O objeto linker requer um parâmetro domains, que é uma matriz de um ou mais domínios. Esse código anexará o parâmetro do vinculador aos links de uma página que apontam para um domínio de destino example.com:

<script async src="https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('set', 'linker', {'domains': ['example.com']});
  gtag('js', new Date());

  gtag('config', 'GA_MEASUREMENT_ID');
</script>

Você pode listar diversos valores de string na propriedade domains. Quando domains tem pelo menos um valor, a gtag.js aceita links de domínio de entrada por padrão. Com isso, será possível usar o mesmo snippet de código em todos os domínios.

gtag('set', 'linker', {
  'domains': ['example.com', 'example-b.com']
});

decorate_forms

Se você tiver formulários no seu site que apontem para o domínio de destino, defina a propriedade decorate_forms como true.

gtag('set', 'linker', {
  'domains': ['example.com'],
  'decorate_forms': true
});

url_position

Para que o parâmetro do vinculador apareça no URL após um fragmento (#) em vez de como um parâmetro de consulta (?) (por exemplo, https://example.com#_gl=1~abcde5~), defina url_position como fragment.

gtag('set', 'linker', {
  'domains': ['example.com'],
  'decorate_forms': true,
  'url_position': 'fragment'
});

accept_incoming

Configure a gtag.js para analisar o parâmetro sempre que um usuário acessar uma página no domínio de destino com um parâmetro do vinculador no URL.

Se o domínio de destino tiver sido configurado para vincular automaticamente os domínios, ele aceitará os parâmetros do vinculador por padrão. Nenhum código adicional é necessário nesse domínio.

Se o domínio de destino não estiver configurado para vincular domínios automaticamente, você poderá instruir a página de destino a procurar parâmetros do vinculador. Defina a propriedade accept_incoming como true.

gtag('set', 'linker', {
  'accept_incoming': true
});

Tabela de parâmetros

Parâmetro Tipo Valores aceitos
'accept_incoming' booleano true (padrão se domains tiver um valor), false
'domains' matriz Uma matriz de um ou mais domínios, por exemplo, ['example1.com', 'example2.com']
'decorate_forms' booleano true, false (padrão)
'url_position' string 'query' (padrão), 'fragment'