Per iniziare

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

L'integrazione del plug-in Unity di Google Mobile Ads in un'app è il primo passo per visualizzare gli annunci AdMob e generare entrate. Una volta completata l'integrazione, puoi scegliere un formato dell'annuncio, ad esempio nativo o con premio, per visualizzare i passaggi di implementazione dettagliati.

Prerequisiti

  • Utilizza Unity 2019.4 o versioni successive
  • Per eseguire il deployment su iOS
    • Xcode 14.1 o versioni successive
    • Scegli come target iOS 11.0 o versioni successive
    • CocoaPods
  • Per eseguire il deployment su Android
    • Livello API Android minimo 21 o successivo
    • Scegli come target il livello API Android 31 o successivo

Scarica il plug-in Unity di Mobile Ads

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

Utilizza i seguenti link per scaricare il pacchetto Unity per il plug-in o per dare un'occhiata al codice su GitHub.

SCARICA IL PLUGIN VISUALIZZA SORGENTE

Importa il plug-in Unity di Google Mobile Ads

Gli annunci per dispositivi mobili di Google per Unity sono distribuiti da un pacchetto di asset Unity. Per importare il pacchetto, apri il progetto nell'editor Unity, seleziona Asset > Importa pacchetto > Pacchetto personalizzato e trova il file GoogleMobileAdsPlugin.unitypackage che hai scaricato. Assicurati che tutti i file siano selezionati e fai clic su Importa.

Includi dipendenze esterne

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

Segui questi passaggi per assicurarti che il tuo 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 delle dipendenze esterno > Sistema Android Resolver > Risolvi per fare in modo che la libreria di Unity External Dependency Manager copi le dipendenze dichiarate nella directory Assets/Plugins/Android dell'app Unity.

iOS

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

  • Quando utilizzi Unity 5.6 o versioni successive, viene generato un valore xcworkspace che include le librerie delle dipendenze richieste. Usa l'xcworkspace generato anziché il progetto Xcode standard.
  • Quando utilizzi versioni precedenti di Unity, le dipendenze sono incluse nel progetto Xcode standard.

Imposta l'ID AdMob app

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

Inserisci il tuo Android e iOS ID app AdMob in ogni campo.

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

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 siano 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, pertanto puoi scegliere quello più adatto a ottimizzare l'esperienza utente.

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. Se applichi uno stile all'annuncio, puoi creare presentazioni naturali e discrete che possono contribuire a creare un'esperienza utente positiva.

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 del premio e gli elementi ricevuti dall'utente.

Implementa gli annunci con premio

Interstitial con premio

L'interstitial con premio è un nuovo tipo di formato dell'annuncio con incentivi che ti 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 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 dà agli utenti la possibilità di disattivare se lo desiderano.

Implementare gli annunci interstitial con premio

Apertura app

Apertura 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