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 configurează colectarea datelor oferite de utilizatori și doresc să afle cum să adauge un fragment de cod pe site folosind gtag.js. Prin actualizarea codului site-ului, 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 actualiza codul site-ului, trebuie să setați valoarea user_data împreună cu fiecare câmp pentru datele oferite de utilizatori dintr-o comandă event, config sau set, folosind funcția gtag( ).
Dacă transmiteți aceleași date prin două sau mai multe tipuri de comenzi (de exemplu, event și config), comanda event va înlocui comanda config, iar comanda config va înlocui comanda set. Aflați mai multe despre prioritatea parametrilor etichetei Google.
Trebuie să actualizați codul în toate paginile unde colectați date oferite de utilizatori, de exemplu, o pagină de înscriere, o pagină de generare a clienților potențiali, o pagină de finalizare a achiziției sau altele similare. Puteți trimite datele de mai multe ori în cadrul unei sesiuni, pentru a vă asigura că sunt trimise la Analytics.
Î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.
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. |
Implementarea câmpurilor în cod
În fiecare pagină unde colectați date despre clienți, configurați parametrul user_data pentru fiecare câmp pe care doriți să îl definiți.
Vedeți un exemplu
Următorul exemplu include nume de variabile pentru datele despre clienți. Asigurați-vă că numele variabilelor din cod corespund atributelor de pe site. De exemplu, dacă stocați adrese de e-mail într-o variabilă numită email_address, trebuie să actualizați fragmentul cu numele respectiv (de exemplu, acolo unde apare yourEmailVariable).
În plus, puteți să programați cu valori exacte câmpul folosind un șir sau să folosiți o funcție în loc de variabile.
// Implementați
<script>
gtag('set', 'user_data', {
"email": yourEmailVariable, ***Înlocuiți yourEmailVariable cu numele variabilei JavaScript reale în care stocați datele despre adresele de e-mail ale utilizatorilor. Procedați la fel pentru celelalte variabile de mai jos. Asigurați-vă că valorile nu sunt indexate prin hashing.
"phone_number": yourPhoneVariable,
"address": {
"first_name": yourFirstNameVariable,
"last_name": yourLastNameVariable,
"street": yourStreetAddressVariable,
"city":yourCityVariable,
"region": yourRegionVariable,
"postal_code": yourPostalCodeVariable,
"country": yourCountryVariable
}
});
</script>
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.
Eliminați câmpurile necompletate
Dacă nu colectați anumite câmpuri din exemplul de cod anterior, eliminați complet câmpurile din cod în loc să le lăsați necompletate. De exemplu, iată cum ar arăta un site care colectează numai adrese de e-mail și numere de telefon:
<script>
gtag('set', 'user_data', {
"email": {{ yourEmailVariable }},
"phone_number": {{ yourPhoneVariable }}
});
</script>
Adăugați mai multe valori
Puteți trimite mai multe valori (până la trei numere de telefon și adrese de e-mail și două adrese) folosind un vector. Dacă înregistrați mai multe valori, această acțiune va crește șansele de potrivire.
gtag('set', 'user_data', {
"email": [yourEmailVariable1, yourEmailVariable2],
"phone_number": [yourPhoneVariable1, yourPhoneVariable2],
"address": [
{
{
]
});
</script>