This feature is part of an open beta. Keep in mind that the feature is subject to change.
Estas instrucciones están dirigidas a los administradores y editores que van a configurar la recogida de datos proporcionados por los usuarios y quieren aprender cómo añadir un fragmento de código a su sitio web con gtag.js. Actualizar el código de su sitio web le permite asegurarse de que las direcciones de correo electrónico y los números de teléfono o los nombres y las direcciones postales estén disponibles en la página cuando Analytics recoja los datos proporcionados por los usuarios.
Introducción
Para actualizar el código de su sitio web, debe definir el valor user_data junto con cada campo de datos proporcionados por los usuarios de un comando event, config o set mediante la función gtag( ).
Si envía los mismos datos en dos o más tipos de comandos (por ejemplo, event y config), el comando event anulará el comando config, y el comando config anulará el comando set. Más información sobre la prioridad de los parámetros de la etiqueta de Google
Debe actualizar el código en todas las páginas en las que recoja datos proporcionados por los usuarios; por ejemplo, una página de registro, de generación de oportunidades de venta, de tramitación de la compra u otra similar. Puede enviar los datos más de una vez en una sesión para asegurarse de que se mandan a Analytics.
Antes de empezar
En estas instrucciones se presupone lo siguiente:
- Tiene acceso al código fuente de su sitio web.
- Ha activado la recogida de datos proporcionados por los usuarios y ha permitido las funciones de datos proporcionados por los usuarios.
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 los campos en el código
En cada página en la que recoja datos de clientes, configure el parámetro user_data con cada campo que quiera definir.
Ver un ejemplo
En el siguiente ejemplo se incluyen nombres de variables para los datos de clientes. Asegúrese de que los nombres de las variables de su código coincidan con los atributos de su sitio web. Por ejemplo, si almacena la dirección de correo en una variable denominada "email_address", deberá modificar el fragmento con ese nombre (en este caso, en suVariableDirecciónCorreo).
También puede codificar el campo de tipo cadena o usar una función en lugar de variables.
// Implement
<script>
gtag('set', 'user_data', {
"email": suVariableDirecciónCorreo, ***Cambie suVariableDirecciónCorreo por el nombre de la variable de JavaScript donde almacena los datos de la dirección de correo de los usuarios. Haga lo mismo con las demás variables que se indican a continuación. Asegúrese de que los valores no estén cifrados con hash.
"phone_number": yourPhoneVariable,
"address": {
"first_name": suVariableNombre,
"last_name": suVariableApellidos,
"street": suVariableDirecciónPostal,
"city": suVariableCiudad,
"region": suVariableRegión,
"postal_code": suVariableCódigoPostal,
"country": suVariablePaís
}
});
</script>
El número de teléfono debe estar en formato E.164, lo que significa que debe tener entre 11 y 15 dígitos e incluir un prefijo con el signo más (+) y el código de país sin guiones, paréntesis ni espacios.
Eliminar campos en blanco
Si no recoge determinados campos del código de muestra anterior, elimínelos en lugar de dejarlos en blanco. Por ejemplo, el siguiente código muestra el aspecto de un sitio web en el que solo se recogen direcciones de correo y números de teléfono:
<script>
gtag('set', 'user_data', {
"email": {{ suVariableDirecciónCorreo }},
"phone_number": {{ suVariableNúmeroTeléfono }}
});
</script>
Añadir varios valores
Puede proporcionar varios valores (hasta tres números de teléfono y direcciones de correo, y dos direcciones postales) mediante un array. Si recoge más de un valor, será más probable que haya concordancias.
gtag('set', 'user_data', {
"email": [suVariableDirecciónCorreo1, suVariableDirecciónCorreo2],
"phone_number": [suVariableNúmeroTeléfono1, suVariableNúmeroTeléfono2],
"address": [
{
{
]
});
</script>