Esta función forma parte de una versión beta abierta y está sujeta a cambios.
Estas instrucciones son para los administradores y editores que configuran la recopilación de datos proporcionados por el usuario y desean obtener información para agregar un fragmento de código a su sitio web usando la etiqueta gtag.js. La actualización del código en tu sitio web ayuda a garantizar que las direcciones de correo electrónico, los números de teléfono o los nombres y las direcciones estén disponibles en la página cuando Analytics recopila datos proporcionados por el usuario.
Descripción general
Para actualizar el código de tu sitio web, debes establecer el valor user_data junto con cada campo de datos proporcionados por el usuario dentro de un comando event, config o set usando la función gtag( ).
Si pasas los mismos datos dentro de dos o más tipos de comandos (por ejemplo, event y config), el comando event anula el comando config y el comando config anula el comando set. Obtén información sobre la prioridad de los parámetros de la etiqueta de Google.
Debes actualizar el código en todas las páginas en las que recopiles datos proporcionados por el usuario, como la página de registro, de generación de clientes potenciales, de confirmación de compra o alguna similar. Puedes enviar los datos más de una vez durante una sesión para asegurarte de que se envíen a Analytics.
Antes de comenzar
En estas instrucciones, se da por sentado lo siguiente:
- Tienes acceso al código fuente de tu sitio web.
- Activaste la recopilación de datos proporcionados por el usuario y permitiste las funciones de datos proporcionados por el usuario.
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. |
Cómo implementar los campos en tu código
En cada página en la que recopiles datos de clientes, configura el parámetro user_data con los campos que desees definir.
Consulta un ejemplo
En el siguiente ejemplo, se incluyen nombres de variables para los datos del cliente. Asegúrate de que los nombres de las variables en tu código coincidan con los atributos en tu sitio web. Por ejemplo, si almacenas el correo electrónico en una variable llamada "email_address", debes actualizar el fragmento con ese nombre (por ejemplo, donde dice tuVariableCorreoElectrónico).
Nota: También puedes codificar el campo con una cadena o usar una función en lugar de usar variables.
// Implement
<script>
gtag('set', 'user_data', {
"email": tuVariableCorreoElectrónico, ***Cambia tuVariableCorreoElectrónico al nombre real de la variable de JavaScript donde almacenas los datos de correo electrónico del usuario. Haz lo mismo con las demás variables que aparecen a continuación. Asegúrate de que los valores no tengan codificación hash.
"phone_number": tuVariableTeléfono,
"address": {
"first_name": tuVariableNombre,
"last_name": tuVariableApellido,
"street": tuVariableDirección,
"city": tuVariableCiudad,
"region": tuVariableRegión,
"postal_code": tuVariableCódigoPostal,
"country": tuVariablePaís
}
});
</script>
El número de teléfono debe tener el formato E.164, es decir, debe tener entre 11 y 15 dígitos, incluidos un prefijo de signo más (+) y un código de país sin guiones, paréntesis ni espacios.
Quita los campos en blanco
Si no recopilas ciertos campos del código de muestra anterior, quita los campos del código por completo, en lugar de dejarlos en blanco. Por ejemplo, en el siguiente ejemplo, se muestra cómo se vería un sitio web que solo recopila direcciones de correo electrónico y números de teléfono:
<script>
gtag('set', 'user_data', {
"email": {{ tuVariableCorreoElectrónico }},
"phone_number": {{ tuVariableTeléfono }}
});
</script>
Agrega varios valores
Puedes proporcionar varios valores (hasta 3 números de teléfono y direcciones de correo electrónico, y 2 direcciones) con un array. Si capturas más de un valor, proporcionar esta información aumentará las probabilidades de obtener una coincidencia.
gtag('set', 'user_data', {
"email": [tuVariableCorreoElectrónico1, tuVariableCorreoElectrónico2],
"phone_number": [tuVariableTeléfono1, tuVariableTeléfono2],
"address": [
{
{
]
});
</script>