Configurare il plug-in Unity di Google Mobile Ads

Seleziona la piattaforma: Android iOS Unity Flutter Android (legacy)

Il plug-in Unity di Google Mobile Ads consente agli sviluppatori Unity di pubblicare annunci Google per dispositivi mobili su app per Android e iOS senza dover scrivere codice Java o Objective-C. Il plug-in fornisce un'interfaccia C# per la richiesta di annunci utilizzata dagli script C# nel tuo progetto Unity.

Questa guida è rivolta ai publisher che vogliono monetizzare un'app Unity.

Prerequisiti

  • Utilizza Unity Editor 2019.4 o versioni successive.
    • Consigliamo la versione 2022.2 o successive.
  • Per eseguire il deployment su iOS
    • Xcode 16.0 o versioni successive
    • Target iOS 13.0 o versioni successive
    • CocoaPods
  • Per eseguire il deployment su Android
    • Livello API Android minimo pari o superiore a 24
    • Target Android API level 35 or higher

Il livello API Android è impostato in Project Settings > Player > Android > Other Settings > Other Settings (Impostazioni progetto > Player > Android > Altre impostazioni > Altre impostazioni).

Importa il plug-in Mobile Ads per Unity

OpenUPM-CLI

Se hai installato l'interfaccia a riga di comando OpenUPM, puoi installare il registry OpenUPM con il seguente comando:

openupm add com.google.ads.mobile

Rimuovi .unitypackage asset del plug-in

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage all'utilizzo di OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. Rimuovi le seguenti directory importate da .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 con UI

  1. Apri le impostazioni di Gestione pacchetti selezionando l'opzione di menu di Unity Edit > Project Settings > Package Manager.

  2. Aggiungi OpenUPM come registry con ambito alla finestra Package Manager:

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

  3. Apri il menu Gestione pacchetti selezionando l'opzione di menu di Unity Finestra > Gestione pacchetti.

  4. Imposta il menu a discesa dell'ambito del gestore per selezionare I miei registri.

  5. Seleziona il pacchetto Google Mobile Ads per Unity dall'elenco dei pacchetti e premi Installa.

Rimuovi .unitypackage asset del plug-in

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage all'utilizzo di OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. Rimuovi le seguenti directory importate da .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. Recupera il tag della versione più recente. Il tag restituito, escluso il prefisso v, è la versione Google Mobile Ads Unity Plugin.

    • macOS e 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. Modifica il file Packages/manifest.json per aggiungere il registro con ambito OpenUPM e la dipendenza utilizzando la versione ottenuta dal comando precedente:

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

Rimuovi .unitypackage asset del plug-in

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage all'utilizzo di OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. Rimuovi le seguenti directory importate da .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

Importa da GitHub

  1. Scarica la release .unitypackage da GitHub.
  2. Importa il file .unitypackage selezionando l'opzione di menu di Unity Asset > Importa pacchetto > Pacchetto personalizzato e importando tutti gli elementi.

(Facoltativo) Disattiva External Dependency Manager

Se gestisci le librerie Android e iOS con i tuoi strumenti di build, puoi disattivare il pacchetto com.unity.external-dependency-manager:

Nell'editor di Unity, seleziona Finestra > Gestione pacchetti e rimuovi il pacchetto External Dependency Manager (com.unity.external-dependency-manager). La rimozione di questo pacchetto cancella l'opzione Enable External Dependency Manager (Attiva External Dependency Manager) in Assets > Google Mobile Ads > Settings (Asset > Google Mobile Ads > Impostazioni).

Installa External Dependency Manager legacy

Se il tuo progetto utilizza Unity 2022.2 o versioni precedenti, puoi installare il pacchetto com.google.external-dependency-manager legacy di Google dopo aver disattivato il pacchetto di Unity:

Configura manualmente le dipendenze native

Se non utilizzi un pacchetto External Dependency Manager, aggiungi le librerie richieste dai file Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml e Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml ai file di build:

  • Per Android, seleziona Edit > Impostazioni progetto > Player > Android > Publishing Settings > Build e attiva Custom Main Gradle Template. Aggiungi le librerie richieste dai file GoogleMobileAdsDependencies.xml e GoogleUmpDependencies.xml al blocco dependencies nel file 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'

    Aggiungi anche i pacchetti androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process e androidx.fragment:fragment utilizzando le versioni nel file GoogleMobileAdsDependencies.xml.

  • Per iOS, esporta il progetto Xcode. Aggiungi i pod richiesti dai file GoogleMobileAdsDependencies.xml e GoogleUmpDependencies.xml al file Podfile nella cartella del progetto esportato:

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

    Poi esegui questo comando nella cartella del progetto iOS esportato:

    pod install --repo-update

Imposta l'ID app Ad Manager

Nell'editor di Unity, seleziona Assets > Google Mobile Ads > Settings dal menu.

Inserisci l'ID app Ad Manager per Android e iOS in ogni campo.

Google Mobile Ads Unity Plugin salva queste impostazioni come testo nel file di configurazione Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset.

Inizializza l'SDK

Prima di caricare gli annunci, inizializza Google Mobile Ads Unity Plugin nella tua app chiamando MobileAds.Initialize(). Questa operazione deve essere eseguita una sola volta, idealmente al lancio dell'app.

Ecco un esempio di come chiamare MobileAds.Initialize():

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});

Interagisci con gli oggetti Unity sul thread principale

Google Mobile Ads Unity Plugin genera eventi di annunci su un thread in background. Se i callback degli annunci interagiscono con oggetti Unity, come UnityEngine, pianifica esplicitamente l'attività sul thread principale di Unity utilizzando il metodo MobileAdsEventExecutor.ExecuteInUpdate. Per i dettagli sull'implementazione, consulta Genera eventi relativi agli annunci nel thread principale di Unity.

Seleziona un formato dell'annuncio

Google Mobile Ads Unity Plugin è ora incluso nella tua app Unity quando esegui il deployment sulla piattaforma Android o iOS. Ora puoi implementare un annuncio. AdMob offre diversi formati degli annunci, così puoi scegliere quello che offre la migliore esperienza utente.

Le unità pubblicitarie banner mostrano annunci banner rettangolari che occupano una porzione del layout di un'app. possono essere aggiornate automaticamente dopo un determinato periodo di tempo. Ciò significa che gli utenti vedono un nuovo annuncio a intervalli regolari, anche se rimangono sulla stessa schermata della tua app. Inoltre, questo è il formato dell'annuncio più facile da implementare.

Implementa gli annunci banner

Interstitial

Le unità pubblicitarie interstitial mostrano annunci a schermo intero nell'app. Posiziona gli annunci in un punto in cui nell'interfaccia dell'app si verifica una pausa naturale o una transizione, ad esempio dopo il completamento di un livello in un'app di gioco.

Implementa gli annunci interstitial

Nativo

Gli annunci nativi sono annunci in cui puoi personalizzare il modo in cui asset come titoli e inviti all'azione vengono presentati nelle tue app. Se definisci lo stile dell'annuncio, puoi creare presentazioni degli annunci naturali e non invasive che possono contribuire a un'esperienza utente completa.

Implementa gli annunci nativi

Con premio

Le unità pubblicitarie con premio consentono agli utenti di giocare, rispondere a sondaggi o guardare video per guadagnare premi in-app, come monete, vite extra o punti. Puoi impostare premi distinti per le varie unità pubblicitarie, specificare quelli che riceveranno gli utenti e il relativo valore.

Implementa gli annunci con premio