[GA4] Recolha dados fornecidos pelos utilizadores (gtag.js)

Esta funcionalidade faz parte de uma versão beta aberta e está sujeita a alterações.

Estas instruções destinam-se a administradores e editores que ativaram a recolha de dados fornecidos pelos utilizadores e querem começar a enviá-los a partir de um Website através da gtag.js.

Before you begin

You must turn on user-provided data collection in Google Analytics.

Escolha como identificar dados fornecidos pelos utilizadores

1. Em Administrador, em Recolha e modificação de dados, clique em Streams de dados.
   O link anterior abre a última propriedade do Analytics a que acedeu. Pode alterar a propriedade com o seletor de propriedades. Tem de ter a função Editor ou superior ao nível da propriedade para configurar as definições de dados fornecidos pelos utilizadores.
   
2. Selecione a stream de dados da Web pretendida.
3. Em Etiqueta Google, clique em Configure as definições da etiqueta > Permita capacidades de dados fornecidos pelos utilizadores.
4. Ative a opção Permitir capacidades de dados fornecidos pelos utilizadores.
   
5. Escolha uma ou mais formas de identificar os dados fornecidos pelos utilizadores:

   Opção	Descrição
   Detetar automaticamente dados fornecidos pelos utilizadores	O Google Analytics inspeciona as suas páginas Web para encontrar strings que correspondem ao padrão de um endereço de email. Os números de telefone e as moradas estão excluídos da opção. Recomendamos que complemente a opção com o seguinte.
   Especifique seletores CSS ou variáveis JavaScript	Selecione os tipos de dados fornecidos pelos utilizadores que quer recolher, como endereços de email ou números de telefone. Para cada tipo de dados, selecione como quer identificar os dados na página: através de um seletor CSS ou de uma variável JavaScript global. Saiba mais sobre esta opção Este método é mais preciso do que detetar automaticamente os dados fornecidos pelos utilizadores, mas não é tão fiável como adicionar um fragmento do código ao seu Website. Se alterar frequentemente o código do seu Website, em particular a formatação ou os seletores CSS na página de recolha, é aconselhável adicionar um fragmento do código ao seu Website.
   Adicione um fragmento do código ao seu Website	Adicione código JavaScript às suas páginas Web para recolher endereços de email, números de telefone e/ou nomes e moradas. Em seguida, defina o parâmetro user_data para cada evento na página. Saiba mais sobre esta opção

6. Clique em Guardar.

Campos a definir

A tabela seguinte descreve cada campo que pode definir. O nome da chave mostra como tem de fazer referência ao campo no seu código. Tem de transmitir os dados com o tipo string. Ao definir o nome e a morada, certifique-se de que define cada componente como uma variável individual (por exemplo, nome próprio, apelido, etc.).

Nota: se quiser enviar dados sem hash e permitir que a Google normalize e aplique hash aos dados, use o nome da primeira chave para cada campo de dados. Por exemplo, o email no campo de dados do endereço de email abaixo. Se quiser enviar dados com hash, use o nome da chave que começa por sha256_.

Campo de dados	Nome da chave	Descrição
Endereço de email	email	Email do utilizador. Exemplo: ‘[e-mail]’
	sha256_email_address	Email do utilizador com hash. Exemplo: ‘a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db’
Número de telefone	phone_number	Número de telefone do utilizador. Tem de estar no formato E.164, o que significa que tem de ter entre 11 e 15 dígitos, incluindo um prefixo de sinal de adição (+) e o código do país sem traços, parênteses ou espaços. Exemplo: ‘[phone]’
	sha256_phone_number	Número de telefone do utilizador com hash. Exemplo: ‘e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1’
Nome próprio	address.first_name	Nome próprio do utilizador. Exemplo: 'Manuel'
	address.sha256_first_name	Nome próprio do utilizador com hash. Exemplo: ‘96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a’
Apelido	address.last_name	Apelido do utilizador. Exemplo: 'Silva'
	address.sha256_last_name	Apelido do utilizador com hash. Exemplo: ‘799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f’
Morada	address.street	Morada do utilizador. Exemplo: 'Rua Nova, 123'
Cidade	address.city	Nome da cidade do utilizador. Exemplo: 'Setúbal'
Região	address.region	Concelho, distrito ou região do utilizador. Exemplo: 'Setúbal'
Código postal	address.postal_code	Código postal do utilizador. Exemplo: "SO99 9XX"
País	address.country	Código do país do utilizador. Exemplo: 'Reino Unido'. Use os códigos do país de 2 letras, de acordo com a norma ISO 3166-1 alfa-2.