Deze functie maakt deel uit van een open bèta en kan worden gewijzigd.
Deze instructies zijn bedoeld voor beheerders en bewerkers die verzameling van door gebruikers verstrekte gegevens instellen en willen weten hoe ze een codefragment aan hun website toevoegen met gtag.js. Als u de code op uw website updatet, zorgt u dat e-mailadressen, telefoonnummers en/of namen en adressen beschikbaar zijn op de pagina op het moment dat Analytics door gebruikers verstrekte gegevens verzamelt.
Overzicht
Als u uw websitecode wilt updaten, stelt u de waarde user_data en elk veld voor door gebruikers verstrekte gegevens in een event-, config- of set-opdracht in met de gtag( )-functie.
Als u dezelfde gegevens doorgeeft binnen 2 of meer opdrachttypen (bijvoorbeeld event en config), overschrijft de event-opdracht de config-opdracht en overschrijft de config-opdracht de set-opdracht. Meer informatie over de prioriteit van parameters in de Google-tag.
Update de code op alle pagina's waarop u door gebruikers verstrekte gegevens verzamelt, zoals een aanmeldingspagina, een pagina voor leads genereren of een betaalpagina. U kunt de gegevens meerdere keren binnen een sessie sturen om te zorgen dat de gegevens naar Analytics worden gestuurd.
Voordat u begint
In deze instructies wordt ervan uitgegaan dat u aan de volgende vereisten voldoet:
- U heeft toegang tot de broncode van uw website.
- U heeft verzameling van door gebruikers verstrekte gegevens geactiveerd en toestemming gegevens voor mogelijkheden voor door gebruikers verstrekte gegevens.
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. |
De velden in uw code implementeren
Stel op elke pagina waarop u klantgegevens verzamelt de parameter user_data in met elk veld dat u wilt definiëren.
Een voorbeeld bekijken
Het volgende voorbeeld bevat variabelenamen voor de klantgegevens. Zorg dat de variabelenamen in uw code overeenkomen met de kenmerken op uw website. Als u bijvoorbeeld e-mailadressen opslaat in een variabele met de naam 'email_address', updatet u het fragment met die naam (bijvoorbeeld waar uwE-mailVariabele staat).
U kunt het veld ook hardcoderen met een tekenreeks of een functie gebruiken in plaats van variabelen.
// Implement
<script>
gtag('set', 'user_data', {
"email": uwE-mailVariabele, ***Wijzig uwE-mailVariabele in de daadwerkelijke naam van de JavaScript-variabele waarin u de e-mailgegevens van de gebruiker opslaat. Pas voor de andere variabelen hieronder dezelfde benadering toe. Zorg dat de waarden niet zijn gehasht.
"phone_number": uwTelefoonVariabele,
"address": {
"first_name": uwVoornaamVariabele,
"last_name": uwAchternaamVariabele,
"street": uwAdresVariabele,
"city":uwPlaatsVariabele,
"region": uwRegioVariabele,
"postal_code": uwPostcodeVariabele,
"country": uwLandVariabele
}
});
</script>
Het telefoonnummer moet de E.164-indeling hebben, oftewel 11 tot 15 cijfers, inclusief een plusteken (+) als voorvoegsel en een landcode, zonder streepjes, haakjes of spaties.
Lege velden verwijderen
Als u bepaalde velden uit de vorige voorbeeldcode niet verzamelt, verwijdert u die velden helemaal uit de code in plaats van ze leeg te laten. Het volgende toont bijvoorbeeld hoe een website die alleen e-mailadressen en telefoonnummers verzamelt eruitziet:
<script>
gtag('set', 'user_data', {
"email": {{ uwE-mailVariabele }},
"phone_number": {{ uwTelefoonVariabele }}
});
</script>
Meerdere waarden toevoegen
U kunt meerdere waarden verstrekken (maximaal 3 telefoonnummers en e-mailadressen, en 2 adressen) met een reeks. Als u meer dan één waarde vastlegt, vergroot dit de kans op een match.
gtag('set', 'user_data', {
"email": [uwE-mailVariabele1, uwE-mailVariabele2],
"phone_number": [uwTelefoonVariabele1, uwTelefoonVariabele2],
"address": [
{
{
]
});
</script>