Per iniziare

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

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

Prerequisiti

• Utilizza Unity 2019.4 o versioni successive
• Per eseguire il deployment su iOS
  • Xcode 15.3 o superiore
  • Scegli come target iOS 12.0 o versioni successive
  • CocoaPods
• Per eseguire il deployment su Android
  • Livello API Android minimo 21
  • Effettuare il targeting del livello API Android 31 o superiore

• Consigliato: crea un account AdMob e registra un'app per Android o iOS

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

Importa il plug-in Mobile Ads for Unity

Il plug-in Google Mobile Ads for Unity viene distribuito come .unitypackage sui nostri repository GitHub e OpenUPM.

Importa da GitHub

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

Importa con OpenUPM

Installa il registro OpenUPM con l'interfaccia a riga di comando OpenUPM

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

openupm add com.google.ads.mobile

Installare manualmente il registro 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
   

Installa il pacchetto Google Mobile Ads per Unity

1. Apri il menu Gestione pacchetti selezionando l'opzione del menu Unity Finestra > Gestione pacchetti.

2. Imposta il menu a discesa ambito gestore per selezionare I miei registri.

   

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

Includi dipendenze esterne

Il plug-in Unity di Google Mobile Ads è distribuito con la libreria resolver Unity Play Services. Questa libreria è destinata all'utilizzo da parte di qualsiasi plug-in Unity che richiede l'accesso a librerie specifiche per Android, come AAR o CocoaPods per iOS. Consente ai plug-in Unity di dichiarare le dipendenze, che vengono poi risolte e copiate automaticamente nel progetto Unity.

Importante: usa la versione più recente dell'SDK Google Mobile Ads in modo da avere accesso a tutte le funzionalità di conformità alla privacy.

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

Android

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

• Modello Gradle principale personalizzato
• Modello proprietà Gradle personalizzato

Nell'editor Unity, seleziona Asset > Gestore dipendenze esterno > Sistema di risoluzione Android > Risolvi per fare in modo che la libreria del Gestore delle dipendenze esterno di Unity copi le dipendenze dichiarate nella directory Assets/Plugins/Android dell'app Unity.

iOS

Non sono necessari passaggi aggiuntivi per includere l'SDK Google Mobile Ads nel progetto Unity.

Le dipendenze per iOS vengono identificate tramite CocoaPods. CocoaPods viene eseguito come passaggio del processo post-creazione.

• Quando utilizzi Unity 5.6 o successive, viene generata una risorsa xcworkspace che include le librerie di dipendenze richieste. Utilizza la sezione xcworkspace generata anziché il progetto Xcode standard.
• Quando utilizzi versioni precedenti di Unity, le dipendenze sono incluse nel progetto Xcode standard.

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

Imposta il tuo AdMob ID app

Nell'editor Unity, seleziona Asset > Annunci per dispositivi mobili Google > Impostazioni dal menu.

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

Inizializza l'SDK

Prima di caricare gli annunci, fai in modo che la tua app inizializza l'SDK Google Mobile Ads chiamando MobileAds.Initialize(). Questa operazione deve essere eseguita una sola volta, idealmente al momento del lancio dell'app.

Avviso: gli annunci possono essere precaricati dall'SDK Google Mobile Ads o dagli SDK del partner di mediazione al momento della chiamata al numero MobileAds.Initialize(). Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), imposta segnalazioni specifiche per le richieste, ad esempio tagForChildDirectedTreatment o tag_for_under_age_of_consent, oppure prendi provvedimenti prima di caricare gli annunci. Assicurati di farlo prima di inizializzare l'SDK Google Mobile Ads.

Ecco un esempio di come chiamare Initialize() all'interno del metodo Start() di uno script collegato 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 per assicurarti che tutti gli adattatori di mediazione vengano inizializzati.

Seleziona un formato dell'annuncio

L'SDK Google Mobile Ads è ora incluso nell'app Unity quando esegui il deployment sulla piattaforma Android o iOS. Ora tutto è pronto per implementare un annuncio. AdMob offre una serie di formati di annunci diversi, tra cui scegliere quello che offre la migliore esperienza utente.

Banner

Le unità pubblicitarie banner mostrano annunci rettangolari che occupano una parte del layout dell'app. Possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Ciò significa che gli utenti visualizzano un nuovo annuncio a intervalli regolari, anche se rimangono nella stessa schermata dell'app. Sono inoltre 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. Posizionali in corrispondenza di interruzioni e transizioni naturali nell'interfaccia dell'app, 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 il modo in cui asset, come titoli e inviti all'azione, vengono presentati nelle tue app. Applicando lo stile all'annuncio, puoi creare presentazioni dell'annuncio naturali e discrete per 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 diversi per unità pubblicitarie diverse e specificare i valori e gli articoli ricevuti dall'utente.

Implementare gli annunci con premio

Interstitial con premio

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

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

Invece della richiesta di attivazione negli annunci con premio, gli interstitial con premio richiedono una schermata introduttiva che annuncia il premio e offre agli utenti la possibilità di disattivare questa opzione.

Implementare gli annunci interstitial con premio

Apertura app

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

Implementare gli annunci apertura app