Как настроить плагин Google Mobile Ads для Unity

OpenUPM-CLI

Если у вас установлен OpenUPM CLI, вы можете установить реестр OpenUPM с помощью следующей команды:

openupm add com.google.ads.mobile

Удалить .unitypackage объект плагина

Если вы переходите с .unitypackage на OpenUPM, вам нужно вручную удалить объекты из старого местоположения. Удалите следующие каталоги, импортированные из .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM с интерфейсом

1. Откройте настройки менеджера пакетов, выбрав в меню Unity Edit (Редактировать) > Project Settings (Настройки проекта) > Package Manager (Менеджер пакетов).

2. Добавьте OpenUPM в качестве реестра с ограниченной областью действия в окне Package Manager (Менеджер пакетов):

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. Откройте меню менеджера пакетов, выбрав в меню Unity Window (Окно) > Package Manager (Менеджер пакетов).

4. В раскрывающемся списке "Область действия менеджера" выберите Мои реестры.

   

5. Выберите пакет Google Mobile Ads for Unity из списка и нажмите Install (Установить).

Удалить .unitypackage объект плагина

Если вы переходите с .unitypackage на OpenUPM, вам нужно вручную удалить объекты из старого местоположения. Удалите следующие каталоги, импортированные из .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. Получите тег версии последнего выпуска. Возвращенный тег без префикса v – это версия Google Mobile Ads Unity Plugin.

   • macOS и Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. Измените файл Packages/manifest.json, чтобы добавить реестр и зависимость с областью действия OpenUPM, используя версию, полученную из предыдущей команды:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

Удалить .unitypackage объект плагина

Если вы переходите с .unitypackage на OpenUPM, вам нужно вручную удалить объекты из старого местоположения. Удалите следующие каталоги, импортированные из .unitypackage:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

Импортировать из GitHub

1. Скачайте выпуск .unitypackage с сайта GitHub.
2. Импортируйте файл .unitypackage, выбрав в меню Unity Assets (Объекты) > Import package (Импортировать пакет) > Custom Package (Пользовательский пакет), и импортируйте все элементы.

Как отключить External Dependency Manager (необязательно)

Если вы управляете библиотеками Android и iOS с помощью собственных инструментов сборки, вы можете отключить пакет com.unity.external-dependency-manager:

В редакторе Unity выберите Window (Окно) > Package Manager (Менеджер пакетов) и удалите пакет External Dependency Manager (Менеджер внешних зависимостей) (com.unity.external-dependency-manager). При удалении этого пакета будет снят флажок Enable External Dependency Manager (Включить External Dependency Manager) в разделе Assets (Объекты) > Google Mobile Ads > Settings (Настройки).

Установите устаревший External Dependency Manager

Если в вашем проекте используется Unity 2022.2 или более ранняя версия, вы можете установить устаревший пакет Google com.google.external-dependency-manager, отключив пакет Unity:

• Скачайте последнюю версию файла .unitypackage со страницы External Dependency Manager for Unity и выберите Assets (Объекты) > Import Package (Импортировать пакет) > Custom Package (Пользовательский пакет).

• Выполните следующую команду OpenUPM CLI:

  openupm add com.google.external-dependency-manager

Как настроить нативные зависимости вручную

Если вы не используете пакет External Dependency Manager, добавьте необходимые библиотеки из файлов Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml и Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml в файлы сборки:

• Для Android выберите Edit (Изменить) > Project Settings (Настройки проекта) > Player (Проигрыватель) > Android > Publishing Settings (Настройки публикации) > Build (Сборка) и включите Custom Main Gradle Template (Пользовательский основной шаблон Gradle). Добавьте необходимые библиотеки из файлов GoogleMobileAdsDependencies.xml и GoogleUmpDependencies.xml в блок dependencies файла Assets/Plugins/Android/mainTemplate.gradle:

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  Также добавьте пакеты androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process и androidx.fragment:fragment, используя версии из файла GoogleMobileAdsDependencies.xml.

• Для iOS экспортируйте проект Xcode. Добавьте необходимые группы контейнеров из файлов GoogleMobileAdsDependencies.xml и GoogleUmpDependencies.xml в файл Podfile в папке экспортированного проекта:

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  Затем выполните следующую команду в папке экспортированного проекта iOS:

  pod install --repo-update