Ta funkcija je del odprte različice beta in se lahko spremeni.
Ta navodila so namenjena skrbnikom in urednikom, ki nastavljajo zbiranje podatkov, ki jih posredujejo uporabniki, in želijo izvedeti, kako s kodo gtag.js dodati fragment kode na spletno mesto. Če posodobite kodo na svojem spletnem mestu, boste zagotovili, da bodo na strani na voljo e-poštni naslovi, telefonske številke in/ali imena ter naslovi, ko bo Analytics zbiral podatke, ki jih posredujejo uporabniki,.
Pregled
Če želite posodobiti kodo spletnega mesta, morate s funkcijo gtag( ) nastaviti vrednost »user_data« skupaj z vsakim poljem za podatke, ki jih posredujejo uporabniki, v okviru ukaza »event«, »config« ali »set«.
Če iste podatke posredujete v dveh ali več vrstah ukazov (na primer »event« in »config«), ukaz »event« preglasi ukaz »config«, ukaz »config« pa preglasi ukaz »set«. Preberite več o prednosti parametra Googlove oznake.
Kodo posodobite na vseh straneh, na katerih zbirate podatke, ki jih posredujejo uporabniki, kot so stran za prijavo, stran za pridobivanje potencialnih strank, stran za zaključek nakupa in podobne. Podatke lahko pošljete več kot enkrat v okviru ene seje, da zagotovite, da bodo poslani v Analytics.
Preden začnete
V teh navodilih predpostavljamo, da imate naslednje:
- dostop do izvorne kode spletnega mesta;
- aktivirano zbiranje podatkov, ki jih posredujejo uporabniki, in omogočene zmožnosti v zvezi s podatki, ki jih posredujejo uporabniki.
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. |
Implementacija polj v kodi
Na vsaki strani, na kateri zbirate podatke strank, konfigurirajte parameter »user_data« za vsako polje, ki ga želite določiti.
Primer
Naslednji vzorec vključuje imena spremenljivk za podatke strank. Poskrbite, da se bodo imena spremenljivk v vaši kodi ujemala z atributi na vašem spletnem mestu. Če na primer e-poštni naslov shranite v spremenljivko z imenom »email_address«, morate fragment posodobiti s tem imenom (npr. kjer je niz SpremenljivkaE-poštnegaNaslova).
Polje lahko tudi fiksno nastavite z nizom ali uporabite funkcijo, namesto da bi uporabili spremenljivke.
// Implement
<script>
gtag('set', 'user_data', {
"email": SpremenljivkaE-poštnegaNaslova, ***Spremenite SpremenljivkaE-poštnegaNaslova v dejansko ime spremenljivke JavaScript, v kateri shranjujete e-poštne podatke uporabnika. Enako storite tudi za druge spremenljivke spodaj. Zagotovite, da vrednosti niso zgoščene.
"phone_number": SpremenljivkaTelefonskeŠtevilke,
"address": {
"first_name": SpremenljivkaImena,
"last_name": SpremenljivkaPriimka,
"street": SpremenljivkaUličnegaNaslova,
"city":SpremenljivkaKraja,
"region": SpremenljivkaRegije,
"postal_code": SpremenljivkaPoštneŠtevilke,
"country": SpremenljivkaDržave
}
});
</script>
Telefonska številka mora biti v obliki E.164, kar pomeni, da mora imeti od 11 do 15 števk, vključno s predpono z znakom plus (+) in klicno številko države, brez pomišljajev, oklepajev ali presledkov.
Odstranitev praznih polj
Če ne zbirate določenih polj iz prejšnje vzorčne kode, polja raje v celoti odstranite iz kode, namesto da bi jih pustili prazna. Primer: Spodaj je prikazano, kako bi bilo videti spletno mesto, ki zbira samo e-poštne naslove in telefonske številke:
<script>
gtag('set', 'user_data', {
"email": {{ SpremenljivkaE-poštnegaNaslova }},
"phone_number": {{ SpremenljivkaTelefonskeŠtevilke }}
});
</script>
Dodajanje več vrednosti
Z matriko lahko vnesete več vrednosti (do 3 telefonske številke in e-poštne naslove ter 2 naslova). Če je zajeta več kot ena vrednost, se s tem poveča verjetnost ujemanja.
gtag('set', 'user_data', {
"email": [SpremenljivkaE-poštnegaNaslova1, SpremenljivkaE-poštnegaNaslova2],
"phone_number": [SpremenljivkaTelefonskeŠtevilke1, SpremenljivkaTelefonskeŠtevilke2],
"address": [
{
{
]
});
</script>