Tipos de variáveis para a Web definidas pelo utilizador

Crie variáveis personalizadas para a Web definidas pelo utilizador no Gestor de Etiquetas da Google para ir ao encontro de requisitos específicos que as variáveis incorporadas possam não satisfazer.

Para criar uma nova variável definida pelo utilizador:

1. No menu de navegação do lado esquerdo, clique em Variáveis.
2. Na secção "Variáveis definidas pelo utilizador", clique em Nova.
3. Clique em Configuração da variável e selecione o tipo de variável pretendido.
4. Introduza as opções de configuração para o tipo de variável selecionado.
5. Atribua um nome à variável. Utilize um esquema de nomenclatura que descreva a função da variável, por exemplo, "Variável da camada de dados: nome do produto".
6. Clique em Guardar.

O Gestor de Etiquetas suporta os seguintes tipos de variáveis para a Web definidas pelo utilizador:

• Navegação
  • Referenciador HTTP
  • URL
• Variáveis de página
  • Cookie original
  • JavaScript personalizado
  • Camada de dados
• Elementos de página
  • Variável de evento automático
  • Elemento DOM
  • Visibilidade do elemento
• Utilitários
  • Armazenamento do Analytics
  • Constante
  • Evento personalizado
  • Nome do ambiente
  • Definições do Google Analytics
  • Etiqueta Google: definições de configuração
  • Etiqueta Google: definições de eventos
  • Tabela de pesquisa
  • Número aleatório
  • Tabela de expressão regular
• Dados fornecidos pelos utilizadores
• Dados do contentor
  • ID do contentor
  • Número da versão do contentor
  • Modo de depuração

Navegação

Referenciador HTTP

O valor está definido como o referenciador HTTP, que é o URL da página anterior que a pessoa visitou. Por exemplo, se uma pessoa navegar para uma das suas páginas de produto a partir da página inicial, o referenciador será a página inicial. É automaticamente criada uma instância deste tipo de variável pelo Gestor de Etiquetas, mas pode criar instâncias adicionais se pretender expor diferentes partes do URL do referenciador.

URL

Este tipo de variável permite analisar e expor componentes do URL. Pode criar instâncias adicionais para expor diferentes partes do URL. Os componentes do URL que pode escolher são: URL completo, Protocolo, Nome do anfitrião, Porta, Caminho, Extensão do nome de ficheiro, Consulta e Fragmento. O valor de entrada definido para variáveis deste tipo é o URL da página atual na qual o utilizador se encontra (obtido a partir de document.location). Ajuste a Origem do URL para comunicar ao Gestor de Etiquetas que deve utilizar outra variável como a origem do valor do URL.

Variáveis de página

Cookie original

O valor da variável corresponde ao valor do cookie original com o nome do domínio no qual o utilizador se encontra atualmente. Se for implementado mais do que um cookie com o mesmo nome no mesmo domínio, é escolhido o primeiro valor. O valor corresponde ao que obteria se chamasse document.cookie a partir de uma página e escolhesse o primeiro resultado.

JavaScript personalizado

O valor da variável corresponde ao resultado de uma função JavaScript. O JavaScript tem de ter a forma de uma função anónima que devolve um valor. Por exemplo, pode ser criada uma variável JavaScript personalizada para converter todas as instâncias da variável predefinida {{url}} em minúsculas:

function () {   return {{url}}.toLowerCase(); }

Camada de dados

O valor é definido quando são enviados dados à camada de dados através da chamada dataLayer.push():
dataLayer.push({"Data Layer Name": "value"}).

Pode especificar como o Gestor de Etiquetas interpreta os pontos (".") no nome da chave:

• Versão 1: permitir pontos em nomes de chaves. Por exemplo, para dataLayer.push("a.b.c": "value"), interprete o nome da chave como "a.b.c" (ou seja, {"a.b.c": "value"}).
• Versão 2: interpretar os pontos como valores aninhados. Por exemplo, interprete dataLayer.push({"a.b.c": "value"}) como três níveis aninhados: {a: {b: {c: "value"}}}.

Variável JavaScript

O valor é definido como a variável JavaScript global especificada. Se o valor necessário não tiver sido configurado na camada de dados (consulte a secção da variável Camada de dados) e não estiver visível no DOM (consulte também a secção da variável Elemento DOM), pode ser possível obter o valor a partir de uma variável JavaScript. Use este tipo de variável se conseguir encontrar o valor no código-fonte da página sob a forma de uma variável JavaScript global.

Elementos de página

Variável de evento automático

Captura informações sobre um item que acionou um evento (por exemplo, cliques, envios de formulários, visibilidade de elementos, etc.)

