Идентификатор пользователя – Android SDK

В этом руководстве для разработчиков показано, как реализовать User ID с помощью Google Analytics SDK для Android v3.x.

Обзор

Функция User ID позволяет измерять действия пользователей на разных устройствах в Google Analytics, например связывать взаимодействие с маркетинговой кампанией на одном мобильном устройстве с конверсией, происходящей на другом мобильном устройстве или в браузере.

Когда идентификаторы пользователей отправляются вместе с обращениями Google Analytics с использованием поля userId , ваши отчеты будут отражать более точное количество уникальных пользователей и предлагать новые варианты отчетов по нескольким устройствам. Узнайте больше о преимуществах использования User ID.

В этом руководстве показано, как использовать поле userId и Google Analytics SDK для Android для отправки идентификаторов пользователей в Google Analytics.

Предварительные условия

Прежде чем отправлять идентификатор пользователя в Google Analytics:

Выполнение

Если пользователь известен вашему приложению Android, вы должны отправить идентификатор, представляющий этого пользователя, со всеми вашими обращениями Google Analytics, такими как просмотры страниц, события, транзакции электронной торговли и т. д., используя поле userId .

Чтобы отправить идентификатор пользователя, задайте поле userId , используя синтаксис амперсанда Measurement Protocol и имя параметра Fields.USER_ID , как в этом примере:

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