Al igual que con gtag, puedes usar el Protocolo de medición de Google Analytics para enviar datos proporcionados por el usuario junto con el User-ID, que se puede usar para mejorar la medición del comportamiento y las conversiones.
Para enviar datos proporcionados por el usuario junto con una solicitud del Protocolo de medición, agrega el parámetro user_data en la carga útil de JSON. Te recomendamos que también incluyas el parámetro user_id cada vez que se proporcione user_data. Esto ayuda a garantizar la medición más precisa y la funcionalidad de las funciones.
El Measurement Protocol usa el mismo algoritmo de normalización y hash
que la
función de medición mejorada de la API de Google Ads.
Por inquietudes sobre la privacidad, las direcciones de correo electrónico, los números de teléfono, los nombres, los apellidos, y las direcciones postales deben utilizar la codificación con hash con el SHA-256 algoritmo antes de subirse. El valor con codificación hash debe codificarse en formato de cadena hexadecimal (objeto de cadena que contiene solo dígitos hexadecimales), como 88d7ecb5c5b21d7b1.
Para estandarizar los resultados del hash, debes hacer lo siguiente antes de generar un hash para uno de estos valores:
- Quita los espacios en blanco iniciales y finales.
- Convierte el texto a minúsculas.
- Escribe el número de teléfono con el formato estándar E164.
- Quita todos los puntos (.) que anteceden al nombre de dominio en las direcciones de correo electrónico
gmail.comygooglemail.com.
Cuerpo de la publicación JSON
| Clave | Tipo | Descripción |
|---|---|---|
| user_id (opcional, pero se recomienda) | string | Un identificador único para un usuario. Consulta User-ID para el análisis multiplataforma para obtener más información sobre este identificador. |
| user_data | objeto | Campos de datos de usuario mejorados que identifican a un usuario. |
| user_data.sha256_email_address[] | array de cadenas | Dirección de correo electrónico del usuario con codificación hash.
Se normaliza de la siguiente manera:
|
| user_data.sha256_phone_number[] | array de cadenas | Número de teléfono del usuario con codificación hash.
Se normaliza de la siguiente manera:
|
| user_data.address[] | array | Identifica a un usuario según su ubicación física. |
| user_data.address[].sha256_first_name | string | Nombre del usuario con codificación hash.
Se normaliza de la siguiente manera:
|
| user_data.address[].sha256_last_name | string | Apellido del usuario con codificación hash.
Se normaliza de la siguiente manera:
|
| user_data.address[].sha256_street | string | Calle y número del usuario con codificación hash.
Se normaliza de la siguiente manera:
|
| user_data.address[].city | string | Ciudad de la dirección del usuario.
Se normaliza de la siguiente manera:
|
| user_data.address[].region | string | Estado o territorio de la dirección del usuario.
Se normaliza de la siguiente manera:
|
| user_data.address[].postal_code | string | Código postal de la dirección del usuario.
Se normaliza de la siguiente manera:
|
| user_data.address[].country | string | Código de país de la dirección del usuario. Tiene el formato del estándar ISO 3166-1 alfa-2. |
Consulta la documentación de referencia del Protocolo de medición para obtener más información sobre el formato del transporte y la carga útil.
Envía datos proporcionados por el usuario
A diferencia de gtag, que genera automáticamente el hash de los datos sensibles proporcionados por el usuario, el Protocolo de medición requiere que un desarrollador genere el hash de los datos sensibles proporcionados por el usuario con un algoritmo de hash unidireccional seguro llamado SHA256 y que los codifique con formato de cadena hexadecimal antes de llamar a la API.
Todos los campos de datos del usuario que comiencen con el prefijo sha256 en su nombre solo deben completarse con valores con codificación hash y hexadecimal.
En el siguiente código de ejemplo, se realizan los pasos de encriptación y codificación necesarios:
Node.js
const { subtle } = require('crypto').webcrypto;
async function populateSensitiveUserData(value) {
const encoder = new TextEncoder();
// Convert a string value to UTF-8 encoded text.
const valueUtf8 = encoder.encode(value);
// Compute the hash (digest) using the SHA-256 algorithm.
const hashSha256 = await subtle.digest('SHA-256', valueUtf8);
// Convert buffer to byte array.
const hashArray = Array.from(new Uint8Array(hashSha256));
// Return a hex-encoded string.
return hashArray.map(b => b.toString(16).padStart(2, "0")).join('');
};
// Test the encryption function by calling it.
async function main() {
return await populateSensitiveUserData('<value>');
}
main()
.then(v => console.log(v))
.catch(err => console.error(err));
Como atajo conveniente, todos los campos repetidos dentro del objeto user_data
(como address, sha256_email_address, sha256_phone_number) pueden
pasar un valor singular en lugar de un array.
En el siguiente código de muestra, se llama al Measurement Protocol y se pasan los datos del usuario junto con el User-ID.
Node.js
const measurementId = "MEASUREMENT_ID";
const apiSecret = "API_SECRET";
// Populate mock User Data using the `populateSensitiveUserData` function defined
// above.
const yourEmailSha256Variable = await populateSensitiveUserData('test@yourdomain.com');
const yourPhoneSha256Variable = await populateSensitiveUserData('+15555555555');
const yourFirstNameSha256Variable = await populateSensitiveUserData('john');
const yourLastNameSha256Variable = await populateSensitiveUserData('doe');
const yourStreetAddressSha256Variable = await populateSensitiveUserData('123 main street');
// Populate mock unencrypted user data.
const yourCityVariable = 'san francisco';
const yourRegionVariable = 'california';
const yourPostalCodeVariable = '94000';
const yourCountryVariable = 'US';
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
client_id: "CLIENT_ID",
user_id: "USER_ID",
events: [{
name: "purchase"
}],
user_data: {
sha256_email_address: yourEmailSha256Variable,
sha256_phone_number: yourPhoneSha256Variable,
address: {
sha256_first_name: yourFirstNameSha256Variable,
sha256_last_name: yourLastNameSha256Variable,
sha256_street: yourStreetAddressSha256Variable,
city: yourCityVariable,
region: yourRegionVariable,
postal_code: yourPostalCodeVariable,
country: yourCountryVariable
}
}
})
});
Varios valores
De forma opcional, los desarrolladores pueden proporcionar varios valores (hasta 3 para el teléfono y el correo electrónico y 2 para la dirección) mediante un valor de array en lugar de una cadena. Si capturas más de un valor, proporcionar esta información aumentará las probabilidades de obtener una coincidencia.
Node.js
const measurementId = "MEASUREMENT_ID";
const apiSecret = "API_SECRET";
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
client_id: "CLIENT_ID",
user_id: "USER_ID",
events: [{
name: "purchase"
}],
user_data: {
sha256_email_address: [yourEmailSha256Variable1, yourEmailSha256Variable2],
sha256_phone_number: [yourPhoneSha256Variable1, yourPhoneSha256Variable2],
address: [{
sha256_first_name: yourFirstNameSha256Variable1,
sha256_last_name: yourLastNameSha256Variable1,
sha256_street: yourStreetAddressSha256Variable1,
city: yourCityVariable1,
region: yourRegionVariable1,
postal_code: yourPostalCodeVariable1,
country: yourCountryVariable1
},{
sha256_first_name: yourFirstNameSha256Variable2,
sha256_last_name: yourLastNameSha256Variable2,
sha256_street: yourStreetAddressSha256Variable2,
city: yourCityVariable2,
region: yourRegionVariable2,
postal_code: yourPostalCodeVariable2,
country: yourCountryVariable2
}]
}
})
});