• Elemento: devolve o objeto do elemento. Pode ser tratado como um objeto para JavaScript personalizado, por exemplo, {{Element}}.title, ou em seletores CSS, por exemplo, {{Element}} corresponde ao seletor CSS div.foo.
• Tipo de elemento: devolve o valor element.tagName, por exemplo, "A", "BUTTON", "IMG".
• Atributo do elemento: especifique um nome de atributo e esta opção vai devolver o valor desse atributo.
• Classes de elemento: devolve a lista de classes encontradas no atributo class do elemento.
• ID do elemento: devolve o valor do atributo id.
• Segmentação de elemento: devolve o valor do atributo target, por exemplo, "_blank".
• Texto do elemento: devolve o valor do conteúdo de texto do elemento.
• URL do elemento: devolve o URL do elemento, reunido a partir do atributo href ou action.
• Novo fragmento de URL do histórico: devolve o novo fragmento de URL do histórico de navegação, por exemplo, "#summary".
• Antigo fragmento de URL do histórico: devolve o antigo fragmento de URL do histórico de navegação, por exemplo, "#intro".
• Novo estado do histórico: o objeto do novo estado do histórico, controlado pelas chamadas do site a pushState.
• Antigo estado do histórico: o objeto do antigo estado do histórico, controlado pelas chamadas do site a pushState.
• Origem da alteração do histórico: devolve o evento que provocou uma alteração no histórico, por exemplo, "pushState", "replaceState", etc.

Elemento DOM

O valor é definido como o texto do elemento DOM (Document Object Model) ou o valor do atributo do elemento DOM especificado. Se o valor pretendido não tiver sido configurado na camada de dados (consulte a secção da variável Camada de dados), pode ser possível obter o valor a partir do DOM. Utilize este tipo de variável se conseguir encontrar o valor no DOM.

Se o nome do atributo opcional estiver definido, o valor da variável devolverá o valor especificado desse atributo (por exemplo, data-food="cupcake"); caso contrário, o valor será o texto dentro do elemento DOM.

Visibilidade do elemento

O valor é definido com base no estado visível do elemento DOM especificado. Ao contrário do acionador Visibilidade do elemento, uma variável Visibilidade do elemento única apenas pode comunicar a visibilidade de um elemento. Escolha se pretende selecionar um elemento com base no ID do elemento ou num seletor CSS. Se um seletor CSS especificado efetuar a correspondência de vários elementos, será utilizado o primeiro elemento com correspondência.

Pode escolher o tipo de saída para esta variável:

• Verdadeiro/falso: um valor booleano que indica se o elemento selecionado está visível quando a variável é referenciada.
• Percentagem: um valor percentual entre 0 e 100 que indica a proporção do elemento selecionado que está visível no ecrã quando a variável é referenciada.

Se selecionar Verdadeiro/falso como o tipo de saída, também pode especificar a Percentagem mínima de visibilidade para indicar a proporção do elemento selecionado que tem de estar visível no ecrã para que a variável devolva true.

Utilitários

Armazenamento do Analytics

O tipo de variável de armazenamento do Analytics é uma opção de variável personalizada e uma forma fiável de aceder a identificadores essenciais do Google Analytics.

Quando cria uma variável de armazenamento do Analytics personalizada, pode selecionar os seguintes campos de dados:

• ID do cliente: identificador único de um utilizador ou um dispositivo pseudonimizado.
• ID da sessão: o identificador único de uma sessão de utilizador.
• Número da sessão: o número da sessão atual do utilizador.

A variável também inclui uma secção "Mais definições", que oferece configuração opcional com base no campo de dados selecionado:

Campo de dados	ID de medição	Prefixo de cookies	Descrição
ID do cliente	Não aplicável	Opcional	Permite a filtragem por um prefixo de cookies específico, se necessário.
ID da sessão	Opcional	Opcional	Se for fornecido um ID de medição, o Gestor de Etiquetas da Google devolve o ID da sessão único correspondente a esse ID de medição. Se não for fornecido um ID de medição, devolve uma string composta que contém IDs de todos os cookies de sessão do Google Analytics relevantes.
Número da sessão	Opcional	Opcional	Se for fornecido um ID de medição, o Gestor de Etiquetas da Google devolve o número da sessão único correspondente a esse ID de medição. Se não for fornecido um ID de medição, devolve uma string composta que contém números de todos os cookies de sessão do Google Analytics relevantes.

A simplificação da complexidade da leitura e da análise de vários cookies do Google Analytics permite à variável de armazenamento do Analytics garantir que os identificadores obtidos são robustos e compatíveis para utilização em contextos como o Protocolo de Medição.

Constante

O valor é definido como uma string fornecida. As variáveis de string Constante são utilizadas frequentemente quando existem várias etiquetas que utilizam o mesmo número de conta. Consulte também: Definições do Google Analytics.

Evento personalizado

O valor da variável corresponde ao nome do evento personalizado enviado à camada de dados.

Nome do ambiente

Devolve o nome do ambiente apresentado no modo de pré-visualização.

Etiqueta Google: definições de configuração

Esta variável permite definir parâmetros ao nível da configuração quando a etiqueta Google é carregada.

Por exemplo, suponhamos que publica o seu Website em vários idiomas e que quer segmentar o seu público-alvo de acordo com o idioma em que este lê. Pode criar uma variável de configuração com um parâmetro language e usá-la nas suas etiquetas Google, em vez de atualizar manualmente cada etiqueta.

Saiba como reusar as definições de configuração.

