This feature is part of an open beta. Keep in mind that the feature is subject to change.
Aceste instrucțiuni se adresează administratorilor și editorilor care doresc să afle cum să configureze fragmentul de cod pentru colectarea datelor oferite de utilizatori pe site-ul lor, folosind Google Manager de etichete.
Actualizarea codului, în comparație cu alte opțiuni de configurare, vă ajută să vă asigurați că adresele de e-mail, numerele de telefon și/sau numele și adresele sunt disponibile în pagină atunci când Analytics colectează date oferite de utilizatori.
Prezentare generală
Pentru a configura fragmentul de cod folosind Google Manager de etichete, parcurgeți următorii pași:
- identificați și definiți câmpurile de date oferite de utilizatori în codul site-ului;
- transmiteți la Google Analytics fiecare câmp de date oferite de utilizatori într-o variabilă JavaScript personalizată.
Notă: puteți trimite la Google Analytics date despre clienți indexate prin hashing sau neindexate prin hashing. Atunci când trimiteți date neindexate prin hashing, Google le va indexa prin hashing înainte să le stocheze pe serverele Google. Însă puteți și să indexați prin hashing datele înainte de a le trimite la Google.
Înainte de a începe
Aceste instrucțiuni presupun că:
- aveți acces la codul sursă al site-ului;
- ați activat colectarea datelor oferite de utilizatori și ați permis funcțiile pentru datele oferite de utilizatori;
- configurați o etichetă Google Analytics: eveniment GA4 în containerul Google Manager de etichete;
- aveți rolul de Administrator pentru proprietatea Google Analytics respectivă.
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. |
Actualizarea etichetei de eveniment cu o variabilă JavaScript personalizată
Înainte de a actualiza containerul Manager de etichete, aflați cum să actualizați codul JavaScript personalizat pe care îl veți adăuga în container.
- Conectați-vă la Google Manager de etichete.
- În fila Spațiu de lucru, dați clic pe Etichete în stânga.
- Deschideți eticheta Google Analytics: eveniment GA4 în care colectați date despre clienți. Asigurați-vă că eticheta de eveniment folosește codul de măsurare pentru fluxul web în care sunt colectate datele utilizatorilor.
- Selectați Includeți date oferite de utilizatori de pe site-ul dvs.
- În meniul drop-down Date despre utilizatori, selectați sau creați variabila Date oferite de utilizatori.
- În cazul în care creați o variabilă nouă, în variabila Date oferite de utilizatori, selectați Cod.
- În meniul drop-down Sursă de date, dați clic pe Variabilă nouă....
- Dați clic pe Configurarea variabilelor > JavaScript personalizată;
- Introduceți un nume pentru variabila JavaScript personalizată în partea de sus a paginii.
- În caseta text JavaScript personalizată, introduceți fragmentul de cod. Aflați cum.
- Salvați noile variabile, apoi salvați eticheta de eveniment.
- În dreapta sus, dați clic pe Trimiteți pentru a publica modificările.
Creați fragmentul de cod pentru a colecta datele oferite de utilizatori
Puteți folosi codul următor atunci când configurați variabila JavaScript personalizată la pasul 10:
function () {
return {
"email": yourEmailVariable , // înlocuiți yourEmailVariable cu numele variabilei care include adresa de e-mail a utilizatorului
"phone_number": yourPhoneVariable , // repetați acțiunea pentru yourPhoneVariable și numele de variabile de mai jos
"address": {
"first_name": yourFirstNameVariable ,
"last_name": yourLastNameVariable ,
"street": yourStreetAddressVariable ,
"city": yourCityVariable ,
"region": yourRegionVariable ,
"postal_code": yourPostalCodeVariable ,
"country": yourCountryVariable
}
}
}
Sau puteți să programați cu valori exacte câmpul cu un șir sau să folosiți o funcție în loc de variabile.
// Implementați
<script>
gtag('set', 'user_data', {"sha256_email_address": yourNormalizedandHashedEmailVariable,"sha256_phone_number": yourNormalizedandHashedPhoneVariable,"address": {"address.sha256_first_name": yourNormalizedandHashedFirstNameVariable,"address.sha256_last_name": yourNormalizedandHashedLastNameVariable,"city": yourCityVariable,"region": yourRegionVariable,"postal_code": yourPostalCodeVariable,"country": yourCountryVariable}
});
</script>Dacă doriți să trimiteți valori indexate prin hashing ale datelor utilizatorului, puteți folosi următorul fragment ca exemplu:
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;Numărul de telefon trebuie să fie în formatul E.164, adică trebuie să conțină între 11 și 15 cifre, inclusiv un prefix cu semnul plus (+) și un cod de țară fără cratime, paranteze sau spații.
Next steps
Validate that user-provided data collection is set up correctly. Show me how.