---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://appmetrica.yandex.com.tr/docs/en/sdk/unity/analytics/quick-start.md
  - https://appmetrica.yandex.com.tr/docs/ru/sdk/unity/analytics/quick-start.md
  - https://appmetrica.yandex.com.tr/docs/zh/sdk/unity/analytics/quick-start.md
  - href: https://appmetrica.yandex.com.tr/docs/zh/sdk/unity/analytics/quick-start.md
    type: text/markdown
    title: Markdown version
  - href: https://appmetrica.yandex.com.tr/docs/zh/llms.txt?revision=r21975373
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com.tr/docs/zh/llms.txt?revision=r21975373

# 安装和初始化

AppMetrica Unity 是为 [Unity3d](http://docs.unity3d.com/) 平台开发的插件。 它包含 AppMetrica SDK 对 Android 和 iOS 的支持。

此部分介绍如何启用并初始化 AppMetrica Unity 插件：

## 步骤 1. 启用 AppMetrica Unity 插件 {#integration}

{% list tabs %}

- OpenUPM

  将以下依赖项添加到 [Packages/manifest.json](https://docs.unity3d.com/Manual/upm-manifestPrj.html)：

     ```json translate=no
     {
       "scopedRegistries": [
         {
           "name": "package.openupm.com",
           "url": "https://package.openupm.com",
           "scopes": [
             "com.google.external-dependency-manager",
             "io.appmetrica.analytics"
           ]
         }
       ],
       "dependencies": {
         "com.google.external-dependency-manager": "1.2.187",
         "io.appmetrica.analytics": "6.10.0"
       }
     }
     ```

- UPM (GitHub)

  1. 根据[文档](https://github.com/googlesamples/unity-jar-resolver/tree/master?tab=readme-ov-file#getting-started)启用外部依赖管理器。

  2. 将 AppMetrica Unity Plugin 添加到 [Packages/manifest.json](https://docs.unity3d.com/Manual/upm-manifestPrj.html) 中的依赖项：

     ```json translate=no
     {
       "dependencies": {
         "io.appmetrica.analytics": "https://github.com/appmetrica/appmetrica-unity-plugin.git#v6.10.0"
       }
     }
     ```

{% endlist %}

## 步骤 2. 初始化库 {#initialization}

我们建议使用 [RuntimeInitializeOnLoadMethodAttribute](https://docs.unity3d.com/ScriptReference/RuntimeInitializeOnLoadMethodAttribute.html) 激活 AppMetrica。

创建一个静态方法，添加 `[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]` 属性，然后使用 `AppMetrica.Activate()` 方法激活 AppMetrica。

Example:

```csharp translate=no
using Io.AppMetrica;
using UnityEngine;

public static class AppMetricaActivator {
    [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
    private static void Activate() {
        AppMetrica.Activate(new AppMetricaConfig("APIKey") {
            FirstActivationAsUpdate = !IsFirstLaunch(),
        });
    }

    private static bool IsFirstLaunch() {
        // Implement logic to detect whether the app is opening for the first time.
        // For example, you can check for files (settings, databases, and so on),
        // which the app creates on its first launch.
        return true;
    }
}
```

## 了解更多 {#learn-more}

- [发送电商事件](https://appmetrica.yandex.com.tr/docs/zh/sdk/unity/analytics/unity-operations.md#send-ecommerce)
- [发送收入数据](https://appmetrica.yandex.com.tr/docs/zh/sdk/unity/analytics/unity-operations.md#send-revenue)
- [发送广告收入数据](https://appmetrica.yandex.com.tr/docs/zh/sdk/unity/analytics/unity-operations.md#send-adrevenue)
- [如何启用发送用户位置？](https://appmetrica.yandex.com.tr/docs/zh/troubleshooting/troubleshooting.md#region)

<!-- source: zh/_includes/feedback-button-3.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/_includes/feedback-button-3.md -->