Интеграция через Unity Package Manager

Package Manager во вкладке Project Settings редактора Unity вместе с публичным реестром OpenUPM позволяет подключать зависимости Yandex Mobile Ads без ручного импорта .unitypackage. Так вы можете установить основной пакет SDK и при необходимости отдельные пакеты адаптеров рекламных сетей из списка поддерживаемых адаптеров. Для подключения медиации используйте пакет Yandex Mobile Ads Mediation plugin for Unity.

Примечание

Адаптер — это модуль, который обеспечивает «прослойку» между рекламной сетью Яндекса и сторонней рекламной сетью.

Подключение через OpenUPM

Подключение OpenUPM Registry
  1. В верхнем меню Unity выберите Edit → Project Settings. В новом окне слева выберите Package Manager:

  2. Добавьте реестр с именем OpenUPM и полями:

    • URL — https://package.openupm.com.
    • Scopes с двумя значениями — com.yandex и com.google.
Интеграция iOS или Android

Yandex SDK 7.16.0+

Подключение через UPM, начиная с версии 7.16.0, актуально для всех поддерживаемых версий платформы Unity.

Перейдите на вкладку Yandex Mobile Ads в OpenUPM и установите необходимый пакет Yandex Mobile Ads plugin for Unity .

Важно

После установки SDK появится окно о включении External Dependency Manager. Нажмите Enable для разрешения зависимостей.

Yandex SDK 7.14.x и 7.15.x

Инструкция ниже актуальна только для минорных 14 и 15 версий Yandex SDK.

Интеграция с Unity 2023 и ниже
  1. Перейдите на вкладку Yandex Mobile Ads в OpenUPM и установите необходимый пакет Yandex Mobile Ads Mediation plugin for Unity.

    Важно

    После установки SDK появится окно о включении External Dependency Manager. Нажмите Enable для разрешения зависимостей.

  2. В дереве проекта Unity зайдите в папку Assets/Plugins/Android и откройте mainTemplate.gradle.

  3. В главном блоке зависимостей Dependencies в начале файла добавьте блок кода (вторая зависимость на сниппете). Версии библиотек должны иметь одинаковую мажорную и минорную версию. Это можно проверить в нашем официальном репозитории.

    dependencies {
    	// ... other dependencies
    	implementation("com.yandex.android:mobileads:7.15.1") // Основной пакет, который установлен через UPM
    
    	// Добавляем эти строки к существующим зависимостям
    	implementation("com.yandex.android:mobileads:7.15.0-unity") {
    		force = true
    	}
    }
    

Подключение вручную через импорт пакетов SDK

Интеграция iOS или Android

Yandex SDK 7.16.0+

Подключение через UPM, начиная с версии 7.16.0, актуально для всех поддерживаемых версий платформы Unity.

  1. Откройте наш репозиторий в GitHub и скачайте пакет:

    yandex-mobileads-lite-8.0.0.unitypackage
    
  2. В верхнем меню Unity Assets/Import Package/Custom Package выберите скачанный ранее пакет.

    Важно

    После установки SDK появится окно о включении External Dependency Manager. Нажмите Enable для разрешения зависимостей.

Yandex SDK 7.14.x и 7.15.x

Инструкция ниже актуальна только для минорных 14 и 15 версий Yandex SDK.

Интеграция единой сборки c Unity 2023 и ниже
  1. Откройте наш репозиторий в GitHub и скачайте пакет:

    yandex-mobileads-lite-7.15.1.unitypackage
    

    Важно

    После установки SDK появится окно о включении External Dependency Manager. Нажмите Enable для разрешения зависимостей.

  2. В дереве проекта Unity зайдите в папку Assets/Plugins/Android и откройте mainTemplate.gradle.

  3. В главном блоке зависимостей Dependencies в начале файла добавьте блок кода (вторая зависимость на сниппете). Версии библиотек должны иметь одинаковую мажорную и минорную версию. Это можно проверить в нашем официальном репозитории.

    dependencies {
        // ... other dependencies
        implementation("com.yandex.android:mobileads:7.15.1") // Основной пакет, который установлен через UPM
        implementation("com.yandex.android:mobileads:7.15.0-unity") {
            force = true
        }
    }