Per iniziare

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

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

Prerequisiti

  • Utilizzare Unity 2019.4 o versioni successive
  • Per il deployment su iOS
    • Xcode 15.3 o successivo
    • Scegli come target iOS 12.0 o versioni successive
    • CocoaPods
  • Per il deployment su Android
    • Livello API Android minimo 21 o superiore
    • Livello API Android target 31 o successivo

Il livello API Android viene impostato in Impostazioni progetto > Player > Android > Altre impostazioni > Altre impostazioni.

Importa il plug-in Mobile Ads for Unity

OpenUPM-CLI

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

openupm add com.google.ads.mobile

Rimuovi .unitypackage asset plug-in

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage a OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. Rimuovi il le seguenti directory importate da .unitypackage:

  • Assets/ExternalDependencyManager
  • Asset/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 del gestore di pacchetti. selezionando l'opzione di menu Unity Modifica > Impostazioni progetto > Gestione pacchetti.

  2. Aggiungi OpenUPM come registro con ambito alla finestra Gestione pacchetti:

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

  3. Apri il menu del gestore di pacchetti selezionando l'icona Unity opzione di menu 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 di pacchetti. e premi Installa.

Rimuovi .unitypackage asset plug-in

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage a OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. Rimuovi il le seguenti directory importate da .unitypackage:

  • Assets/ExternalDependencyManager
  • Asset/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 versione più recente di .unitypackage da GitHub.
  2. Importa il file .unitypackage selezionando l'opzione di menu Unity Asset > Importa pacchetto > Pacchetto personalizzato e importare tutti gli elementi.

Includi dipendenze esterne

Il plug-in Unity di Google Mobile Ads è distribuito con Unity Play Services nella libreria del resolver. Questa libreria è destinato all'utilizzo da parte di qualsiasi plug-in Unity che richiede l'accesso a specifiche come AAR o iOS CocoaPods. Offre ai plug-in Unity la possibilità dichiarare le dipendenze, che vengono poi risolte e copiate automaticamente del tuo progetto Unity.

Segui questi passaggi per assicurarti che il progetto includa tutte le dipendenze:

Android

Vai a Impostazioni progetto > Player > Android > Impostazioni di pubblicazione > Creazione e seleziona:

  • Modello Gradle principale personalizzato
  • Modello di proprietà Gradle personalizzato

Nell'editor Unity, seleziona Assets > (Asset >) Gestore dipendenze esterno > Android Resolver > Risolvi per avere la libreria del gestore di dipendenze esterno di Unity copia le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

iOS

Unity per iOS utilizza CocoaPods per identificare e gestire le dipendenze. Consulta la documentazione di CocoaPods per requisiti specifici o passaggi per la risoluzione dei problemi relativi al tuo dispositivo iOS delle dipendenze.

Le dipendenze del plug-in Unity di Google Mobile Ads sono elencate in Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml.

Imposta l' AdMob ID dell'app

Nell'editor Unity, seleziona Assets > (Asset >) Annunci per cellulari di Google > Impostazioni dal menu.

Inserisci i tuoi dati Android e iOS ID app AdMob in ogni campo.

Inizializzare l'SDK

Prima di caricare gli annunci, chiedi all'app di inizializzare l'SDK Google Mobile Ads chiamata MobileAds.Initialize(). Questa operazione deve essere eseguita una sola volta, idealmente nella avvio dell'app.

Ecco un esempio di come chiamare Initialize() con il metodo Start() di uno script allegato a un GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Se utilizzi la mediazione, attendi che venga eseguito il callback prima di caricare gli annunci su assicura che tutti gli adattatori di mediazione siano inizializzati.

Seleziona un formato dell'annuncio

L'SDK Google Mobile Ads è ora incluso nella tua app Unity durante il deployment in sulla piattaforma Android o iOS. Ora puoi implementare un annuncio. AdMob offre diversi formati di annunci, per consentirti di scegliere quello più adatto alle tue esigenze per un'esperienza utente ottimale.

Le unità pubblicitarie banner mostrano annunci rettangolari che occupano una parte della layout. Possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Ciò significa Gli utenti visualizzano un nuovo annuncio a intervalli regolari, anche se rimangono invariati schermata nell'app. Inoltre, sono il formato dell'annuncio più semplice da implementare.

Implementare gli annunci banner

Interstitial

Le unità pubblicitarie interstitial mostrano annunci a pagina intera nella tua app. Posizionale nella posizione naturale interruzioni e transizioni nell'interfaccia dell'app, ad esempio al completamento di un livello in un'app di gioco.

Implementare gli annunci interstitial

Nativo

Gli annunci nativi sono annunci in cui puoi personalizzare il modo in cui asset, ad esempio titoli e gli inviti all'azione vengono presentati nelle tue app. Impostando lo stile dell'annuncio autonomamente, puoi creare presentazioni di annunci naturali e discrete che possano arricchire la presentazione un'esperienza senza intervento manuale.

Implementare gli annunci nativi

Con premio

Le unità pubblicitarie con premio consentono agli utenti di giocare, partecipare a sondaggi o guardare video guadagnare premi in-app, come monete, vite extra o punti. Puoi impostare premi diversi per unità pubblicitarie diverse e specifica i valori del premio e elementi ricevuti dall'utente.

Implementare gli annunci con premio

Interstitial con premio

Gli interstitial con premio sono un nuovo tipo di formato dell'annuncio incentivato che ti consente offrire premi, ad esempio monete o vite extra, per gli annunci visualizzati automaticamente durante le transizioni naturali delle app.

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

Invece della richiesta di attivazione negli annunci con premio, gli interstitial con premio richiedono un schermata introduttiva che annuncia il premio e offre agli utenti la possibilità di disattivarla se vogliano farlo.

Implementare gli annunci interstitial con premio

Apertura app

Apertura app è un formato dell'annuncio che viene visualizzato quando gli utenti aprono o tornano al tuo dell'app. L'annuncio si sovrappone alla schermata di caricamento.

Implementare gli annunci apertura app