[GA4] Von Nutzern bereitgestellte Daten erheben (gtag.js)

Diese Funktion ist Teil eines offenen Betaprogramms und kann sich noch ändern.

Diese Anleitung richtet sich an Administratoren und Bearbeiter, die die Erhebung der von Nutzern bereitgestellten Daten aktiviert haben und diese Daten mithilfe von gtag.js von einer Website senden möchten.

Before you begin

You must turn on user-provided data collection in Google Analytics.

Methode zum Identifizieren der von Nutzern bereitgestellten Daten auswählen

1. Klicken Sie im Bereich Verwaltung unter Datenerhebung und -änderung klicken Sie auf Datenstreams.
   Hinweis: Über den vorherigen Link wird die Analytics-Property aufgerufen, auf die Sie zuletzt zugegriffen haben. Sie müssen in einem Google-Konto angemeldet sein, um die Property zu öffnen. Über die Property-Auswahl können Sie die Property wechseln. Sie benötigen mindestens die Rolle Bearbeiter auf Property-Ebene, um Folgendes tun zu können: Einstellungen für von Nutzern bereitgestellte Daten zu konfigurieren.
   
2. Wählen Sie den gewünschten Web-Datenstream aus.
3. Klicken Sie unter Google-Tag auf Tag-Einstellungen konfigurieren > Funktionen für von Nutzern bereitgestellte Daten zulassen.
4. Aktivieren Sie Funktionen für von Nutzern bereitgestellte Daten zulassen.
   
5. Wählen Sie eine oder mehrere Möglichkeiten aus, um von Nutzern bereitgestellte Daten zu identifizieren:

   Option	Beschreibung
   Von Nutzern bereitgestellte Daten automatisch erkennen	Hier prüft Google Analytics Ihre Webseiten auf Strings, die dem Muster einer E-Mail-Adresse entsprechen. Telefonnummern und Adressen werden ausgeschlossen. Wir empfehlen, zusätzlich die folgenden Optionen zu verwenden.
   CSS-Selektoren oder JavaScript-Variablen angeben	Hier wählen Sie die Arten der von Nutzern bereitgestellten Daten aus, die Sie erheben möchten, z. B. E-Mail-Adressen oder Telefonnummern. Sie legen für jeden Datentyp fest, wie die Daten auf der Seite identifiziert werden sollen – entweder über einen CSS-Selektor oder eine globale JavaScript-Variable. Weitere Informationen Diese Methode ist präziser als die automatische Erkennung der von Nutzern bereitgestellten Daten, aber nicht so zuverlässig wie das Einfügen eines Code-Snippets auf Ihrer Website. Wenn Sie den Websitecode häufig ändern, insbesondere die Formatierung oder die CSS-Selektoren auf der Seite, auf der Sie Daten erheben, sollten Sie Ihrer Website ein Code-Snippet hinzufügen.
   Code-Snippet auf der Website einfügen	Hier fügen Sie Ihren Webseiten JavaScript-Code hinzu, um E-Mail-Adressen, Telefonnummern und/oder Namen und Adressen zu erfassen. Dann legen Sie den Parameter „user_data“ für jedes Ereignis auf der Seite fest. Weitere Informationen

6. Klicken Sie auf Speichern.

Festzulegende Felder

In der folgenden Tabelle werden die einzelnen Felder beschrieben, die Sie festlegen können. Der Schlüsselname gibt an, wie Sie in Ihrem Code auf das Feld verweisen müssen. Sie müssen die Daten als String übergeben. Definieren Sie jede Komponente als einzelne Variable (z. B. Vor- und Nachname), wenn Sie Name und Adresse festlegen.

Hinweis: Wenn Sie nicht gehashte Daten senden und von Google normalisieren und hashen lassen möchten, verwenden Sie für jedes Datenfeld den ersten Schlüsselnamen. Geben Sie beispielsweise „email“ in das Datenfeld „E-Mail-Adresse“ unten ein. Wenn Sie gehashte Daten senden möchten, verwenden Sie den Schlüsselnamen, der mit „sha256_“ beginnt.

Datenfeld	Schlüsselname	Beschreibung
E-Mail-Adresse	email	E-Mail-Adresse des Nutzers. Beispiel: „[e-mail]“
	sha256_email_address	Gehashte E-Mail-Adresse des Nutzers. Beispiel: „a8af8341993604f29cd4e0e5a5a4b5d48c575436c38b28abbfd7d481f345d5db“
Telefonnummer	phone_number	Telefonnummer des Nutzers. Muss im E.164-Format vorliegen, also 11 bis 15 Zeichen lang sein, einschließlich eines Pluszeichens (+) und eines Ländercodes ohne Bindestriche, Klammern oder Leerzeichen. Beispiel: „[phone]“
	sha256_phone_number	Gehashte Telefonnummer des Nutzers. Beispiel: „e9d3eef677f9a3b19820f92696be53d646ac4cea500e5f8fd08b00bc6ac773b1“
Vorname	address.first_name	Vorname des Nutzers. Beispiel: „Max“
	address.sha256_first_name	Gehashter Vorname des Nutzers. Beispiel: „96d9632f363564cc3032521409cf22a852f2032eec099ed5967c0d000cec607a“
Nachname	address.last_name	Nachname des Nutzers. Beispiel: „Mustermann“
	address.sha256_last_name	Gehashter Nachname des Nutzers. Beispiel: „799ef92a11af918e3fb741df42934f3b568ed2d93ac1df74f1b8d41a27932a6f“
Adresse	address.street	Straßenname und Hausnummer des Nutzers. Beispiel: „Musterstr. 123“
Stadt	address.city	Wohnort des Nutzers. Beispiel: „Musterstadt“
Region	address.region	Provinz, Bundesland oder Region des Nutzers. Beispiel: „Musterland“
Postleitzahl	address.postal_code	Postleitzahl des Nutzers. Beispiel: „SO99 9XX“
Land	address.country	Ländercode des Nutzers. Beispiel: „DE“. Verwenden Sie Ländercodes mit zwei Buchstaben gemäß ISO 3166-1 ALPHA-2.