Configurare il plug-in Unity di Google Mobile Ads

Seleziona la piattaforma: Android Nuovo Android iOS Unity Flutter

Il plug-in Google Mobile Ads Unity consente agli sviluppatori Unity di pubblicare annunci Google per dispositivi mobili su app Android e 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
  • 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 pari o superiore a 23
    • Target livello API Android pari o superiore a 35

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 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 a 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. Apri le impostazioni di Package Manager selezionando l'opzione del menu Unity Edit > Project Settings > Package Manager (Modifica > Impostazioni progetto > 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 Package Manager selezionando l'opzione del menu Unity Window > Package Manager.

  4. Imposta il menu a discesa dell'ambito del gestore su My Registries (I miei registri).

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

Rimuovi gli asset del plug-in .unitypackage

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage a 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 l'ultima .unitypackage release da GitHub.
  2. Importa il file .unitypackage selezionando l'opzione del menu Unity Assets > Import package > Custom Package (Asset > Importa pacchetto > Pacchetto personalizzato) e importando tutti gli elementi.

Imposta l'ID app Ad Manager

Nell'editor Unity, seleziona Assets > Google Mobile Ads > Settings (Asset > Google Mobile Ads > Impostazioni) dal menu.

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

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.

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.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

Se utilizzi la mediazione, attendi che si verifichi il callback prima di caricare gli annunci per verificare che tutti gli adattatori di mediazione siano inizializzati.

Seleziona un formato dell'annuncio

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

Le unità pubblicitarie banner mostrano annunci rettangolari che occupano una porzione del layout dell'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. Definendo lo stile dell'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, partecipare a sondaggi o guardare video per vincere 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