Google Mobile Ads Unity-Plug-in einrichten

OpenUPM-CLI

Wenn Sie die OpenUPM-Befehlszeile installiert haben, können Sie die OpenUPM-Registry mit dem folgenden Befehl installieren:

openupm add com.google.ads.mobile

.unitypackage Plug-in-Assets entfernen

Wenn Sie von einem .unitypackage zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren. Entfernen Sie die folgenden Verzeichnisse, die aus .unitypackage importiert wurden:

• 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 mit UI

1. Öffnen Sie die Einstellungen des Paketmanagers, indem Sie im Unity-Menü die Option Edit > Projekteinstellungen > Paketmanager auswählen.

2. Fügen Sie OpenUPM als bereichsbezogene Registry im Fenster „Package Manager“ hinzu:

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

3. Öffnen Sie das Paketmanager-Menü, indem Sie die Unity-Menüoption Fenster > Paketmanager auswählen.

4. Wählen Sie im Drop-down-Menü für den Managerbereich Meine Registries aus.

   

5. Wählen Sie das Paket Google Mobile Ads for Unity aus der Paketliste aus und klicken Sie auf Install (Installieren).

.unitypackage Plug-in-Assets entfernen

Wenn Sie von einem .unitypackage zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren. Entfernen Sie die folgenden Verzeichnisse, die aus .unitypackage importiert wurden:

• 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. Rufen Sie das Versions-Tag des neuesten Release ab. Das zurückgegebene Tag ohne das Präfix v ist die Version Google Mobile Ads Unity Plugin.

   • macOS und 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. Ändern Sie die Datei Packages/manifest.json, um die OpenUPM-Registry und die Abhängigkeit hinzuzufügen. Verwenden Sie dazu die Version, die Sie mit dem vorherigen Befehl erhalten haben:

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

.unitypackage Plug-in-Assets entfernen

Wenn Sie von einem .unitypackage zu OpenUPM migrieren, müssen Sie die Assets manuell vom alten Speicherort deinstallieren. Entfernen Sie die folgenden Verzeichnisse, die aus .unitypackage importiert wurden:

• 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

Aus GitHub importieren

1. Laden Sie den Release .unitypackage von GitHub herunter.
2. Importieren Sie die Datei .unitypackage, indem Sie die Unity-Menüoption Assets > Import package > Custom Package auswählen und alle Elemente importieren.

Optional: External Dependency Manager deaktivieren

Wenn Sie Android- und iOS-Bibliotheken mit Ihren eigenen Build-Tools verwalten, können Sie das com.unity.external-dependency-manager-Paket deaktivieren:

Wählen Sie im Unity-Editor Window > Package Manager aus und entfernen Sie das Paket External Dependency Manager (com.unity.external-dependency-manager). Wenn Sie dieses Paket entfernen, wird die Option Enable External Dependency Manager (External Dependency Manager aktivieren) unter Assets > Google Mobile Ads > Einstellungen deaktiviert.

Legacy-External Dependency Manager installieren

Wenn in Ihrem Projekt Unity 2022.2 oder früher verwendet wird, können Sie das alte com.google.external-dependency-manager-Paket von Google installieren, nachdem Sie das Unity-Paket deaktiviert haben:

• Laden Sie die aktuelle .unitypackage-Datei von der Seite mit den Releases des External Dependency Manager for Unity herunter und wählen Sie Assets > Import Package > Custom Package aus.

• Führen Sie den folgenden OpenUPM-CLI-Befehl aus:

  openupm add com.google.external-dependency-manager

Native Abhängigkeiten manuell konfigurieren

Wenn Sie kein External Dependency Manager-Paket verwenden, fügen Sie die erforderlichen Bibliotheken aus den Dateien Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml und Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml Ihren Build-Dateien hinzu:

• Wählen Sie für Android Edit > Projekteinstellungen > Player > Android > Publishing Settings > Build aus und aktivieren Sie Custom Main Gradle Template. Fügen Sie die erforderlichen Bibliotheken aus den Dateien GoogleMobileAdsDependencies.xml und GoogleUmpDependencies.xml dem Block dependencies in der Datei Assets/Plugins/Android/mainTemplate.gradle hinzu:

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

  Fügen Sie außerdem die Pakete androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process und androidx.fragment:fragment mit den Versionen aus der Datei GoogleMobileAdsDependencies.xml hinzu.

• Exportieren Sie für iOS Ihr Xcode-Projekt. Fügen Sie die erforderlichen Pods aus den Dateien GoogleMobileAdsDependencies.xml und GoogleUmpDependencies.xml der Datei Podfile in Ihrem exportierten Projektordner hinzu:

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

  Führen Sie dann den folgenden Befehl in Ihrem exportierten iOS-Projektordner aus:

  pod install --repo-update