Configurar el fragment de codi (Tag Manager)

Aquesta funció forma part d'una versió beta oberta i està subjecta a canvis.

Aquestes instruccions són per als administradors i editors que volen obtenir informació sobre com poden configurar el fragment de codi per a la recollida de dades proporcionades per l'usuari al seu lloc web mitjançant Google Tag Manager.

Actualitzar el codi, en comparació amb les altres opcions de configuració, ajuda a garantir que les adreces electròniques, els números de telèfon o els noms i les adreces postals estiguin disponibles a la pàgina quan Analytics recull dades proporcionades per l'usuari.

Informació general

Per configurar el fragment de codi mitjançant Google Tag Manager, seguiu aquests passos:

1. Identifiqueu i definiu els camps de dades proporcionades per l'usuari al codi del lloc web
2. Transferiu a Google Analytics cada camp de dades proporcionades per l'usuari d'una variable JavaScript personalitzada

Nota: podeu enviar a Google Analytics dades de client xifrades amb la funció resum o no xifrades. Quan envieu dades que no estan xifrades amb la funció resum, Google hi aplica la funció resum en nom vostre abans d'emmagatzemar-les als servidors de Google. També podeu aplicar la funció resum a les dades abans d'enviar-les a Google.

Abans de començar

Aquestes instruccions pressuposen que:

• Teniu accés al codi font del lloc web.
• Heu activat la recollida de dades proporcionades per l'usuari i permès les capacitats de dades proporcionades per l'usuari.
• Heu configurat una etiqueta de Google Analytics: esdeveniment de Google Analytics al contenidor de Google Tag Manager.
• Teniu la funció d'administrador a la propietat de Google Analytics.

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: ‘[e-mail]’
	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: ‘[phone]’
	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.

Actualitzar l'etiqueta d'esdeveniment amb una variable de JavaScript personalitzada

Abans d'actualitzar el contenidor de Tag Manager, obteniu informació sobre com podeu actualitzar el codi JavaScript personalitzat que afegireu al contenidor.

1. Inicieu la sessió a Google Tag Manager.
2. A la pestanya Àrea de treball, feu clic a Etiquetes, a l'esquerra.
3. Obriu l'etiqueta Google Analytics: esdeveniment de Google Analytics on recolliu dades de client. Assegureu-vos que l'etiqueta d'esdeveniment utilitzi l'identificador de mesurament per al flux web en què es recullen les dades d'usuari.
4. Desplegueu la secció Paràmetres d'esdeveniment i feu clic a Afegeix un paràmetre.
5. Introduïu user_data al camp "Paràmetre d'esdeveniment".
6. Al camp "Valor", seleccioneu o creeu una variable de dades proporcionades per l'usuari.
7. Si voleu crear una variable nova, a la variable de dades proporcionades per l'usuari, seleccioneu Codi.

1. Al menú desplegable Font de dades, feu clic a Variable nova....
2. Feu clic a Configuració de la variable > JavaScript personalitzada.
3. A la part superior de la pàgina, introduïu un nom per a la variable de JavaScript personalitzada.
4. Al quadre de text JavaScript personalitzada, introduïu el fragment de codi. Obteniu informació.
5. Deseu les variables noves i, tot seguit, deseu l'etiqueta d'esdeveniment.
6. A la part superior dreta, feu clic a Envia per publicar els canvis.

Crear el fragment de codi per recollir dades proporcionades per l'usuari

Podeu utilitzar el codi següent quan configureu la variable de JavaScript personalitzada al pas 10:

function () {

return {

"email": yourEmailVariable , // substituïu VariableAdreçaElectrònica pel nom de la variable que capturi l'adreça electrònica de l'usuari

"phone_number": yourPhoneVariable , // repetiu el pas per a VariableTelèfon i els noms de variable següents

"address": {

"first_name": yourFirstNameVariable ,

"last_name": yourLastNameVariable ,

"street": yourStreetAddressVariable,

"city": yourCityVariable,

"region": yourRegionVariable,

"postal_code": yourPostalCodeVariable,

"country": yourCountryVariable

}

}

}

Per a cada tipus de dades d'usuari del codi d'exemple, substituïu les variables d'espai reservat (com ara VariableAdreçaElectrònica) pel nom de la variable global de JavaScript que conté la dada en qüestió. Si el lloc web no recull algun d'aquests camps, traieu el camp del tot; no el deixeu en blanc.

També podeu codificar el camp amb una cadena o utilitzar una funció en comptes d'utilitzar variables.

// Implement
<script>
gtag('set', 'user_data', {
"sha256_email_address": VariableAdreçaElectrònicaNormalitzadaXifrada
"sha256_phone_number": VariableTelèfonNormalitzadaXifrada
"address": {
"address.sha256_first_name": VariableNomNormalitzadaXifrada,
"address.sha256_last_name": VariableCognomsNormalitzadaXifrada,
"city": VariableCiutat,
"region": VariableRegió,
"postal_code": VariableCodiPostal,
"country": VariablePaís
}
});
</script>

Si voleu proporcionar valors de dades d'usuari xifrades amb la funció resum, podeu utilitzar el fragment d'exemple següent:

async function processUserData() {
const userData = {
'sha256_email_address': await hashEmail(email.trim()),
'sha256_phone_number': await hashPhoneNumber(phoneNumber),
'address': {
'address.sha256_first_name': await hashName(firstName),
'address.sha256_last_name': await hashName(lastName),
'city': city,
'region': region,
'postal_code': postalCode,
'country': country,
},
};
return userData;

El número de telèfon ha de tenir el format E.164, és a dir, entre 11 i 15 dígits, un prefix de signe més (+) i un codi de país, sense guions, parèntesis ni espais.

Next steps

Validate that user-provided data collection is set up correctly. Show me how.