This feature is part of an open beta. Keep in mind that the feature is subject to change.
Estas instruções são destinadas a para administradores e editores que estão configurando a coleta de dados fornecidos pelo usuário e querem adicionar um snippet de código ao site usando a gtag.js. Atualizar o código no seu site ajuda a garantir que endereços de e-mail, números de telefone e/ou nomes e endereços apareçam na página quando o Google Analytics coletar dados fornecidos pelo usuário.
Visão geral
Para atualizar o código do seu site, defina o valor "user_data" com cada campo de dados fornecidos pelo usuário em um comando "event", "config" ou "set" usando a função "gtag( )".
Se você transmitir os mesmos dados em dois ou mais tipos de comandos (por exemplo, "event" e "config"), o comando "event" vai substituir "config", e o comando "config" vai substituir "set". Saiba mais sobre a precedência de parâmetros da tag do Google.
Atualize o código em todas as páginas onde você coleta dados fornecidos pelo usuário, como de inscrição, geração de leads, finalização da compra ou algo semelhante. Você pode enviar os dados mais de uma vez em uma sessão para garantir que sejam transmitidos ao Google Analytics.
Antes de começar
Estas instruções consideram que:
- você tenha acesso ao código-fonte do site
- a coleta de dados fornecidos pelo usuário esteja ativada e que os recursos desses dados tenham sido permitidos
Hashing the data
You can send hashed or unhashed data from a website. If you send unhashed data, Google normalizes and hashes the data before the data reaches Google's servers. To ensure Analytics interprets the data correctly and to comply with the User-provided data policy, you must use the correct key name (in the next section).
To hash the data:
- Use hex SHA256.
To normalize the data:
- Remove leading or trailing whitespaces.
- Convert the text to lowercase.
- Format phone numbers according to the E.164 standard.
Defining the fields in your code
You must provide at least one of these fields:
- Email (preferred).
- Address (first name, last name, postal code, and country are required). You can optionally provide street address, city, and region as additional match keys.
- A phone number can also be provided along with an email or full name and address.
Make sure the data is available when the Google tag fires. If the data is collected on a previous page, make sure it’s available in your code on the current page so you can configure the field.
Fields to set
The following table describes each field you can set. The key name shows how you must reference the field in your code. You must pass the data as a String type. When defining name and address, make sure to define each component as an individual variable (for example, first name, last name, and so on).
Note: If you want to send unhashed data and let Google normalize and hash the data, use the first key name for each data field. For example, email in the Email address data field below. If you want to send hashed data, use the key name that begins with sha256_.
| Data Field | Key Name | Description |
|---|---|---|
| Email address | email |
User email. Example: ‘jdoe@example.com’ |
sha256_email_address |
Hashed user email. Example: ‘a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db’ |
|
| Phone number | phone_number |
User phone number. Must be in E.164 format, which means it must be 11 to 15 digits including a plus sign (+) prefix and country code with no dashes, parentheses, or spaces. Example: ‘+11231234567’ |
sha256_phone_number |
Hashed user phone number. Example: ‘e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1’ |
|
| First name | address.first_name |
User first name. Example: 'John' |
address.sha256_first_name |
Hashed user first name. Example: ‘96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a’ |
|
| Surname | address.last_name |
User last name. Example: 'Doe' |
address.sha256_last_name |
Hashed user last name. Example: ‘799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f’ |
|
| Street address | address.street |
User street address. Example: '123 New Rd' |
| City | address.city |
User city name. Example: `Southampton’ |
| Region | address.region |
User province, state, or region. Example: `Hampshire’ |
| Postal code | address.postal_code |
User post code. Example: 'SO99 9XX' |
| Country | address.country |
User country code. Example: 'UK'. Use 2-letter country codes, per the ISO 3166-1 alpha-2 standard. |
Implementar os campos no seu código
Configure o parâmetro "user_data" em cada campo a ser definido em todas as páginas onde você coleta dados do cliente.
Verificar um exemplo
O exemplo a seguir inclui nomes de variáveis para os dados do cliente. Verifique se os nomes das variáveis no seu código correspondem aos atributos no seu site. Por exemplo, se você armazenar e-mails em uma variável chamada "email_address", atualize o snippet com esse nome (por exemplo, yourEmailVariable).
Também é possível fixar o campo no código com uma string ou usar uma função em vez de variáveis.
// Implement
<script>
gtag('set', 'user_data', {
"email": yourEmailVariable, ***Mude yourEmailVariable para o nome da variável JavaScript em que você armazena os dados de e-mail do usuário. Faça o mesmo com as outras variáveis abaixo. Garanta que os valores não estejam criptografados com hash.
"phone_number": yourPhoneVariable,
"address": {
"first_name": yourFirstNameVariable,
"last_name": yourLastNameVariable,
"street": yourStreetAddressVariable,
"city":yourCityVariable,
"region": yourRegionVariable,
"postal_code": yourPostalCodeVariable,
"country": yourCountryVariable
}
});
</script>
O número de telefone 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.
Remover campos em branco
Se você não coleta alguns dos campos do exemplo de código anterior, não os deixe em branco, remova todos do código. O exemplo a seguir mostra como seria um site que coleta apenas endereços de e-mail e números de telefone:
<script>
gtag('set', 'user_data', {
"email": {{ yourEmailVariable }},
"phone_number": {{ yourPhoneVariable }}
});
</script>
Adicionar vários valores
É possível informar diversos valores (até três números de telefone, e-mails e dois endereços) usando uma matriz. Se você capturar mais de um valor, isso aumenta a probabilidade de uma correspondência.
gtag('set', 'user_data', {
"email": [yourEmailVariable1, yourEmailVariable2],
"phone_number": [yourPhoneVariable1, yourPhoneVariable2],
"address": [
{
{
]
});
</script>