User-IDs senden

User-IDs sind Ihre eigenen eindeutigen IDs, die Sie einzelnen Nutzern zuweisen. In dieser Anleitung wird erklärt, 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.

Wenn Sie benutzerdefinierte Dimensionen auf Grundlage von User-IDs festlegen, entstehen Dimensionen mit zu vielen eindeutigen Werten. Zu viele eindeutige Werte können sich negativ auf die Genauigkeit von Google Analytics-Daten und ‑Berichten auswirken. Weitere Informationen zu Best Practices für das Festlegen benutzerdefinierter Dimensionen.


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, hat sich dann aber 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 Laden der Seite festzulegen oder zu aktualisieren. Mit diesem Befehl wird die user_id für alle nachfolgenden Ereignisse auf der Seite festgelegt. Er wird in diesem Szenario anstelle von gtag('config') empfohlen.

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. Der aktuelle Anmeldestatus des Nutzers wird auch dann berücksichtigt, wenn er sich ändert, nachdem die Seite geladen wurde.

Zurück
Parameter hinzufügen
Weiter
Ausnahmen messen