Acerca do fragmento gtag.js e dos IDs de propriedades
Os fragmentos gtag.js de uma propriedade do Universal Analytics e de uma propriedade do Google Analytics 4 são fundamentalmente os mesmos. Ambos os fragmentos têm a seguinte estrutura:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<ID de propriedade A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<ID de propriedade A>');
08:
09: gtag('config', '<ID de propriedade B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<ID de propriedade B>' });
14:
15: </script>
Linha 1: se implementou uma propriedade do Universal Analytics através da gtag.js, é provável que já tenha esta linha de código no seu site. Em vez de <ID de propriedade A>, irá ver "UA-", seguido de uma série de números. Se implementou a gtag.js para o Google Ads ou outro produto da Google Marketing Platform, também pode ter esta linha de código no seu Website, mas <ID de propriedade A> começa com "AW-" ou "DC-".
O ID de propriedade (ou o ID de etiqueta, para propriedades do Google Analytics 4) indicado por <ID de propriedade A> "controla" este fragmento gtag.js. Isto é importante pelos seguintes motivos:
- Se esta linha já existir, não é necessário implementá-la uma segunda vez. Apenas será necessário adicionar uma linha "config" para especificar o ID da etiqueta.
- O ID de propriedade nesta linha é o "controlador" do fragmento gtag.js. Se um ID de propriedade do Universal Analytics ("UA-XXXXXXXX") controlar a etiqueta, pode utilizar etiquetas do site associadas para enviar dados de medição para uma propriedade do Google Analytics 4 sem ter de adicionar novo código à página.
Linha 7: a diretiva "config" da gtag permite a recolha de dados para a propriedade associada ao valor <ID de propriedade A>. Por exemplo, numa propriedade do Google Analytics 4, adicionar esta diretiva com um ID de etiqueta faz com que sejam enviados eventos page_view para essa propriedade.
O ID de propriedade pode representar a medição de diferentes produtos Google, incluindo uma propriedade do Universal Analytics ("UA-XXXXXXXX"), uma propriedade do Google Analytics 4 ("G-XXXXXXXX"), o Google Ads ("AW-XXXXXXXX") ou o Floodlight ("DC-XXXXXXXX").
Linha 11: a diretiva "event" da gtag envia um evento. Nos fragmentos onde existem várias diretivas "config" para várias propriedades, o evento é enviado para todas as propriedades.
Neste exemplo, o parâmetro "sign_up" é o nome do evento. O último parâmetro é um objeto que contém um conjunto de parâmetros de eventos. Neste caso, "method" é um parâmetro com o valor de "email".
Linha 13: o evento desta linha tem "send_to" como um parâmetro. Este é um parâmetro especial que envia o evento associado para uma propriedade específica. Por outras palavras, este evento só será enviado para a propriedade indicada pelo valor <ID de propriedade B>.
O comando config
da gtag permite uma medição básica.
- No caso de uma propriedade do Universal Analytics, a diretiva "config" com um ID de propriedade do Universal Analytics envia um resultado de visualização de página.
- No caso de uma propriedade do Google Analytics 4, a diretiva "config" com um ID de etiqueta permite a recolha de eventos page_view (como um evento recolhido automaticamente) quando é carregada numa página.
Identificadores de propriedades
Os IDs de propriedades do Universal Analytics têm o formato "UA-XXXXXXXX". Por vezes, este denomina-se ID de acompanhamento. Neste guia, vamos referir-nos a ele como ID de propriedade do UA.
As streams de dados da Web da propriedade do Google Analytics 4 utilizam um ID de etiqueta com o formato "G-XXXXXXXX".
Em alguns exemplos de código e na documentação, poderá ver ambos referidos como "TAG_ID".
Recolha de dados básicos
A ativação da recolha de dados básicos para uma propriedade do Google Analytics 4 permite recolher o seguinte:
- Eventos page_view
- Eventos recolhidos automaticamente
- Eventos de medição otimizada (se estiverem ativados na IU)
Se a sua propriedade do Universal Analytics existente utilizar uma implementação através da gtag.js, tem de efetuar o seguinte para ativar a recolha de dados básicos para a propriedade do Google Analytics 4:
- Opção 1: adicionar uma nova diretiva "config" com o ID da etiqueta relevante
OU - Opção 2: ativar as etiquetas do site associadas (se a sua implementação através da gtag.js existente for elegível)
Independentemente da opção escolhida, a sua propriedade do Universal Analytics existente não é afetada e continua a recolher dados.
Opção 1: adicione uma nova diretiva "config"
Se existir um código gtag.js na página, basta adicionar uma diretiva "config" adicional com o ID de medição da propriedade do Google Analytics 4 relevante. No exemplo abaixo, a linha 8 foi adicionada a uma implementação através da gtag.js existente. Refere-se ao ID de medição da propriedade do Google Analytics 4. Esta ação envia eventos page_view para essa propriedade do Google Analytics 4. Também ativa eventos recolhidos automaticamente e eventos de medição otimizada (se tiver ativado a medição otimizada) nessa propriedade do Google Analytics 4.1: <script async src="https://www.googletagmanager.com/gtag/js?id=<ID de propriedade A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<ID de propriedade A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
Opção 2: ative as etiquetas do site associadas
Pode utilizar uma etiqueta do site associada se:
- O fragmento gtag.js existente na página onde pretende medir as interações dos utilizadores for "controlado" por uma propriedade do Universal Analytics (ou seja, o ID referenciado nesta linha do fragmento gtag.js começa por "UA-"):
<script async src="https://www.googletagmanager.com/gtag/js?id=<ID de propriedade A>"></script>
(As etiquetas do site associadas também funcionam se o fragmento gtag.js existente for controlado por uma propriedade do Google Analytics 4. No entanto, só encontrará esta situação se uma propriedade do Google Analytics 4 já tiver sido implementada.)
- E tiver acesso de administrador à propriedade do Universal Analytics referenciada pelo ID no fragmento.
Definições de configuração da gtag.js
Pode configurar o fragmento gtag.js básico para controlar as definições de recolha de dados, como a anonimização de IPs, as personalizações de cookies e os Google signals. Pode fazê-lo através das diretivas "config" ou "set" na gtag.js.
As propriedades do Universal Analytics ("UA-XXXXXXXX") e do Google Analytics 4 ("G-XXXXXXXX") suportam a implementação destas definições de config através da gtag.js. No entanto, existem algumas diferenças entre estas definições das propriedades do Universal Analytics e do Google Analytics 4.
- A anonimização de IPs tem o valor "true" como padrão e não é configurável numa propriedade do Google Analytics 4. Como tal, o endereço IP é ocultado automaticamente quando é enviado um evento padrão para uma propriedade do Google Analytics 4 ("G-XXXXXXXX").
- Quando for necessário aplicar definições globais a todas as propriedades configuradas, deve utilizar o comando "set" para aplicação a todos os IDs de medição e/ou IDs de propriedades, incluindo os implementados através de etiquetas do site associadas.
- Preste especial atenção às funcionalidades de desativação da personalização de anúncios, que são implementadas de forma mais habitual com uma linha "config".
- Quando utilizar etiquetas do site associadas: as configurações efetuadas no código gtag.js com "config" são aplicáveis apenas à propriedade associada ao ID de medição nessa linha de código. As mesmas não serão enviadas automaticamente para a propriedade do Google Analytics 4 associada. Se pretender que a configuração se aplique à propriedade do Google Analytics 4 associada:
- Crie uma diretiva "config" separada e aplique-a à propriedade do Google Analytics 4 relevante ao referenciar o ID de medição.
OU - Configure a definição através de uma diretiva "set". Nesse caso, a configuração será aplicada a todas as propriedades configuradas.
- Crie uma diretiva "config" separada e aplique-a à propriedade do Google Analytics 4 relevante ao referenciar o ID de medição.
Exemplos de configuração
Ative a recolha de dados básicos; configure o User ID
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
Configure as definições de cookies
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'Meucookie',
'cookie_domain': 'blogue.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 dias, em segundos
});
Bloqueie um evento page_view
Se não for necessário enviar um evento page_view quando carregar o código config (por exemplo, se tiver um carregamento de iFrame), pode ajustar a definição config para bloquear o evento page_view. Considere um cenário no qual é enviado um evento page_view, seguido de um utilizador a iniciar sessão no site. Para a interação de início de sessão, utiliza uma diretiva "config" para definir o User ID, mas não pretende enviar outro evento page_view. O código seguinte mostra como evitar o envio do evento page_view.
gtag('config', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
Eventos
Consulte o guia de migração de eventos.
Dimensões e métricas personalizadas
As dimensões e métricas personalizadas podem ser utilizadas para expandir informações e importar dados offline, por exemplo, de sistemas CRM.
Quando utiliza a etiqueta Google (gtag.js), as medições de dimensões e métricas personalizadas são recriadas automaticamente em parâmetros se forem utilizadas etiquetas do site associadas ou uma propriedade do Google Analytics 4 (por exemplo, "G-XXXXXXXX").
Saiba mais acerca das dimensões e das métricas personalizadas.