Configurare il plug-in Unity di Google Mobile Ads

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

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

Questa guida è destinata 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 il deployment su iOS
  • Xcode 16.0 o versioni successive
  • Target iOS 13.0 o versioni successive
  • CocoaPods
• Per il deployment su Android
  • Livello API Android minimo 24 o versioni successive
  • Target livello API Android 35 o versioni successive

• (Consigliato) Crea un account AdMob e registra un'app per iOS

Il livello API Android è impostato in Impostazioni progetto > Player > Android > Other Settings > Other Settings.

Importa il plug-in Mobile Ads for Unity

OpenUPM-CLI

Se hai installato OpenUPM CLI, puoi installare il registro OpenUPM con il seguente comando:

openupm add com.google.ads.mobile

Rimuovi gli asset del plug-in .unitypackage

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage all'utilizzo di OpenUPM, devi disinstallare manualmente gli asset dalla vecchia posizione. 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 Package Manager selezionando l'opzione del menu Unity Edit > Project Settings > Package Manager.

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

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

3. Apri il menu di Package Manager selezionando l'opzione del menu Unity Window > Package Manager.

4. Imposta il menu a discesa dell'ambito del gestore su My Registries.

   

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

Rimuovi gli asset del plug-in .unitypackage

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage all'utilizzo di OpenUPM, devi disinstallare manualmente gli asset dalla vecchia posizione. 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 della release 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 e la dipendenza con ambito OpenUPM 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 gli asset del plug-in .unitypackage

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage all'utilizzo di OpenUPM, devi disinstallare manualmente gli asset dalla vecchia posizione. 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 .unitypackage release da GitHub.
2. Importa il file .unitypackage selezionando l'opzione del menu Unity Assets > Import package > Custom Package 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:

In Unity Editor, seleziona Window > Package Manager e rimuovi il pacchetto External Dependency Manager (com.unity.external-dependency-manager). La rimozione di questo pacchetto cancella Enable External Dependency Manager in Assets > Google Mobile Ads > Settings.

Nota: l'eliminazione del file GoogleMobileAdsSettings.asset reimposta le impostazioni e reinstalla il pacchetto com.unity.external-dependency-manager al successivo caricamento dell'importazione o dell'editor. Per reinstallare il pacchetto in un secondo momento, seleziona Assets > Google Mobile Ads > Settings e Enable External Dependency Manager.

Installa la versione precedente di External Dependency Manager

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

• Scarica l'ultimo file .unitypackage dalla pagina delle release di External Dependency Manager for Unity e seleziona Assets > Import Package > Custom Package.

• Esegui il seguente comando OpenUPM CLI:

  openupm add com.google.external-dependency-manager

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 > Project Settings > 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'
  

  Quindi, esegui il seguente comando nella cartella del progetto iOS esportato:

  pod install --repo-update

Imposta l'ID della tua app monetizzata con AdMob

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

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

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

Inizializza l'SDK

Prima di caricare gli annunci, fai in modo che la tua app inizializzi Google Mobile Ads Unity Plugin chiamando MobileAds.Initialize(). Questa operazione deve essere eseguita una sola volta, idealmente all'avvio dell'app.

Avviso: gli annunci possono essere precaricati da Google Mobile Ads Unity Plugin o dagli SDK dei partner di mediazione quando viene chiamato MobileAds.Initialize(). Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), nel Regno Unito o in Svizzera, imposta eventuali flag specifici della richiesta, ad esempio tagForChildDirectedTreatment o tag_for_under_age_of_consent, o intraprendi altre azioni prima di caricare gli annunci. Assicurati di eseguire questa operazione prima di inizializzare Google Mobile Ads Unity Plugin.

Di seguito è riportato 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.
    });
});
GoogleMobileAdsController.cs

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 gli oggetti Unity, ad esempio UnityEngine, pianifica esplicitamente il lavoro sul thread principale di Unity utilizzando il metodo MobileAdsEventExecutor.ExecuteInUpdate. Per informazioni dettagliate sull'implementazione, vedi Generare eventi di annunci sul thread principale di Unity.

Seleziona un formato dell'annuncio

Google Mobile Ads Unity Plugin è ora incluso nell'app Unity quando esegui il deployment su sulla piattaforma Android o iOS. Ora puoi implementare un annuncio. AdMob offre diversi formati di annunci, quindi puoi scegliere quello che offre la migliore esperienza utente.

Banner

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 vedranno 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 la modalità di presentazione degli asset, come titoli e inviti all'azione, nelle tue app. Applicando uno stile personalizzato all'annuncio, puoi creare presentazioni di annunci naturali e non intrusive che possono arricchire l'esperienza utente.

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

Interstitial con premio

"Interstitial con premio" è un nuovo tipo di formato dell'annuncio con incentivi che consente di offrire premi, ad esempio monete o vite extra, per gli annunci che vengono visualizzati automaticamente durante le normali transizioni dell'app.

A differenza degli annunci con premio, gli utenti non devono attivare la visualizzazione degli annunci interstitial con premio.

Invece della richiesta di attivazione degli annunci con premio, quelli interstitial con premio prevedono una schermata introduttiva che annuncia il premio e offre agli utenti la possibilità di disattivare l'annuncio.

Implementa gli annunci interstitial con premio

Apertura app

Apertura app è un formato dell'annuncio visualizzato quando gli utenti aprono la tua app o vi tornano. L'overlay annuncio si sovrappone alla schermata di caricamento.

Implementa gli annunci apertura app