Il plug-in Google Mobile Ads Unity consente agli sviluppatori Unity di pubblicare annunci Google per dispositivi mobili 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 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 versioni successive
- Target iOS 12.0 o versioni successive
- CocoaPods
- Per eseguire il deployment su Android
- Livello API Android minimo pari o superiore a 21
- Avere come target il livello API Android 34 o versioni successive
- Consigliato: crea un account AdMob e registra un'app per Android o iOS
Il livello API Android è impostato in Impostazioni progetto > Player > Android > Altre impostazioni > Altre impostazioni.
Importa il plug-in Mobile Ads per Unity
OpenUPM-CLI
Se hai installato l'interfaccia a riga di comando OpenUPM, puoi installare il registry OpenUPM con il seguente comando:
openupm add com.google.ads.mobile
Rimuovi gli asset del plug-in .unitypackage
Se esegui la migrazione da un .unitypackage
a OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. 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
- Apri le impostazioni del gestore dei pacchetti selezionato l'opzione di menu di Unity Modifica > Impostazioni progetto > Gestore dei pacchetti.
Aggiungi OpenUPM come registry con ambito alla finestra Gestione pacchetti:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
Apri il menu del gestore dei pacchetti selezionando l'opzione di menu di Unity Finestra > Gestore dei pacchetti.
Imposta il menu a discesa Ambito gestore in modo da selezionare I miei registry.
Seleziona il pacchetto Google Mobile Ads per Unity dall'elenco dei pacchetti e premi Installa.
Rimuovi gli asset del plug-in .unitypackage
Se esegui la migrazione da un .unitypackage
a OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. 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
- Scarica la release
.unitypackage
più recente da GitHub. - Importa il file
.unitypackage
selezionando l'opzione del menu Unity Asset > Importa pacchetto > Pacchetto personalizzato e importando tutti gli elementi.
Includi le dipendenze esterne
Il plug-in per Unity di Google Mobile Ads viene distribuito con la libreria Unity Play Services Resolver. Questa libreria è progettata per essere utilizzata da qualsiasi plug-in Unity che richiede l'accesso a librerie specifiche per Android, come AAR o CocoaPods per iOS. Fornisce ai plug-in di Unity la possibilità di dichiarare le dipendenze, che vengono poi risolte e copiate automaticamente nel progetto Unity.
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 di proprietà Gradle personalizzate
Nell'editor di Unity, seleziona Asset > External Dependency Manager > Android
Resolver > Resolve per fare in modo che la libreria External Dependency Manager di Unity
copi 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 alle dipendenze iOS.
Le dipendenze del plug-in Unity di Google Mobile Ads sono elencate in
Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
.
Impostare l' AdMob ID app
Nell'editor di Unity, seleziona Asset > Google Mobile Ads > Impostazioni nel menu.
Inserisci il tuo ID app AdMob in ogni campo.
Inizializza l'SDK
Prima di caricare gli annunci, fai in modo che l'app inizili l'SDK Google Mobile Ads chiamando MobileAds.Initialize()
. Questa operazione deve essere eseguita una sola volta, idealmente al
lancio dell'app.
Ecco un esempio di come chiamare Initialize()
all'interno del metodo Start()
di uno script associato 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 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 puoi implementare un annuncio. AdMob offre diversi formati di annunci, quindi puoi scegliere quello più adatto per offrire un'esperienza utente ottimale.
Banner
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 visualizzano 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 il modo in cui gli asset come titoli e pozivi all'azione vengono presentati nelle tue app. Personalizzando l'annuncio, puoi creare presentazioni naturali e non invadenti che possono contribuire a un'esperienza utente completa.
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 le varie unità pubblicitarie, specificare i valori e gli articoli ricevuti dall'utente.
Implementare gli annunci con premio
Interstitial con premio
L'interstitial con premio è un nuovo tipo di formato dell'annuncio con incentivi che 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 annunci interstitial con premio.
Invece della richiesta di attivazione degli annunci con premio, quelli interstitial con premio prevedono una schermata introduttiva che annuncia il premio e offre agli utenti la possibilità di disattivare l'annuncio.
Implementare gli annunci interstitial con premio
Apertura app
Apertura app è un formato dell'annuncio visualizzato quando gli utenti aprono la tua app o vi tornano. L'annuncio si sovrappone alla schermata di caricamento.
Implementare gli annunci apertura app