[GA4] Code-Snippet einrichten (Tag Manager)

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 das Code-Snippet für die Erhebung der von Nutzern bereitgestellten Daten mit Google Tag Manager auf ihrer Website einrichten möchten.

Die Aktualisierung Ihres Codes trägt im Vergleich zu den anderen Konfigurationsoptionen 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

So richten Sie das Code-Snippet mit Google Tag Manager ein:

  1. Felder mit von Nutzern bereitgestellten Daten im Websitecode identifizieren und definieren
  2. Jedes Feld mit von Nutzern bereitgestellten Daten in einer benutzerdefinierten JavaScript-Variable an Google Analytics übergeben

Hinweis: Sie können gehashte oder nicht gehashte Kundendaten an Google Analytics senden. Wenn Sie nicht gehashte Daten senden, werden sie von Google gehasht, bevor sie auf den Google-Servern gespeichert werden. Sie können die Daten aber auch selbst hashen, bevor Sie sie an Google senden.

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.
  • Sie haben ein Tag vom Typ „Google Analytics: GA4-Ereignis“ in Ihrem Google Tag Manager-Container eingerichtet.
  • Sie haben die Rolle Administrator für die Google Analytics-Property.

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:

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.

Ereignis-Tag mit einer benutzerdefinierten JavaScript-Variable aktualisieren

Bevor Sie den Tag Manager-Container aktualisieren, sollten Sie sich damit vertraut machen, wie Sie den benutzerdefinierten JavaScript-Code aktualisieren, den Sie dem Container hinzufügen.

  1. Melden Sie sich in Google Tag Manager an.
  2. Klicken Sie auf dem Tab Arbeitsbereich links auf Tags.
  3. Öffnen Sie das Tag Google Analytics: GA4-Ereignis, mit dem Sie Kundendaten erfassen. Für das Ereignis-Tag muss die Mess-ID des Webstreams verwendet werden, in dem die Nutzerdaten erfasst werden.
  4. Wählen Sie Von Nutzern bereitgestellte Daten von Ihrer Website einbeziehen aus.
  5. Wählen Sie im Drop-down-Menü Nutzerdaten eine Variable vom Typ „Von Nutzern bereitgestellte Daten“ aus oder erstellen Sie eine.
  6. Wenn Sie eine neu erstellen, wählen Sie in der Variable vom Typ „Von Nutzern bereitgestellte Daten“ die Option Code aus.
  7. Klicken Sie im Drop-down-Menü Datenquelle auf Neue Variable….
  8. Klicken Sie auf Variable konfigurieren > Benutzerdefiniertes JavaScript.
  9. Geben Sie oben auf der Seite einen Namen für die benutzerdefinierte JavaScript-Variable ein.
  10. Geben Sie im Textfeld Benutzerdefiniertes JavaScript das Code-Snippet ein. Weitere Informationen
  11. Speichern Sie die neue Variable und dann das Ereignis-Tag.
  12. Klicken Sie rechts oben auf Senden, um die Änderungen zu veröffentlichen.

Code-Snippet erstellen, um von Nutzern bereitgestellte Daten zu erheben

Sie können den folgenden Code verwenden, wenn Sie die benutzerdefinierte JavaScript-Variable in Schritt 10 einrichten:

function () {

return {

"email": E-Mail_Variable , // Ersetzen Sie „E-Mail_Variable“ durch den Namen der Variable, über die die E-Mail-Adresse des Nutzers erfasst wird.

"phone_number": Telefonnummer_Variable , // Wiederholen Sie diese Zeile für „Telefonnummer_Variable“ und die Variablennamen unten.

"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

}

}

}

Ersetzen Sie für jede Art von Nutzerdaten im Codebeispiel die Platzhaltervariablen (z. B. „E-Mail_Variable“) durch den Namen der globalen JavaScript-Variable, die diese Daten enthält. Wird auf Ihrer Website eines der oben genannten Felder nicht erfasst, lassen Sie es nicht leer, sondern entfernen Sie es.

Alternativ können Sie das Feld mit einem String hartcodieren oder eine Funktion anstelle einer Variable verwenden.

// Implementieren Sie
<script>
gtag('set', 'user_data', {

"sha256_email_address": Normalisierte_und_gehashte_E-Mail_Variable,
"sha256_phone_number": Normalisierte_und_gehashte_Telefonnummer_Variable,
"address": {
"address.sha256_first_name": Normalisierte_und_gehashte_Vorname_Variable,
"address.sha256_last_name": Normalisierte_und_gehashte_Nachname_Variable,
"city": Ort_Variable,
"region": Region_Variable,
"postal_code": PLZ_Variable,
"country": Land_Variable
}
});
</script>

Wenn Sie Nutzerdatenwerte gehasht senden möchten, können Sie das folgende Beispiel-Snippet verwenden:

async function processUserData() {
const userData = {

'sha256_email_address': await Hash_E-Mail(email.trim()),
'sha256_phone_number': await Hash_Telefonnummer(phoneNumber),
'address': {
'address.sha256_first_name': await Hash_Name(firstName),
'address.sha256_last_name': await Hash_Name(lastName),
'city': Ort,
'region': Region,
'postal_code': PLZ,
'country': Land,
},
};
return userData;

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.

Next steps

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

War das hilfreich?

Wie können wir die Seite verbessern?
Suche
Suche löschen
Suche schließen
Hauptmenü
9914600513860508662
true
Suchen in der Hilfe
true
true
true
true
true
69256
false
false