User-IDs senden

User-IDs sind Ihre eigenen eindeutigen Kennungen, die Sie einzelnen Nutzern zuweisen. In diesem Leitfaden wird erläutert, 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 eindeutige Werte können zu Problemen mit Google Analytics-Daten und der Genauigkeit von Berichten führen. 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 Parameter user_id 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 angemeldet war, sich dann aber 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".