User-ID – Android SDK

In diesem Entwicklerleitfaden erfahren Sie, wie Sie die User-ID mit dem Google Analytics SDK for Android Version 3.x implementieren.

Überblick

Mit der User-ID-Funktion können Nutzeraktivitäten geräteübergreifend in Google Analytics erfasst werden. Beispielsweise kann eine Interaktion mit einer Marketingkampagne auf einem Mobilgerät einer Conversion zugeordnet werden, die auf einem anderen Mobilgerät oder im Browser erfolgt.

Wenn User-IDs mit Google Analytics-Treffern über das Feld userId gesendet werden, enthalten Ihre Berichte eine genauere Anzahl der einzelnen Nutzer und bieten neue geräteübergreifende Berichtsoptionen. Weitere Informationen zu den Vorteilen der User-ID

In diesem Leitfaden erfahren Sie, wie Sie das Feld userId und das Google Analytics SDK for Android verwenden, um User-IDs an Google Analytics zu senden.

Voraussetzungen

Bevor Sie die User-ID an Google Analytics senden:

Implementierung

Wenn ein Nutzer Ihre Android-App kennt, sollten Sie mit dem Feld userId eine ID für diesen Nutzer mit allen Google Analytics-Treffern wie Seitenaufrufen, Ereignissen oder E-Commerce-Transaktionen senden.

Wenn Sie die User-ID senden möchten, müssen Sie das Feld userId mit der Et-Zeichen des Measurement Protocol und dem Namen des Parameters Fields.USER_ID festlegen, wie im folgenden Beispiel gezeigt:

/**
 * An example method called when a user signs in to an authentication system.
 *
 * @param User user represents a generic User object returned by an authentication system on sign in.
 */
public void onUserSignIn(User user) {

  Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y");

  // You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be
  // sent with all subsequent hits.
  t.set(Fields.USER_ID, user.getId());

  // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
  t.send(MapBuilder
      .createEvent("UX",       // Event category (required)
                   "Sign In",  // Event action (required)
                   null,       // Event label
                   null)       // Event value
      .build()
  );
}