Создание трекера для предустановок

Предустановки — установки приложения, которые происходят без непосредственного участия пользователей устройств. AppMetrica поддерживает несколько способов трекинга предустановленных приложений.

Создание трекера для предустановок от производителя устройств

Внимание

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

Шаг 1. Создание трекера в интерфейсе AppMetrica

  1. В интерфейсе AppMetrica перейдите в раздел ТрекингСоздать трекер.

  2. В блоке Описание кампании заполните поля:

    • Предустановка — включите опцию для трекинга предустановок.
    • PAI — оставьте опцию выключенной. Подробнее о создании трекера для PAI предустановок.
    • Название — имя трекера. После создания трекер будет доступен в списке трекеров с указанным названием.
    • Приложение — выберите приложение, для которого создается трекер.
    • Партнёр — рекламный партнер, которому будут отнесены клики, установки и целевые события. Если в списке нет нужного партнера, добавьте его. После добавления новый партнер будет доступен в списке.

Шаг 2. Получение tracking_ID

  1. Найдите созданный трекер в списке и перейдите на его страницу. ID, который указан на странице, используется в качестве tracking_ID при настройке AppMetrica SDK.

Шаг 3. Настройка 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.
              AppMetricaConfig.Builder configBuilder = AppMetricaConfig.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.
              AppMetricaConfig extendedConfig = configBuilder.build();
              // Initializing the AppMetrica SDK.
              AppMetrica.activate(getApplicationContext(), extendedConfig);
          }
    }
    

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

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

    ...
    AppMetrica.enableActivityAutoTracking(this);
    

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

  • Objective-C

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

      YMMYandexMetricaPreloadInfo *preloadInfo = [[YMMYandexMetricaPreloadInfo alloc] initWithTrackingIdentifier:@"tracking_ID"];
      
    2. Создайте расширенную конфигурацию библиотеки AppMetrica и задайте в ней информацию для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.

      // Creating an extended library configuration.
      YMMYandexMetricaConfiguration *configuration = [[YMMYandexMetricaConfiguration alloc] initWithApiKey:@"API_key"];
      // Setting up the configuration.
      configuration.preloadInfo = preloadInfo;
      // ...
      // Initializing the AppMetrica SDK.
      [YMMYandexMetrica activateWithConfiguration:configuration];
      
      
  • Swift

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

      let preloadInfo = YMMYandexMetricaPreloadInfo.init(trackingIdentifier: "tracking_ID")
      
    2. Создайте расширенную конфигурацию библиотеки AppMetrica и задайте в ней информацию для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.

      // Creating an extended library configuration.
      let configuration = YMMYandexMetricaConfiguration.init(apiKey: "API key")
      // Setting up the configuration
      configuration?.preloadInfo = preloadInfo
      // ...
      // Initializing the AppMetrica SDK.
      YMMYandexMetrica.activate(with: configuration!)
      
Параметр Описание
API_key Уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения
tracking_ID Числовой идентификатор трекера, который указывается в интерфейсе AppMetrica при создании трекера.

Создание трекера для PAI предустановок

  1. В интерфейсе AppMetrica перейдите в раздел ТрекингСоздать трекер.

  2. В блоке Описание кампании заполните поля:

    • Предустановка — включите опцию для трекинга предустановок.
    • PAI — включите опцию, если вы создаете трекер для PAI предустановок. Подробнее о PAI предустановках.
    • Название — имя трекера. После создания трекер будет доступен в списке трекеров с указанным названием.
    • Приложение — выберите приложение, для которого создается трекер.
    • Партнёр — рекламный партнер, которому будут отнесены клики, установки и целевые события. Если в списке нет нужного партнера, добавьте его. После добавления новый партнер будет доступен в списке.
  3. В блоке ниже заполните поле utm_campaign. Параметр используется для подсчета предустановок с типом PAI. Введите значение, полученное от производителя, либо сгенерируйте значение параметра и передайте его производителю.

См. также

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

Написать в службу поддержки