[GA4] Nastavitev fragmenta kode (Upravitelj oznak)

Ta funkcija je del odprte različice beta in se lahko spremeni.

Ta navodila so namenjena skrbnikom in urednikom, ki želijo izvedeti, kako z Google Upraviteljem oznak na spletnem mestu nastaviti fragment kode za zbiranje podatkov, ki jih posredujejo uporabniki.

S posodobitvijo kode (v primerjavi z drugimi možnostmi konfiguracije) je lažje zagotoviti, da bodo e-poštni naslovi, telefonske številke in/ali imena ter naslovi na voljo na strani, ko bo Analytics zbiral podatke, ki jih posredujejo uporabniki.

Pregled

Če želite nastaviti fragment kode z Google Upraviteljem oznak, upoštevajte ta navodila:

1. Prepoznajte in določite polja za podatke, ki jih posredujejo uporabniki, v kodi spletnega mesta.
2. Vsako polje s podatki, ki jih posredujejo uporabniki, posredujte v spremenljivki JavaScript po meri v Google Analytics.

Opomba: V Google Analytics lahko pošljete zgoščene ali nezgoščene podatke strank. Če pošljete nezgoščene podatke, Google samodejno zgosti podatke namesto vas, preden jih shrani v Googlove strežnike. Lahko pa tudi sami zgostite podatke, preden jih pošljete Googlu.

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.
• V vsebniku Google Upravitelja oznak nastavite oznako Google Analytics: Dogodek GA4.
• Vloga skrbnika za znamko 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.

Posodobitev oznake dogodka s spremenljivko JavaScript po meri

Preden posodobite vsebnik Upravitelja oznak, preberite, kako posodobite kodo JavaScript po meri, ki jo boste dodali v vsebnik.

1. Prijavite se v Google Upravitelja oznak.
2. Na zavihku Delovni prostor na levi kliknite Oznake.
3. Odprite oznako Google Analytics: Dogodek GA4, s katero zbirate podatke strank. Zagotovite, da oznaka dogodka uporablja ID meritve za spletni tok, v katerem se zbirajo podatki o uporabnikih.
4. Razširite razdelek Parametri dogodka in kliknite Dodaj parameter.
5. V polje »Parameter dogodka« vnesite user_data. 
6. V polju »Vrednost« izberite ali ustvarite spremenljivko za podatke, ki jih posredujejo uporabniki.
7. Če ustvarjate novo spremenljivko, v spremenljivki za podatke, ki jih posredujejo uporabniki, izberite Koda.

1. V spustnem meniju Podatkovni vir kliknite Nova spremenljivka ...
2. Kliknite Konfiguracija spremenljivke > JavaScript po meri.
3. Na vrhu strani vnesite ime za spremenljivko JavaScript po meri.
4. V besedilno polje JavaScript po meri vnesite fragment kode. Preberite več o tem.
5. Shranite nove spremenljivke in nato shranite oznako dogodka.
6. V zgornjem desnem kotu kliknite Pošlji, da objavite spremembe.

Ustvarjanje fragmenta kode za zbiranje podatkov, ki jih posredujejo uporabniki

Ko pri 10. koraku nastavljate spremenljivko JavaScript po meri, lahko uporabite to kodo:

function () {

return {

"email": yourEmailVariable , // spremenljivko SpremenljivkaE-poštnegaNaslova zamenjajte z imenom spremenljivke, ki zajame uporabnikov e-poštni naslov

"phone_number": yourPhoneVariable , // ponovite za spremenljivko SpremenljivkaTelefonskeŠtevilke in imena spremenljivk v nadaljevanju

"address": {

"first_name": yourFirstNameVariable ,

"last_name": yourLastNameVariable ,

"street": yourStreetAddressVariable ,

"city": yourCityVariable ,

"region": yourRegionVariable ,

"postal_code": yourPostalCodeVariable ,

"country": yourCountryVariable

}

}

}

Za vsako vrsto podatkov o uporabnikih v vzorcu kode zamenjajte nadomestne spremenljivke (npr. SpremenljivkaE-poštnegaNaslova) z imenom globalne spremenljivke JavaScript, ki vsebuje ta podatek. Če vaše spletno mesto ne zbira podatkov za katero od teh polj, tako polje raje v celoti odstranite, kot da ga pustite praznega.

Druga možnost je, da polje fiksno nastavite z nizom ali uporabite funkcijo, namesto da bi uporabili spremenljivke.

// Implement
<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>

Če želite navesti zgoščene vrednosti podatkov uporabnikov, lahko uporabite naslednji primer fragmenta:

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;

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.

Next steps

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