User-IDs senden

User-IDs sind Ihre eigenen eindeutigen IDs, die Sie einzelnen Nutzern zuweisen. In dieser Anleitung wird erläutert, wie Sie User-IDs an Google Analytics senden, damit Sie das Nutzerverhalten über verschiedene Sitzungen, Geräte und Plattformen hinweg verknüpfen können.

Weitere Informationen zur User-ID-Funktion finden Sie unter Aktivitäten auf verschiedenen Plattformen messen. Informationen zum Festlegen einer User-ID für eine App finden Sie unter User-ID festlegen.

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 verschiedene Geräte und Sitzungen hinweg verwendet wird. Legen Sie ihn nicht als benutzerdefinierte Nutzereigenschaft fest (z. B. im Objekt user_properties für gtag.js oder im Bereich Nutzereigenschaften von Google Tag Manager-Tags) und registrieren Sie ihn nicht als benutzerdefinierte Dimension in der Analytics-Benutzeroberfläche. Übergeben Sie ihn auch nicht als Parameter auf Ereignisebene für einzelne Ereignisse. Legen Sie user_id stattdessen nur als Konfigurationsparameter mit den folgenden Methoden fest.


Hinweis

Bevor Sie User-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 seine User-ID.
  • Nutzer war angemeldet und hat sich dann abgemeldet: Senden Sie 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 User-ID.
  4. Wenn sich ein Nutzer abmeldet, legen Sie für user_id den Wert null fest. Senden Sie keinen leeren String (""), keinen String mit einem Leerzeichen (" ") und nicht die in Anführungszeichen gesetzten Wörter "null" oder "NULL".

User-ID nach der Initialisierung festlegen

In vielen Fällen ist die user_id nicht bekannt, wenn das Google-Tag zum ersten Mal initialisiert wird. Ein Nutzer kann beispielsweise Ihre Website besuchen und sich erst später anmelden.

Verwenden Sie den gtag('set') Befehl, um die user_id nach dem ersten Seitenaufbau festzulegen oder zu aktualisieren. Mit diesem Befehl wird die user_id für alle nachfolgenden Ereignisse auf der Seite festgelegt. Dies ist in diesem Fall die empfohlene Methode anstelle von gtag('config').

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 der Abmeldung löschen

Wenn sich ein Nutzer abmeldet, sollten Sie die user_id löschen, indem Sie ihren Wert auf null setzen:

// 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') sorgen Sie dafür, dass die user_id während der gesamten Nutzersitzung korrekt verwaltet wird. So wird der aktuelle Anmeldestatus des Nutzers widergespiegelt, auch wenn er sich nach dem Laden der Seite ändert.

Verwendung von User-IDs in Google Analytics

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

  • Nutzerpfade vereinheitlichen:Nutzeraktivitäten für angemeldete Nutzer über verschiedene Sitzungen, Geräte und Plattformen hinweg verknüpfen
  • Nutzeranzahl verbessern:Genauere, deduplizierte Nutzermesswerte bereitstellen
  • Analysen ermöglichen:
    • Aktivitäten basierend auf dem Anmeldestatus analysieren: Verwenden Sie Dimensionen wie „Mit User-ID angemeldet“, um Vergleiche in Standardberichten oder Segmente in explorativen Datenanalysen zu erstellen.
    • Die explorative Datenanalysetechnik „Nutzer-Explorer“ nutzen, mit der Sie die Zeitachse der Aktivitäten für einzelne Nutzer aufrufen können.

Wichtige Hinweise

  • Keine benutzerdefinierten Dimensionen für User-IDs erstellen:Sie sollten die user_id nicht als benutzerdefinierte Dimension auf Nutzerebene registrieren. Dies ist eine wichtige Best Practice. Andernfalls wird eine unnötige Dimension mit hoher Kardinalität erstellt, was sich erheblich auf die Leistung von Berichten auswirken, dazu führen kann, dass Daten in der Zeile „Sonstiges“ zusammengefasst werden, und Ihr Kontingent für benutzerdefinierte Dimensionen verbrauchen kann. Die integrierte User-ID-Funktion übernimmt die Verknüpfung von Nutzern. Weitere Informationen finden Sie unter Best Practices für User-IDs.

  • Als Konfigurationseinstellung festlegen, nicht als Nutzereigenschaft oder Ereignis parameter: 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 Konfigurationseinstellungen für das Google-Tag in Google Tag Manager).user_id Konfigurieren Sie ihn nicht als benutzerdefinierte Nutzereigenschaft, übergeben Sie ihn nicht im Einstellungsobjekt user_properties und senden Sie ihn 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 in Standardberichten oder den meisten explorativen Datenanalysen (z. B. in der explorativen Datenanalyse „Kostenlose Form“) nicht als Standarddimension verfügbar, um den Datenschutz zu wahren und die Kardinalität zu verwalten. Sie können die Rohwerte für user_id jedoch in der explorativen Datenanalyse „Nutzer-Explorer“ in der Spalte „Effektive User-ID“ für angemeldete Nutzer sehen.

  • Zugriff auf Rohwerte für User-IDs: Wenn Sie Analysen mit den Rohwerten user_id durchführen müssen, empfiehlt sich der GA4-BigQuery-Export. Das Feld user_id ist in den exportierten Daten verfügbar.

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

Zurück
Parameter hinzufügen
Weiter
Ausnahmen messen