Создание трекера для предустановок
Предустановки — установки приложения, которые происходят без непосредственного участия пользователей устройств. В AppMetrica доступны два способа отслеживания таких установок:
-
OEM-предустановка — трекинг-ссылка встраивается в APK, который производитель устанавливает на устройство до продажи. Подробнее см. Предустановка приложений производителем устройства или ритейлером.
-
PAI (Play Auto Install) — AppMetrica генерирует уникальную метку, которую производитель вставляет в ссылку на магазин приложений (только для Android). Подробнее см. Предустановка приложений через PAI (Google Play Auto Install).
Трекинг, созданный для предустановки, можно использовать только в рамках предустановочных кампаний. Его нельзя применять в обычных рекламных кампаниях или повторно использовать в других OEM/PAI-предустановках.
Шаг 1. Выбор технологии
Определите, какой сценарий используется в вашей кампании:
- OEM — предустановка приложения в прошивку или сборку.
- PAI — предустановка через Play Auto Install.
Шаг 2. Создание трекера
-
В интерфейсе AppMetrica перейдите в раздел Трекинг → Создать трекер.
-
Укажите название трекера.
-
Выберите партнера, которому будут атрибутированы клики, установки и целевые события.
Если нужного партнера нет в списке — добавьте нового партнера.
После создания трекера изменить партнера в настройках невозможно.
-
Укажите тип трекера — Предустановка.
-
Включите или отключите опцию 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. Чтобы задать параметры для отслеживания предустановленных приложений выполните следующее:
-
Создайте объект с параметрами, необходимыми для отслеживания:
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();
-
Создайте расширенную конфигурацию библиотеки 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 данным образом для всех процессов приложения.
-
Включите отслеживание активности пользователей, используя метод класса
AppMetrica
:... AppMetrica.enableActivityAutoTracking(this);
Отслеживание предустановленных приложений доступно при использовании расширенной конфигурации библиотеки AppMetrica.Чтобы задать сведения для отслеживания предустановленных приложений выполните следующее:
-
Создайте объект с параметрами, необходимыми для отслеживания:
AMAAppMetricaPreloadInfo *preloadInfo = [[AMAAppMetricaPreloadInfo alloc] initWithTrackingIdentifier:@"tracking_ID"];
-
Создайте расширенную конфигурацию библиотеки 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];
-
Создайте объект с параметрами, необходимыми для отслеживания:
let preloadInfo = AppMetricaPreloadInfo.init(trackingIdentifier: "tracking_ID")
-
Создайте расширенную конфигурацию библиотеки 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 при создании трекера. |
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.