---
metadata:
- name: generator
content: Diplodoc Platform v5.64.0
alternate:
- https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/add-preinstall.md
- https://boost.yandex.com/doc/ru/analytics/content/mobile-tracking/add-preinstall.md
- https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/add-preinstall.md
- href: https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/add-preinstall.md
type: text/markdown
title: Markdown version
- href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21772739
rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21772739
# 为预安装创建跟踪器
预安装是指在设备上安装应用，而不需要用户直接参与。 Analytics module 提供两种方法来跟踪这些安装：
- OEM预安装：跟踪URL被嵌入到制造商在出售设备前安装的APK中。 有关更多信息，请参阅[设备制造商或零售商预装的应用](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/preinstalled-app-attr.md#apk)。
- PAI（Play Auto Install）：Analytics module 生成一个唯一的标签，制造商将其插入应用商店的 URL 中（仅限 Android）。 有关更多信息，请参阅[预先安装应用（PAI，Google Play 自动安装）](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/preinstalled-app-attr.md#pai)。
{% note alert "" %}
为预安装应用创建的追踪器仅在预安装广告活动中可用。 它们不能用于普通营销活动，也不能在其他 OEM/PAI 预安装中重复使用。
{% endnote %}
## 步骤 1. 选择技术 {#technology}
确定哪种情况适用于您的广告投放：
- OEM：该应用已作为设备固件或构建的一部分预安装。
- PAI: 应用通过 Play Auto Install 预先安装。
## 步骤 2. 创建追踪器 {#tracker}
1. 在Analytics module界面中，转到**跟踪** → **添加跟踪器**。
2. 输入跟踪器的名称。
3. 选择一个[媒体来源](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/add-partner.md)，以归因点击、安装和转换。
如果媒体源不在列表中，[添加新源](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/add-partner.md#add-partner)。
{% note info "" %}
一旦创建了跟踪器，就无法在设置中更改媒体源。
{% endnote %}
4. 指定 **预安装** 作为追踪器类型。
5. 根据您选择的技术启用或禁用**PAI**（Play Auto Install）选项。
## 步骤 3. (*可选*) 设置后传 {#postback}
预安装跟踪器支持后传，可自动将成功转换的数据发送到媒体源。 您可以为一个追踪器添加最多五个回传。 使用媒体源模板或配置自定义URL（带宏）。
## 第4步。 获取UTM标签和跟踪ID {#result}
- 如果您已启用**PAI**选项，请点击**生成**以获取唯一的`utm_campaign`标签。
- 如果您使用OEM预安装且**PAI**选项被禁用，右侧会出现`tracking_ID`。
## 第5步。 接下来怎么做？ {#next}
如果您使用PAI，请将UTM标签发送给您的媒体源或制造商，以便他们能在Google Play中使用它。
如果您使用 OEM 预安装，请配置 AppMetrica SDK：
{% list tabs %}
- Android
在使用[AppMetrica库的扩展配置](https://boost.yandex.com/doc/zh/analytics/content/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://boost.yandex.com/doc/zh/analytics/content/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 %}
| Parameter | 描述 |
| -------- | -------- |
| `API密钥` | 在Analytics module网页界面进行[应用注册](https://boost.yandex.com/application/new)时分配的唯一应用 ID。 |
| `跟踪ID` | 一个数字跟踪器 ID，在创建跟踪器时会显示在 Analytics module 界面中。 |
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。
联系支持
为文档提出改进建议