---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://appmetrica.yandex.by/docs/en/mobile-tracking/add-preinstall.md
- https://appmetrica.yandex.by/docs/ru/mobile-tracking/add-preinstall.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt
# Создание трекера для предустановок
Предустановки — установки приложения, которые происходят без непосредственного участия пользователей устройств. В AppMetrica доступны два способа отслеживания таких установок:
- OEM-предустановка — трекинг-ссылка встраивается в APK, который производитель устанавливает на устройство до продажи. Подробнее см. [Предустановка приложений производителем устройства или ритейлером](https://appmetrica.yandex.by/docs/ru/mobile-tracking/preinstalled-app-attr.md#apk).
- PAI (Play Auto Install) — AppMetrica генерирует уникальную метку, которую производитель вставляет в ссылку на магазин приложений (только для Android). Подробнее см. [Предустановка приложений через PAI (Google Play Auto Install)](https://appmetrica.yandex.by/docs/ru/mobile-tracking/preinstalled-app-attr.md#pai).
{% note alert "" %}
Трекинг, созданный для предустановки, можно использовать только в рамках предустановочных кампаний. Его нельзя применять в обычных рекламных кампаниях или повторно использовать в других OEM/PAI-предустановках.
{% endnote %}
## Шаг 1. Выбор технологии {#technology}
Определите, какой сценарий используется в вашей кампании:
- OEM — предустановка приложения в прошивку или сборку.
- PAI — предустановка через Play Auto Install.
## Шаг 2. Создание трекера {#tracker}
1. В интерфейсе AppMetrica перейдите в раздел **Трекинг** → **Создать трекер**.
2. Укажите название трекера.
3. Выберите [партнера](https://appmetrica.yandex.by/docs/ru/mobile-tracking/add-partner.md), которому будут атрибутированы клики, установки и целевые события.
Если нужного партнера нет в списке — [добавьте нового партнера](https://appmetrica.yandex.by/docs/ru/mobile-tracking/add-partner.md#add-partner).
{% note info "" %}
После создания трекера изменить партнера в настройках невозможно.
{% endnote %}
4. Укажите тип трекера — **Предустановка**.
5. Включите или отключите опцию **PAI** (Play Auto Install) в зависимости от выбранной технологии.
## Шаг 3. (*Опционально*) Настройка постбеков {#postback}
Для предустановочных трекеров можно настроить постбеки — автоматическую отправку партнерам данных о сработавших конверсиях. Вы можете добавить в трекер до 5 постбеков. Можно использовать шаблоны партнера или задать свои ссылки с макросами.
## Шаг 4. Получение UTM-метки и ID трекера {#result}
- Если опция **PAI** включена — нажмите **Сгенерировать**, чтобы получить уникальную UTM-метку `utm_campaign`.
- Если используется OEM-предустановка и опция **PAI** отключена — справа отобразится `tracking_ID`.
## Шаг 5. Что делать дальше {#next}
Если вы используется PAI, передайте UTM-метку вашему партнеру или производителю для использования в Google Play.
Если вы используете OEM-предустановку, настройте AppMetrica SDK:
{% list tabs %}
- Android
Отслеживание предустановленных приложений доступно при использовании [расширенной конфигурации библиотеки AppMetrica](https://appmetrica.yandex.by/docs/ru/sdk/android/analytics/android-operations.md). Чтобы задать параметры для отслеживания предустановленных приложений выполните следующее:
1. Создайте объект с параметрами, необходимыми для отслеживания:
```java translate=no
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 и укажите параметры для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.
```java translate=no
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`:
```java translate=no
...
AppMetrica.enableActivityAutoTracking(this);
```
- iOS
Отслеживание предустановленных приложений доступно при использовании [расширенной конфигурации библиотеки AppMetrica](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md).Чтобы задать сведения для отслеживания предустановленных приложений выполните следующее:
{% list tabs %}
- Objective-C
1. Создайте объект с параметрами, необходимыми для отслеживания:
```objectivec translate=no
AMAAppMetricaPreloadInfo *preloadInfo = [[AMAAppMetricaPreloadInfo alloc] initWithTrackingIdentifier:@"tracking_ID"];
```
2. Создайте расширенную конфигурацию библиотеки AppMetrica и задайте в ней информацию для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.
```objectivec translate=no
// 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];
```
- Swift
1. Создайте объект с параметрами, необходимыми для отслеживания:
```swift translate=no
let preloadInfo = AppMetricaPreloadInfo.init(trackingIdentifier: "tracking_ID")
```
2. Создайте расширенную конфигурацию библиотеки AppMetrica и задайте в ней информацию для отслеживания предустановленных приложений. Затем произведите инициализацию библиотеки в приложении, используя расширенную конфигурацию.
```swift translate=no
// 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!)
```
{% endlist %}
{% endlist %}
| Параметр | Описание |
| -------- | -------- |
| `API_key` | Уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при [добавлении приложения](https://appmetrika.yandex.ru/application/new) |
| `tracking_ID` | Числовой идентификатор трекера, который указывается в интерфейсе AppMetrica при создании трекера. |
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.
Написать в службу поддержки
Предложить улучшение для документации