User ID – pakiet SDK na Androida

W tym przewodniku dla programistów pokazujemy, jak zaimplementować funkcję User-ID za pomocą pakietu SDK Google Analytics na Androida w wersji 3.x.

Przegląd

Funkcja User ID umożliwia pomiar w Google Analytics działań użytkowników, które obejmują różne urządzenia, np. przypisywanie interakcji z kampanią marketingową na jednym urządzeniu mobilnym do konwersji mającej miejsce na innym urządzeniu mobilnym lub w przeglądarce.

Jeśli identyfikatory User ID są wysyłane z działaniami Google Analytics za pomocą pola userId, raporty będą dokładniej odzwierciedlać liczbę unikalnych użytkowników i udostępniać nowe opcje raportowania działań użytkowników na różnych urządzeniach. Więcej informacji o zaletach korzystania z funkcji User-ID

Z tego przewodnika dowiesz się, jak używać pola userId i pakietu SDK Google Analytics na Androida do przesyłania identyfikatorów użytkowników do Google Analytics.

Wymagania wstępne

Przed wysłaniem identyfikatora User ID do Google Analytics:

Skonfiguruj funkcję User ID
Zapoznaj się z zasadami korzystania z funkcji User-ID.
Aby dowiedzieć się, jak działa funkcja User ID, zapoznaj się z informacjami o funkcji User ID.

Implementacja

Jeśli dany użytkownik jest znany Twojej aplikacji na Androida, wysyłaj reprezentujący go identyfikator razem ze wszystkimi działaniami Google Analytics, np. odsłonami stron, zdarzeniami, transakcjami e-commerce itd., korzystając z pola userId.

Aby wysłać identyfikator użytkownika, ustaw pole userId za pomocą składni ampersand platformy Measurement Protocol i nazwy parametru Fields.USER_ID, jak w tym przykładzie:

/**
 * 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()
  );
}