Coletar dados fornecidos pelo usuário (gtag.js)

Esse recurso faz parte de uma versão Beta aberta e está sujeito a mudanças.

Estas instruções são destinadas a administradores e editores que ativaram a coleta de dados fornecidos pelo usuário e querem começar a enviar dados fornecidos pelo usuário de um site usando a gtag.js.

Before you begin

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

Fazer download do manual de implementação de dados fornecidos pelo usuário para saber mais sobre dados fornecidos pelo usuário no Google Analytics.

Escolher como identificar os dados fornecidos pelo usuário

1. Em Administrador, em Coleta e modificação de dados, clique em Fluxos de dados.
   Observação: o link anterior abre a última propriedade do Google Analytics que você acessou. É necessário fazer login em uma Conta do Google para abrir a propriedade. É possível mudar a propriedade com o seletor. Você precisa ter função de editor ou superior na conta do Google Analytics. no nível da propriedade para definir as configurações de dados fornecidos pelo usuário.
   
2. Selecione o fluxo de dados da Web.
3. Em "Tag do Google", selecione Definir as configurações da tag > Permitir recursos de dados fornecidos pelo usuário.
4. Ative a opção Permitir recursos de dados fornecidos pelo usuário.
   
5. Escolha uma ou mais maneiras de identificar os dados fornecidos pelo usuário:

   Opção	Descrição
   Detectar automaticamente dados enviados pelo usuário	O Google Analytics inspeciona suas páginas da web em busca de strings que correspondem ao padrão de endereços de e-mail, números de telefone, nomes e endereços. Recomendamos complementar essa opção com as opções abaixo.
   Especificar seletores de CSS ou variáveis JavaScript	Selecione os tipos de dados fornecidos pelo usuário que você quer coletar, como endereços de e-mail ou números de telefone. Para cada tipo de dado, escolha como identificar os dados na página: um seletor de CSS ou uma variável JavaScript global. Saiba como especificar seletores de CSS ou variáveis JavaScript (gtag.js). Esse método é mais preciso do que detectar automaticamente os dados fornecidos pelo usuário, mas não é tão confiável quanto adicionar um snippet de código ao seu site. Se você muda o código do seu site com frequência, especialmente a formatação ou os seletores de CSS na página da coleta, convém adicionar um snippet de código ao seu site.
   Adicionar um snippet de código ao seu site	Adicione o código JavaScript às suas páginas da Web para coletar endereços de e-mail, números de telefone e/ou nomes e endereços. Em seguida, defina o parâmetro "user_data" para cada evento na página. Saiba como adicionar um snippet de código ao seu site.

6. Clique em Salvar.

Campos a serem definidos

A tabela a seguir descreve cada campo que você pode definir. O nome da chave mostra como você precisa fazer referência ao campo no código. É necessário transmitir os dados como um tipo de string. Ao definir o nome e o endereço, defina cada componente como uma variável individual, como nome e sobrenome.

Observação: se você quiser enviar dados sem hash e deixar o Google normalizar e gerar hash, use o primeiro nome da chave em cada campo de dados. Por exemplo, use email no campo de dados "Endereço de e-mail" abaixo. Se você quiser enviar dados com hash, use o nome da chave que começa com sha256_.

Campo de dados	Nome da chave	Descrição
Endereço de e-mail	e-mail	E-mail do usuário Exemplo: "[e-mail]"
	sha256_email_address	E-mail do usuário com hash. Exemplo: "a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db"
Número de telefone	phone_number	Número de telefone do usuário. Precisa estar no formato E.164, isto é, ter de 11 a 15 dígitos e incluir um prefixo de sinal de adição (+) e um código de país sem traços, parênteses ou espaços. Exemplo: "[phone]"
	sha256_phone_number	Número de telefone do usuário com hash. Exemplo: "e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1"
Nome	address.first_name	Nome do usuário, por exemplo, "João".
	address.sha256_first_name	Nome do usuário com hash. Exemplo: "96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a"
Sobrenome	address.last_name	Sobrenome do usuário, por exemplo, "Silva".
	address.sha256_last_name	Sobrenome do usuário com hash. Exemplo: "799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f"
Endereço	address.street	Endereço do usuário, por exemplo, "Avenida Brasil, 123"
Cidade	address.city	Nome da cidade do usuário, por exemplo, "'Curitiba".
Região	address.region	Província, estado ou região do usuário, por exemplo, "Paraná".
CEP	address.postal_code	Código postal do usuário. Por exemplo, "SO99 9XX".
País	address.country	Código do país do usuário, por exemplo, "Brasil". Use os códigos de país de duas letras de acordo com o padrão ISO 3166-1 alfa-2.