This feature is part of an open beta. Keep in mind that the feature is subject to change.
Estas instruções destinam-se a administradores e editores que estão a configurar a recolha de dados fornecidos pelos utilizadores e querem saber como adicionar um fragmento do código ao respetivo Website através da gtag.js. A atualização do código no seu Website ajuda a garantir que os endereços de email, os números de telefone e/ou os nomes e as moradas estão disponíveis na página quando o Analytics recolhe dados fornecidos pelos utilizadores.
Vista geral
Para atualizar o código do Website, tem de definir o valor user_data juntamente com cada campo de dados fornecidos pelos utilizadores num comando event, config ou set através da função gtag( ).
Se transmitir os mesmos dados em dois ou mais tipos de comandos (por exemplo, event e config), o comando event substitui o comando config e o comando config substitui o comando set. Saiba mais sobre a precedência de parâmetros da etiqueta Google.
Deve atualizar o código em todas as páginas onde recolhe dados fornecidos pelos utilizadores, como uma página de inscrição, uma página de geração de leads, uma página de pagamento ou algo semelhante. Pode enviar os dados mais do que uma vez numa sessão para garantir que são enviados para o Analytics.
Antes de começar
Estas instruções pressupõem que:
- Tem acesso ao código-fonte do seu Website
- Ativou a recolha de dados fornecidos pelos utilizadores e permitiu as capacidades de dados fornecidos pelos utilizadores
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
Em cada página onde recolhe dados de clientes, configure o parâmetro user_data com cada campo que queira definir.
Veja um exemplo
O exemplo seguinte inclui nomes de variáveis para os dados de clientes. Certifique-se de que os nomes das variáveis no código correspondem aos atributos do seu Website. Por exemplo, se armazenar o email numa variável denominada "email_address", deve atualizar o fragmento com essa denominação (por exemplo, onde aparece yourEmailVariable).
Também pode codificar o campo com uma string ou usar uma função em vez de usar variáveis.
// Implement
<script>
gtag('set', 'user_data', {
"email": yourEmailVariable, *** Altere yourEmailVariable para o nome real da variável JavaScript onde está a armazenar os dados de email do utilizador. Proceda do mesmo modo para as outras variáveis abaixo. Certifique-se de que os valores não têm 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 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.
Remova campos em branco
Se não recolher determinados campos do exemplo de código anterior, remova os campos por completo do código, em vez de os deixar em branco. Por exemplo, a imagem seguinte mostra o aspeto de um Website que recolhe apenas endereços de email e números de telefone:
<script>
gtag('set', 'user_data', {
"email": {{ yourEmailVariable }},
"phone_number": {{ yourPhoneVariable }}
});
</script>
Adicione vários valores
Pode fornecer vários valores (até 3 números de telefone e endereços de email, e 2 moradas) através de uma matriz. Se capturar mais de um valor, aumenta a probabilidade de uma correspondência.
gtag('set', 'user_data', {
"email": [yourEmailVariable1, yourEmailVariable2],
"phone_number": [yourPhoneVariable1, yourPhoneVariable2],
"address": [
{
{
]
});
</script>