User-ID festlegen

Google Analytics hat einen setUserID-Aufruf, mit dem Sie eine Nutzer-ID für den Nutzer Ihrer App speichern können. Dieser Aufruf ist optional und wird in der Regel von Organisationen verwendet, die Analytics in Verbindung mit BigQuery nutzen möchten, um Analysedaten für denselben Nutzer über mehrere Apps, Geräte oder Analyseanbieter hinweg zu verknüpfen.

Hinweis :Sie sind dafür verantwortlich, dass die Verwendung der User-ID den Google Analytics-Nutzungsbedingungen entspricht. Das bedeutet auch, dass Sie keine unzulässigen personenidentifizierbaren Informationen nutzen und in Ihrer Datenschutzerklärung angemessen über die Verwendung von IDs informieren. Die User-ID darf keine Informationen enthalten, mit denen Dritte die Identität eines einzelnen Nutzers ermitteln könnten. Sie können beispielsweise nicht die E-Mail-Adresse oder Sozialversicherungsnummer eines Nutzers als Nutzer-ID verwenden.

Es gibt viele Möglichkeiten, gültige User-IDs zu erstellen. Eine Möglichkeit besteht darin, eine Kennung zu verwenden, die Sie zuweisen und die nur Sie einem einzelnen Nutzer zuordnen können. Ein Beispiel: Ein hypothetischer Entwickler von mobilen Spielen, AwesomeGameCompany, hat eine eigene interne AwesomeGameCompanyID, die für jeden Nutzer erstellt wird. Wenn es für eine externe Organisation nicht möglich ist, AwesomeGameCompanyID dem ursprünglichen Nutzer zuzuordnen, kann sie AwesomeGameCompanyID oder besser noch eine gehashte Version von AwesomeGameCompanyID als Nutzer-ID-Wert für Analytics verwenden. So können sie beispielsweise die Gesamtausgaben eines Nutzers für alle ihre Spiele berechnen.

Eine Nutzer-ID ist für die korrekte Funktion von Analytics nie erforderlich. Wenn Sie nur Ereignisse desselben Nutzers für dieselbe App auf einem einzelnen Gerät finden möchten, können Sie user_pseudo_id verwenden. Dieser Wert wird automatisch von Analytics generiert und für jedes Ereignis in BigQuery gespeichert.

User-ID festlegen

Sie können eine Nutzer-ID mit der folgenden Methode festlegen:

Swift

Hinweis:Dieses Firebase-Produkt ist nicht für das macOS-Ziel verfügbar.

Analytics.setUserID("123456")

Objective-C

Hinweis:Dieses Firebase-Produkt ist nicht für das macOS-Ziel verfügbar.

[FIRAnalytics setUserID:@"123456"]

Android

mFirebaseAnalytics.setUserId("123456");

Web

import { getAnalytics, setUserId } from "firebase/analytics";

const analytics = getAnalytics();
setUserId(analytics, "123456");

Web

firebase.analytics().setUserId("123456");

Dart

await FirebaseAnalytics.instance.setUserId(id: '123456');

Einheit

Firebase.Analytics.FirebaseAnalytics.SetUserID("123456");

C++

analytics::SetUserId("123456");

Nachdem Sie eine User-ID festgelegt haben, werden alle zukünftigen Ereignisse automatisch mit diesem Wert getaggt. Sie können darauf zugreifen, indem Sie in BigQuery nach dem Wert user_id suchen. Das Hinzufügen einer Nutzer-ID hat keine Auswirkungen auf Ereignisse, die zuvor von Google Analytics erfasst wurden.

Weitere Informationen zum Zugriff auf Analytics-Daten in BigQuery finden Sie in diesem Entwicklerleitfaden.