User-IDs senden

User-IDs sind Ihre eigenen eindeutigen Kennungen, die Sie einzelnen Nutzern zuweisen. In diesem Leitfaden wird beschrieben, wie Sie User-IDs an Google Analytics senden, damit Sie das Nutzerverhalten über verschiedene Sitzungen, Geräte und Plattformen hinweg analysieren können.

Weitere Informationen zur User-ID-Funktion Weitere Informationen zum Festlegen einer User-ID für eine App

Der Parameter user_id ist ein Konfigurationsparameter und keine benutzerdefinierte Nutzereigenschaft oder kein Standardereignisparameter. Stattdessen ist user_id ein reservierter Systemparameter, der speziell zur Identifizierung authentifizierter Nutzer über Geräte und Sitzungen hinweg verwendet wird. Legen Sie sie nicht als benutzerdefinierte Nutzereigenschaft fest (z. B. im user_properties-Objekt für gtag.js oder im Bereich Nutzereigenschaften von Google Tag Manager-Tags) und registrieren Sie sie nicht als benutzerdefinierte Dimension in der Analytics-Benutzeroberfläche. Geben Sie ihn auch nicht als Parameter auf Ereignisebene für einzelne Ereignisse an. Legen Sie user_id stattdessen nur als Konfigurationsparameter mit den folgenden Methoden fest.


Hinweis

Bevor Sie Nutzer-IDs senden können, müssen Sie Folgendes erledigt haben:

User-IDs senden

Der Wert, den Sie für user_id senden, hängt vom Status des Nutzers ab:

  • Nutzer hat sich noch nie angemeldet: Senden Sie den user_id-Parameter nicht.
  • Nutzer ist angemeldet: Senden Sie die User-ID.
  • Nutzer war angemeldet und hat sich dann abgemeldet: Sende null.

Wenn Sie eine User-ID an Analytics senden möchten, fügen Sie den Parameter user_id auf jeder Seite Ihrer Website dem Befehl config hinzu:

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}
  1. Ersetzen Sie TAG_ID durch Ihre Tag-ID.
  2. Ersetzen Sie die Kommentare durch Ihre Prüfungen, ob der Nutzer angemeldet war und ob er sich abgemeldet hat.
  3. Wenn ein Nutzer angemeldet ist, ersetzen Sie USER_ID durch seine Nutzer-ID.
  4. Wenn sich ein Nutzer abmeldet, setzen Sie user_id auf null. Senden Sie keinen leeren String (""), keinen leeren String (" ") und nicht die in Anführungszeichen gesetzten Wörter "null" oder "NULL".

User-ID nach der Initialisierung festlegen

In vielen Fällen ist der user_id nicht bekannt, wenn das Google-Tag zum ersten Mal initialisiert wird. Ein Nutzer besucht Ihre Website beispielsweise und meldet sich erst später an.

Wenn Sie user_id nach dem ersten Seitenaufbau festlegen oder aktualisieren möchten, verwenden Sie den Befehl gtag('set'). Mit diesem Befehl wird user_id für alle nachfolgenden Ereignisse auf der Seite festgelegt. Das ist die empfohlene Vorgehensweise anstelle von gtag('config') in diesem Szenario.

User-ID bei der Anmeldung festlegen

Wenn sich ein Nutzer erfolgreich anmeldet, rufen Sie gtag('set') auf, um seine ID mit zukünftigen Ereignissen zu verknüpfen:

// Example function called after successful login
function handleUserLogin(userId) {
  if (userId) {
    gtag('set', {'user_id': userId});
    console.log('User ID set for GA:', userId);

    // You can also send a login event
    gtag('event', 'login', { method: 'your_login_method' });
  }
}

// Example usage:
// handleUserLogin('12345_user');

User-ID bei Abmeldung löschen

Wenn sich ein Nutzer abmeldet, sollten Sie user_id löschen, indem Sie den Wert auf null festlegen:

// Example function called after logout
function handleUserLogout() {
  gtag('set', {'user_id': null});
  console.log('User ID cleared for GA.');

  // You can also send a logout event
  gtag('event', 'logout');
}

// Example usage:
// handleUserLogout();

Mit gtag('set') wird dafür gesorgt, dass die user_id während der gesamten Nutzersitzung korrekt verwaltet wird. So wird der aktuelle Anmeldestatus des Nutzers berücksichtigt, auch wenn er sich nach dem Laden der Seite ändert.

Verwendung der User-ID in Google Analytics

Wenn Sie user_id-Werte an Google Analytics senden, werden sie für Folgendes verwendet:

  • Nutzerpfade vereinheitlichen:Nutzeraktivitäten von angemeldeten Nutzern über verschiedene Sitzungen, Geräte und Plattformen hinweg verknüpfen.
  • Nutzerzahlen verbessern:Genauere, deduplizierte Nutzermesswerte bereitstellen.
  • Analyse aktivieren:
    • Aktivitäten basierend auf dem Anmeldestatus analysieren: Mit Dimensionen wie „Mit User-ID angemeldet“ können Sie Vergleiche in Standardberichten oder Segmente in explorativen Datenanalysen erstellen.
    • Sie ist die Grundlage für das Analyseverfahren Nutzer-Explorer, mit dem Sie die Zeitachse der Aktivitäten einzelner Nutzer aufschlüsseln können.

Wichtige Hinweise

  • KEINE benutzerdefinierten Dimensionen für User-ID erstellen:Sie sollten die user_id nicht als benutzerdefinierte Dimension auf Nutzerebene registrieren. Dies ist eine wichtige Best Practice. Dadurch wird eine unnötige Dimension mit hoher Kardinalität erstellt, die sich erheblich auf die Berichtsleistung auswirken, dazu führen kann, dass Daten in der Zeile „(sonstige)“ gruppiert werden, und Ihr Kontingent für benutzerdefinierte Dimensionen aufbrauchen kann. Die integrierte User-ID-Funktion übernimmt das Zusammenführen von Nutzern. Weitere Informationen

  • user_id als Konfigurationseinstellung und nicht als Nutzereigenschaft oder Ereignisparameter festlegen:Da user_id ein reservierter Systemparameter ist, darf er nur als Konfigurations- oder Einstellungsparameter angewendet werden (mit den Befehlen gtag() config oder set oder den Google-Tag-Konfigurationseinstellungen von Google Tag Manager). Konfigurieren Sie sie nicht als benutzerdefinierte Nutzereigenschaft, übergeben Sie sie nicht im user_properties-Einstellungsobjekt und senden Sie sie nicht als Parameter auf Ereignisebene für einzelne Ereignisse.

  • Direkte ID-Sichtbarkeit in Standardberichten im Vergleich zu explorativen Datenanalysen:Rohwerte für user_id sind nicht als Standarddimension in Standardberichten oder den meisten explorativen Datenanalysen (z. B. „Kostenlos“) verfügbar, um den Datenschutz zu wahren und die Kardinalität zu verwalten. Sie können die Rohdaten für user_id jedoch in der Vorlage für den Nutzer-Explorer in der Spalte Effektive Nutzer-ID für angemeldete Nutzer sehen.

  • Zugriff auf Roh-User-IDs:Wenn Sie Analysen mit den Rohwerten für user_id durchführen müssen, empfehlen wir, den Google Analytics 4-BigQuery-Export zu verwenden. Das Feld user_id ist in den exportierten Daten verfügbar.

Damit User-ID-Daten verwendet werden und im User-Explorer sichtbar sind, muss die Identität für die Berichterstellung Ihrer Property auf Zusammengeführt oder Beobachtet festgelegt sein.

Zurück
Parameter hinzufügen
Weiter
Ausnahmen messen