Etiqueta Google: definições de eventos

Esta variável permite definir parâmetros ao nível do evento para enviar dados adicionais com um evento do GA4.

Por exemplo, suponhamos que tem uma loja online e que está a realizar uma promoção. Neste momento, quer acompanhar quantas pessoas usam o código de desconto que lhes forneceu. Em vez de adicionar manualmente o parâmetro discount a cada uma das etiquetas, pode reusar o parâmetro com uma variável Etiqueta Google: definições do evento.

Saiba como reusar as definições de configuração.

Tabela de pesquisa

O valor é definido de acordo com as instruções na tabela de pesquisa. A tabela de pesquisa contém duas colunas. (A tabela está vazia para ilustrar o modo como os dados são utilizados posteriormente):

Quando [select variable] for igual a	Definir [this variable] como

A tabela de pesquisa permite criar uma variável cujo valor varia de acordo com o valor de outra variável. Esta funcionalidade é útil no caso de o seu Website estar configurado de modo a que o valor adequado (por exemplo um ID de conversão) possa ser mapeado para o URL, elemento DOM ou para outra parte da página. Neste exemplo, é criada uma variável denominada ID de conversão. Se o URL contiver "/thanks/buy1.html", o valor é definido como "12345"; se o URL contiver "thanks/buy2.html", o valor é definido como "34567".

Quando {{url}} contém	Definir {{Conversion ID}} para
/thanks/buy1.html	12345
/thanks/buy2.html	34567
/thanks/buy3.html	56789

Número aleatório

O valor da variável corresponde a um número aleatório entre 0 e 2147483647.

Tabela de expressão regular

Uma variável Tabela de expressão regular é semelhante a uma variável Tabela de pesquisa, com o acréscimo de poder executar padrões de expressão regular para os itens com que pretende efetuar a correspondência.

Para esta configuração da tabela de expressão regular:

Padrão	Saída
.*/page[1-3]\.html.*	foo
.*/page[4-6]\.html.*	bar
.*/page[7-9]\.html.*	baz

O valor de saída da variável será como se segue:

Resultado correspondido	Valor
http://example.com/page1.html	foo
http://www.example.com/page1.html	foo
http://example.com/page2.html#detail	foo
http://example.com/page5.html	bar
http://example.com/page5.html?status=new	bar
http://example.com/page6.html	bar
https://example.com/page9.html	baz

As pesquisas da tabela de expressão regular são executadas da parte superior da lista para a parte inferior. Quando é encontrada uma correspondência, é devolvido o valor de saída correspondente.

Selecione Definir valor predefinido para definir um valor de saída para quando não é encontrada uma correspondência.

Por predefinição, os padrões têm de corresponder à string de entrada completa e não são sensíveis a maiúsculas e minúsculas. Este comportamento pode ser ajustado nas Definições avançadas:

• Ignorar maiúsculas e minúsculas: haverá correspondência dos padrões com maiúsculas e minúsculas sem necessidade de codificar explicitamente este comportamento na expressão regular.

• Apenas correspondências completas: se esta opção estiver ativada, os padrões têm de corresponder à entrada completa. É equivalente a ter âncoras de início (^) e de fim ($) implicitamente em torno do padrão. Se estiver desativada, os padrões obterão correspondências quando forem encontrados em qualquer parte da entrada.

• Funcionalidade de grupos de captura e substituição: se esta opção estiver ativada, pode utilizar a sintaxe de substituição com cifrão para incluir partes do valor de entrada (por exemplo, de grupos de captura no padrão com correspondência) no valor de saída. Por exemplo, se a expressão regular com correspondência for /(news)/page(2)\.html, pode utilizar $1 para fazer referência ao primeiro grupo de captura ("news") e $2 para fazer referência ao segundo grupo de captura ("2").

A utilização da "Funcionalidade de grupos de captura e substituição" com a opção "Apenas correspondências completas" desativada poderá resultar num comportamento inesperado (por exemplo, pode devolver o valor de entrada completo com a parte com correspondência substituída).

Dados fornecidos pelos utilizadores

Recolhe informações de formulários de contacto, como email, telefone, nome e morada. Especifique as informações a capturar através de um dos seguintes modos:

• Configuração automática: deteta automaticamente campos de formulários no seu Website e novas entradas.
• Configuração manual: permite-lhe mapear variáveis existentes do Gestor de Etiquetas para os campos de dados fornecidos pelos utilizadores correspondentes, como email, número de telefone, nome e morada.
• Código: permite especificar uma variável Camada de dados ou uma variável JavaScript personalizada que devolve o objeto estruturado de dados fornecidos pelos utilizadores.

Dados do contentor

ID do contentor

Devolve o ID do contentor do Gestor de Etiquetas, por exemplo, "GTM-101010".

Número da versão do contentor

Quando o contentor está no modo de pré-visualização, a variável da versão do contentor devolve o número da versão de pré-visualização do contentor. Caso contrário, esta variável devolve o número da versão ativa do contentor.

Modo de depuração

O valor é definido como true se o contentor estiver no modo de depuração e pré-visualização e como false nas restantes situações.