Документация
Интеграция SDK

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

Предустановка приложений производителем устройства или ритейлером является достаточно популярным способом дистрибуции приложений. 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();
              //Создание экземпляра конструктора информации о предустановке приложения
              PreloadInfo.Builder preloadInfoBuilder = PreloadInfo.newBuilder(tracking_ID
    [no-highlight[

    Числовой идентификатор трекера, который указывается в интерфейсе AppMetrica при создании трекера

    ]no-highlight]
    ); //Создание экземпляра сведений о предустановке приложения PreloadInfo preloadInfo = preloadInfoBuilder.build();
  2. Создайте расширенную конфигурацию библиотеки AppMetrica и укажите параметры для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.

    public class MyApp extends Application {
          @Override
          public void onCreate() {
              super.onCreate();
              //Создание конструктора расширенной инициализации
              YandexMetricaConfig.Builder configBuilder = YandexMetricaConfig.newConfigBuilder(API_key
    [no-highlight[

    API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.

    ]no-highlight]
    ); //Задание необходимых параметров (например включение логирования) configBuilder.setLogEnabled(); ... //Задание параметров трекинга предустановленных приложений configBuilder.setPreloadInfo(preloadInfo); //Создание объекта расширенной конфигурации YandexMetricaConfig extendedConfig = configBuilder.build(); // Инициализация AppMetrica SDK YandexMetrica.activate(getApplicationContext(), extendedConfig); } }

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

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

    ...
    YandexMetrica.enableActivityAutoTracking(this);

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

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

    YMMYandexMetricaPreloadInfo *preloadInfo = [[YMMYandexMetricaPreloadInfo alloc] initWithTrackingIdentifier:@tracking_ID
    [no-highlight[

    Числовой идентификатор трекера, который указывается в интерфейсе AppMetrica при создании трекера

    ]no-highlight]
    ];
  2. Создайте расширенную конфигурацию библиотеки AppMetrica и задайте в ней информацию для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.

    YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:@API_key
    [no-highlight[

    API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.

    ]no-highlight]
    ]; //Задание необходимых параметров ... //Инициализация AppMetrica SDK [YMMYandexMetrica activateWithConfiguration:configuration];
  1. Создайте объект с параметрами, необходимыми для отслеживания:

    let info = YMMYandexMetricaPreloadInfo.init(trackingIdentifier: "tracking_ID
    [no-highlight[

    Числовой идентификатор трекера, который указывается в интерфейсе AppMetrica при создании трекера

    ]no-highlight]
    ")
  2. Создайте расширенную конфигурацию библиотеки AppMetrica и задайте в ней информацию для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.

    let configuration = YMMYandexMetricaConfiguration.init(apiKey: "API_key
    [no-highlight[

    API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.

    ]no-highlight]
    ") //Задание необходимых параметров ... //Инициализация AppMetrica SDK YMMYandexMetrica.activate(with: configuration)
ПараметрОписание
API_key Уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения
tracking_ID Числовой идентификатор трекера, который указывается в интерфейсе AppMetrica при создании трекера