Denne funksjonen er en del av en åpen betaversjon og kan endres.
Denne veiledningen er beregnet på administratorer og redigerere som skal konfigurere innsamling av data fra brukere, og som ønsker å finne ut hvordan de kan legge til en kodebit på nettstedet sitt ved hjelp av gtag.js. Ved å oppdatere koden på nettstedet ditt sikrer du at e-postadresser, telefonnumre og/eller navn og adresser er tilgjengelige på siden når Analytics samler inn data fra brukere.
Oversikt
For å oppdatere koden på nettstedet ditt må du angi «user_data»-verdien sammen med hvert felt for data fra brukere i en event-, config- eller set-kommando via gtag( )-funksjonen.
Hvis du overfører de samme dataene i to eller flere kommandotyper (f.eks. «event» og «config»), overstyrer «event»-kommandoen «config»-kommandoen, mens «config»-kommandoen overstyrer «set»-kommandoen. Finn ut mer om parameterprioritet for Google-taggen.
Du bør oppdatere koden på alle sider der du samler inn data fra brukere, for eksempel registreringssider, betalingssider eller sider for generering av potensielle salg. Du kan sende dataene mer enn én gang i løpet av en økt for å være sikker på at de blir sendt til Analytics.
Før du begynner
Disse instruksjonene forutsetter at du har
- tilgang til kildekoden på nettstedet ditt
- aktivert og tillatt innsamling av data fra brukere
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: ‘[email protected]’ |
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. |
Implementering av feltene i koden
Konfigurer «user_data»-parameteren sammen med hvert felt du vil definere, på alle sidene der du samler inn kundedata.
Se et eksempel
Eksempelet nedenfor inneholder variabelnavn for kundedataene. Påse at variabelnavnene i koden samsvarer med attributtene på nettstedet ditt. Hvis du for eksempel lagrer e-postadresser i en variabel med navnet «email_address», må du oppdatere kodebiten ved å legge inn dette navnet (f.eks. der det står yourEmailVariable).
Du kan også hardkode feltet med en streng eller bruke en funksjon i stedet for variabler.
// Implementer
<script>
gtag('set', 'user_data', {
"email": yourEmailVariable, ***Endre yourEmailVariable til det faktiske navnet på JavaScript-variabelen der du lagrer brukerens e-postadresse. Følg den samme fremgangsmåten for de andre variablene nedenfor. Sørg for at verdiene ikke er hashet.
"phone_number": yourPhoneVariable,
"address": {
"first_name": yourFirstNameVariable,
"last_name": yourLastNameVariable,
"street": yourStreetAddressVariable,
"city":yourCityVariable,
"region": yourRegionVariable,
"postal_code": yourPostalCodeVariable,
"country": yourCountryVariable
}
});
</script>
Telefonnummeret må være i E.164-format, dvs. det må bestå av 11–15 sifre, inkludert et foranstilt plusstegn (+) og en landskode uten bindestreker, parenteser eller mellomrom.
Fjern tomme felt
Hvis det er enkelte felt du ikke samler inn fra den forrige eksempelkoden, bør du heller fjerne feltene helt fra koden enn å la dem stå tomme. Nedenfor ser du et eksempel på hvordan koden ser ut for et nettsted som bare samler inn e-postadresser og telefonnumre:
<script>
gtag('set', 'user_data', {
"email": {{ yourEmailVariable }},
"phone_number": {{ yourPhoneVariable }}
});
</script>
Legg til flere verdier
Du kan oppgi flere verdier (opptil tre telefonnumre og e-postadresser samt to adresser) ved hjelp av en matrise. Hvis du registrerer flere verdier, øker sannsynligheten for at det kan etableres samsvar.
gtag('set', 'user_data', {
"email": [yourEmailVariable1, yourEmailVariable2],
"phone_number": [yourPhoneVariable1, yourPhoneVariable2],
"address": [
{
{
]
});
</script>