Трекинг предустановленных приложений

Предустановка приложений производителем устройства или ритейлером является достаточно популярным способом дистрибуции приложений. AppMetrica позволяет отслеживать активации предустановленных приложений, используя данные о трекере. Эти данные передаются с помощью tracking ID.

Например, у вас есть партнер — производитель устройства — который распространяет ваше приложение (предустанавливая его). Все активации предустановленных приложений должны быть атрибутированы данному партнеру. Для этого при первом запуске приложения следует передать в SDK AppMetrica информацию о том, что это специальная сборка приложения для предустановки, а также информацию о партнере.

AppMetrica SDK имеет специальные сеттер-методы для сохранения («hard-coding») сведений о партнере для последующей атрибуции и отправки postback. Если несколько партнеров предустанавливают приложение, следует создать отдельные сборки приложения для каждого партнера. В сборке должны быть сохранены различные наборы информации о партнере, которому предназначается сборка.

Получение tracking ID

  1. В интерфейсе AppMetrica на странице «Партнёры» добавьте партнера или выберите из списка. Затем перейдите на страницу партнера.
  2. Создайте трекер, нажав кнопку Создать трекер и настройте его. При этом обратите внимание на следующие поля:

    • Целевая ссылка — укажите фиктивную ссылку (например, https://yandex.com); поле не учитывается при отслеживании предустановленных приложений.
    • Партнёр — убедитесь, что в выпадающем списке партнер выбран верно.
    Внимание. Для тестирования трекинга предустановок необходимо включить реатрибуцию в настройках трекера. Включенная реатрибуция позволит засчитать предустановку более одного раза.
  3. Найдите созданный трекер в списке и перейдите на его страницу. ID, который указан на странице, используется в качестве tracking ID при настройке AppMetrica SDK.

Внимание. Для получения корректной статистики по активациям предустановленного приложения нельзя использовать tracking URL из созданного трекера. Для каждого партнера необходимо создать отдельный трекер.

Настройка AppMetrica SDK

Отслеживание предустановленных приложений доступно при использовании расширенной конфигурации библиотеки AppMetrica. Чтобы задать параметры для отслеживания предустановленных приложений выполните следующее:

  1. Создайте объект с параметрами, необходимыми для отслеживания:

    public class MyApp extends Application {
          @Override
          public void onCreate() {
              super.onCreate();
              // Creating an instance of a constructor for app pre-installation information.
              PreloadInfo.Builder preloadInfoBuilder = PreloadInfo.newBuilder(tracking_ID);
              // Creating an instance of information about app pre-installation.
              PreloadInfo preloadInfo = preloadInfoBuilder.build();
    Скопировано
  2. Создайте расширенную конфигурацию библиотеки AppMetrica и укажите параметры для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.

    public class MyApp extends Application {
          @Override
          public void onCreate() {
              super.onCreate();
              // Creating an extended library configuration.
              YandexMetricaConfig.Builder configBuilder = YandexMetricaConfig.newConfigBuilder(API_key);
              // Setting necessary parameters (for example, enabling logging).
              configBuilder.setLogEnabled();
              ...
              // Setting tracking parameters for pre-installed apps.
              configBuilder.setPreloadInfo(preloadInfo);
              // Creating an extended configuration instance.
              YandexMetricaConfig extendedConfig = configBuilder.build();
              // Initializing the AppMetrica SDK.
              YandexMetrica.activate(getApplicationContext(), extendedConfig);
          }
    }
    Скопировано

    Инициализируйте AppMetrica SDK данным образом для всех процессов приложения.

  3. Включите отслеживание активности пользователей, используя метод класса YMMYandexMetrica:

    ...
    YandexMetrica.enableActivityAutoTracking(this);
Параметр Описание
API_key Уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения
tracking_ID Числовой идентификатор трекера, который указывается в интерфейсе AppMetrica при создании трекера
Параметр Описание
API_key Уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения
tracking_ID Числовой идентификатор трекера, который указывается в интерфейсе AppMetrica при создании трекера

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.