---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://appmetrica.yandex.com/docs/en/sdk/unity/analytics/quick-start.md
  - https://appmetrica.yandex.com/docs/ru/sdk/unity/analytics/quick-start.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com/docs/ru/llms.txt

# Подключение и инициализация

AppMetrica Unity — плагин для игровой платформы [Unity3d](http://docs.unity3d.com/). Он включает поддержку AppMetrica SDK для Android и iOS.

Ниже описаны этапы подключения и инициализации AppMetrica Unity Plugin:

## Шаг 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. Подключите External Dependency Manager согласно [документации](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}

Рекомендуется активировать AppMetrica используя [RuntimeInitializeOnLoadMethodAttribute](https://docs.unity3d.com/ScriptReference/RuntimeInitializeOnLoadMethodAttribute.html).

Создайте static метод с атрибутом `[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]` и произведите активацию AppMetrica с помощью метода `AppMetrica.Activate()`.

Пример:

```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}

- [Настройка отправки событий Ecommerce](https://appmetrica.yandex.com/docs/ru/sdk/unity/analytics/unity-operations.md#send-ecommerce)
- [Настройка отправки событий Revenue](https://appmetrica.yandex.com/docs/ru/sdk/unity/analytics/unity-operations.md#send-revenue)
- [Настройка отправки событий Ad Revenue](https://appmetrica.yandex.com/docs/ru/sdk/unity/analytics/unity-operations.md#send-adrevenue)
- [Как включить отправку данных о местоположении пользователей?](https://appmetrica.yandex.com/docs/ru/troubleshooting/troubleshooting.md#region)

<!-- source: ru/_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: ru/_includes/feedback-button-3.md -->