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

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

Трекинг, созданный для предустановки, можно использовать только в рамках предустановочных кампаний. Его нельзя применять в обычных рекламных кампаниях или повторно использовать в других OEM/PAI-предустановках.

Шаг 1. Выбор технологии

Определите, какой сценарий используется в вашей кампании:

  • OEM — предустановка приложения в прошивку или сборку.
  • PAI — предустановка через Play Auto Install.

Шаг 2. Создание трекера

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

  2. Укажите название трекера.

  3. Выберите партнера, которому будут атрибутированы клики, установки и целевые события.

    Если нужного партнера нет в списке — добавьте нового партнера.

    После создания трекера изменить партнера в настройках невозможно.

  4. Укажите тип трекера — Предустановка.

  5. Включите или отключите опцию PAI (Play Auto Install) в зависимости от выбранной технологии.

Шаг 3. (Опционально) Настройка постбеков

Для предустановочных трекеров можно настроить постбеки — автоматическую отправку партнерам данных о сработавших конверсиях. Вы можете добавить в трекер до 5 постбеков. Можно использовать шаблоны партнера или задать свои ссылки с макросами.

Шаг 4. Получение UTM-метки и ID трекера

  • Если опция PAI включена — нажмите Сгенерировать, чтобы получить уникальную UTM-метку utm_campaign.
  • Если используется OEM-предустановка и опция PAI отключена — справа отобразится tracking_ID.

Шаг 5. Что делать дальше

Если вы используется PAI, передайте UTM-метку вашему партнеру или производителю для использования в Google Play.

Если вы используете OEM-предустановку, настройте 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.Чтобы задать сведения для отслеживания предустановленных приложений выполните следующее:

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

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

    // Creating an extended library configuration.
    AMAAppMetricaConfiguration *configuration = [[AMAAppMetricaConfiguration alloc] initWithApiKey:@"API_key"];
    // Setting up the configuration.
    configuration.preloadInfo = preloadInfo;
    // ...
    // Initializing the AppMetrica SDK.
    [AMAAppMetrica activateWithConfiguration:configuration];
    
  1. Создайте объект с параметрами, необходимыми для отслеживания:

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

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

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

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