Denne funktion er en del af en åben betaversion og kan blive ændret.
Denne vejledning er til administratorer og redaktører, der konfigurerer indsamling af brugergenererede data og gerne vil vide, hvordan de føjer et kodestykke til deres website ved hjælp af gtag.js. Opdatering af koden på dit website er med til at sikre, at mailadresser, telefonnumre og/eller navne og adresser er tilgængelige på siden, når Analytics indsamler brugergenererede data.
Oversigt
Hvis du vil opdatere din websitekode, skal du angive værdien user_data sammen med hvert enkelt felt til brugergenererede data i en hændelse, en config eller en set-kommando ved hjælp af funktionen gtag( ).
Hvis du overfører de samme data ved to eller flere kommandotyper (f.eks. event og config), tilsidesætter hændelseskommandoen config-kommandoen, og config-kommandoen tilsidesætter set-kommandoen. Få flere oplysninger om Google-taggets parameterrangfølge.
Du skal opdatere koden på alle sider, hvor du indsamler brugergenererede data, f.eks. en tilmeldingsside, en side til generering af kundeemner, en betalingsside eller lignende. Du kan sende dataene mere end én gang inden for en session for at sikre, at dataene sendes til Analytics.
Inden du går i gang
Denne vejledning tager udgangspunkt i, at du har følgende:
- Adgang til kildekoden på dit website
- Indsamling af brugergenererede data og tilladte brug af brugergenererede data er aktiveret
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. |
Implementering af felterne i din kode
Konfigurer parameteren user_data med hvert felt, du vil definere, på alle de sider, hvor du indsamler kundedata.
Se et eksempel
Følgende eksempel indeholder variabelnavne for kundedata. Sørg for, at variabelnavnene i din kode matcher attributterne på dit website. Hvis du f.eks. gemmer mailadresser i en variabel med navnet "email_address", skal du opdatere kodestykket med dette navn (f.eks. hvor der står yourEmailVariable).
Du kan lave fikseret kodning af feltet med en streng eller bruge en funktion i stedet for variabler.
// Implement
<script>
gtag('set', 'user_data', {
"email": yourEmailVariable, ***Rediger yourEmailVariable til navnet på den faktiske JavaScript-variable, hvor du gemmer brugerens maildata. Gør det samme for de andre nedenstående variabler. Sørg for, at værdierne ikke er hashkrypterede.
"phone_number": yourPhoneVariable,
"address": {
"first_name": yourFirstNameVariable,
"last_name": yourLastNameVariable,
"street": yourStreetAddressVariable,
"city":yourCityVariable,
"region": yourRegionVariable,
"postal_code": yourPostalCodeVariable,
"country": yourCountryVariable
}
});
</script>
Telefonnummeret skal være i E.164-format, hvilket betyder, at det skal være på 11 til 15 cifre, inklusive et plustegn (+) og en landekode, uden bindestreger, parenteser eller mellemrum.
Fjern tomme felter
Hvis du ikke indsamler visse felter fra den tidligere eksempelkode, skal du fjerne felterne helt fra koden i stedet for at lade dem være tomme. Følgende viser f.eks., hvordan et website, der kun indsamler mailadresser og telefonnumre, vil se ud:
<script>
gtag('set', 'user_data', {
"email": {{ yourEmailVariable }},
"phone_number": {{ yourPhoneVariable }}
});
</script>
Tilføj flere værdier
Du kan angive flere værdier (op til tre telefonnumre og mailadresser og to adresser) ved hjælp af en matrix. Hvis du registrerer mere end én værdi, øges sandsynligheden for et match.
gtag('set', 'user_data', {
"email": [yourEmailVariable1, yourEmailVariable2],
"phone_number": [yourPhoneVariable1, yourPhoneVariable2],
"address": [
{
{
]
});
</script>