Konfigurowanie wtyczki reklam mobilnych Google dla środowiska Unity

OpenUPM-CLI

Jeśli masz zainstalowany interfejs wiersza poleceń OpenUPM, możesz zainstalować rejestr OpenUPM za pomocą tego polecenia:

openupm add com.google.ads.mobile

Usuń .unitypackage komponent wtyczki

Jeśli przechodzisz z .unitypackage na OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji. Usuń te katalogi zaimportowane z .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 z interfejsem

1. Otwórz ustawienia menedżera pakietów, wybierając w menu Unity opcję Edit > Project Settings > Package Manager (Edytuj > Ustawienia projektu > Menedżer pakietów).

2. Dodaj OpenUPM jako rejestr o ograniczonym zakresie do okna Menedżera pakietów:

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

3. Otwórz menu menedżera pakietów, wybierając w Unity opcję Okno > Menedżer pakietów.

4. W menu zakresu menedżera wybierz Moje rejestry.

   

5. Na liście pakietów wybierz Google Mobile Ads for Unity i kliknij Install (Zainstaluj).

Usuń .unitypackage komponent wtyczki

Jeśli przechodzisz z .unitypackage na OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji. Usuń te katalogi zaimportowane z .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. Pobierz tag wersji najnowszej wersji. Zwrócony tag, z wyłączeniem prefiksu v, to wersja Google Mobile Ads Unity Plugin.

   • macOS i 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. Zmodyfikuj plik Packages/manifest.json, aby dodać rejestr i zależność OpenUPM, używając wersji uzyskanej za pomocą poprzedniego polecenia:

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

Usuń .unitypackage komponent wtyczki

Jeśli przechodzisz z .unitypackage na OpenUPM, musisz ręcznie odinstalować zasoby ze starej lokalizacji. Usuń te katalogi zaimportowane z .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

Importuj z GitHuba

1. Pobierz wersję .unitypackage z GitHuba.
2. Zaimportuj plik .unitypackage, wybierając opcję menu Unity Zasoby > Importuj pakiet > Pakiet niestandardowy i importując wszystkie elementy.

Opcjonalnie: wyłączanie External Dependency Managera

Jeśli zarządzasz bibliotekami Androida i iOS za pomocą własnych narzędzi do kompilacji, możesz wyłączyć pakiet com.unity.external-dependency-manager:

W edytorze Unity wybierz Window > Package Manager (Okno > Menedżer pakietów) i usuń pakiet External Dependency Manager (com.unity.external-dependency-manager). Usunięcie tego pakietu spowoduje odznaczenie opcji Włącz External Dependency Manager w sekcji Zasoby > Reklamy mobilne Google > Ustawienia.

Instalowanie starszej wersji Menedżera zależności zewnętrznych

Jeśli Twój projekt korzysta z Unity 2022.2 lub starszej wersji, po wyłączeniu pakietu Unity możesz zainstalować starszy pakiet com.google.external-dependency-manager Google:

• Pobierz najnowszy plik .unitypackage ze strony z wersjami External Dependency Manager for Unity i wybierz Assets > Import Package > Custom Package (Zasoby > Importuj pakiet > Pakiet niestandardowy).

• Uruchom to polecenie interfejsu wiersza poleceń OpenUPM:

  openupm add com.google.external-dependency-manager

Ręczne konfigurowanie zależności natywnych

Jeśli nie używasz pakietu External Dependency Manager, dodaj wymagane biblioteki z plików Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml i Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml do plików kompilacji:

• W przypadku Androida wybierz Edit > Project Settings > Player > Android > Publishing Settings > Build (Edytuj > Ustawienia projektu > Odtwarzacz > Android > Ustawienia publikowania > Kompilacja) i włącz Custom Main Gradle Template (Niestandardowy główny szablon Gradle). Dodaj wymagane biblioteki z plików GoogleMobileAdsDependencies.xml i GoogleUmpDependencies.xml do bloku dependencies w pliku 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'
  

  Dodaj też pakiety androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process i androidx.fragment:fragment, używając wersji z pliku GoogleMobileAdsDependencies.xml.

• W przypadku iOS wyeksportuj projekt Xcode. Dodaj wymagane pody z plików GoogleMobileAdsDependencies.xml i GoogleUmpDependencies.xml do pliku Podfile w wyeksportowanym folderze projektu:

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

  Następnie uruchom to polecenie w wyeksportowanym folderze projektu na iOS:

  pod install --repo-update