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

Wenn Sie benutzerdefinierte Dimensionen basierend auf User-IDs festlegen, erhalten Sie Dimensionen mit zu vielen eindeutigen Werten. Zu viele einzelne Werte führen zu Problemen mit Google Analytics-Daten und der Genauigkeit von Berichten. Weitere Informationen zu Best Practices für das Festlegen benutzerdefinierter Dimensionen


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.

Verwenden Sie den Befehl gtag('set'), um user_id nach dem ersten Seitenaufbau festzulegen oder zu aktualisieren. 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.

Zurück
Parameter hinzufügen
Weiter
Ausnahmen messen