Configurare il plug-in Unity di Google Mobile Ads

Seleziona la piattaforma: Android (beta) Nuovo Android iOS Unity Flutter

Il plug-in Google Mobile Ads Unity consente agli sviluppatori Unity di pubblicare annunci Google Mobile Ads nelle app per 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

  • Utilizzare 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 35 o versioni successive

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

Importare 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

Rimuovere gli asset del plug-in .unitypackage

Se stai eseguendo la migrazione dall'utilizzo di un file .unitypackage a OpenUPM, devi disinstallare manualmente gli asset dalla vecchia posizione. Rimuovi le seguenti directory importate dal file .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 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 (I miei registri).

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

Rimuovere gli asset del plug-in .unitypackage

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

Impostare 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.

Inizializzare l'SDK

Prima di caricare gli annunci, l'app deve inizializzare Google Mobile Ads Unity Plugin by 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 la ricezione del callback prima di caricare gli annunci per verificare che tutti gli adattatori di mediazione siano inizializzati.

Selezionare 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 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 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.

Implementare 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.

Implementare 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.

Implementare 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.

Implementare gli annunci con premio