This feature is part of an open beta. Keep in mind that the feature is subject to change.
Diese Anleitung richtet sich an Administratoren und Bearbeiter, die mithilfe von gtag.js ein Code-Snippet auf ihrer Website einfügen möchten, um die Erhebung der von Nutzern bereitgestellten Daten einzurichten. Die Aktualisierung Ihres Codes trägt dazu bei, dass E-Mail-Adressen, Telefonnummern und/oder Namen und Adressen auf der Seite verfügbar sind, wenn von Nutzern bereitgestellte Daten in Analytics erhoben werden.
Überblick
Wenn Sie den Websitecode aktualisieren möchten, müssen Sie den „user_data“-Wert zusammen mit jedem Feld mit von Nutzern bereitgestellten Daten innerhalb eines „event“-, „config“- oder „set“-Befehls mit der Funktion „gtag( )“ festlegen.
Wenn Sie dieselben Daten mit zwei oder mehr Befehlstypen übergeben (z. B. „event“ und „config“), überschreibt der Befehl „event“ den Befehl „config“ und der Befehl „config“ den Befehl „set“. Weitere Informationen zur Parameterpriorität
Sie sollten den Code auf allen Seiten aktualisieren, auf denen Sie von Nutzern bereitgestellte Daten erheben, z. B. auf der Anmeldeseite, Seiten zur Lead-Generierung oder der Zahlungsseite. Sie können die Daten innerhalb einer Sitzung mehrmals senden, damit sie auch wirklich bei Analytics eingehen.
Hinweis
In dieser Anleitung wird Folgendes vorausgesetzt:
- Sie haben Zugriff auf den Quellcode Ihrer Website.
- Die Erhebung der von Nutzern bereitgestellten Daten und „Funktionen für von Nutzern bereitgestellte Daten zulassen“ sind aktiviert.
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. |
Felder in Ihren Code implementieren
Konfigurieren Sie auf jeder Seite, auf der Sie Kundendaten erheben, den Parameter „user_data“ mit jedem Feld, das Sie definieren möchten.
Beispiel
Das folgende Beispiel enthält Variablennamen für die Kundendaten. Die Variablennamen im Code müssen mit denen der Attribute auf Ihrer Website übereinstimmen. Wenn Sie die E-Mail-Adresse beispielsweise in einer Variable namens „email_adresse“ speichern, passen Sie das Snippet entsprechend an (in diesem Fall etwa die Variable E-Mail_Variable).
Sie können das Feld auch mit einem String hartcodieren oder eine Funktion anstelle von Variablen verwenden.
// Implementieren Sie
<script>
gtag('set', 'user_data', {
"email": E-Mail_Variable, ***Geben Sie anstelle von E-Mail_Variable den Namen der Javascript-Variable an, in der Sie die E-Mail-Adresse des Nutzers speichern. Wiederholen Sie diesen Schritt für alle nachfolgenden Variablen. Die Werte dürfen nicht gehasht sein.
"phone_number": Telefonnummer_Variable,
"address": {
"first_name": Vorname_Variable,
"last_name": Nachname_Variable,
"street": Adresse_Variable,
"city":Ort_Variable,
"region": Region_Variable,
"postal_code": PLZ_Variable,
"country": Land_Variable
}
});
</script>
Die Telefonnummer muss gemäß Richtlinie E.164 formatiert sein, also 11 bis 15 Zeichen lang sein, einschließlich eines Pluszeichens (+) und eines Ländercodes ohne Bindestriche, Klammern oder Leerzeichen.
Leere Felder entfernen
Wenn Sie bestimmte Felder aus dem Beispielcode oben nicht erfassen, lassen Sie sie nicht leer, sondern entfernen Sie sie vollständig aus dem Code. Hier ist ein Beispiel für den Code einer Website, auf der nur E-Mail-Adressen und Telefonnummern erfasst werden:
<script>
gtag('set', 'user_data', {
"email": {{ E-Mail_Variable }},
"phone_number": {{ Telefonnummer_Variable }}
});
</script>
Mehrere Werte hinzufügen
Mit einem Array können Sie mehrere Werte angeben (bis zu drei Telefonnummern und E-Mail-Adressen und zwei Adressen). Wenn Sie mehr als einen Wert erfassen, steigt dann die Wahrscheinlichkeit einer Übereinstimmung.
gtag('set', 'user_data', {
"email": [E-Mail_Variable1, E-Mail_Variable2],
"phone_number": [Telefonnummer_Variable1, Telefonnummer_Variable2],
"address": [
{
{
]
});
</script>