Inizia

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

L'integrazione del plug-in Unity degli annunci per dispositivi mobili di Google in un'app costituisce il primo passo per visualizzare annunci AdMob e generare entrate. Una volta completata l'integrazione, puoi scegliere un formato dell'annuncio (ad es. nativo o video con premio) per ottenere istruzioni dettagliate sull'implementazione.

Prerequisiti

  • Utilizzare Unity 2019 o versioni successive
  • Per il deployment su iOS
    • Xcode 13.2.1 o versioni successive
    • Scegliere come target iOS 10.0 o versioni successive
    • Poco di caffè
  • Per il deployment su Android
    • Google Play Services 18.1.0 o versioni successive
    • Scegliere come target il livello API 16 o successivo di Android
  • Metodo consigliato: crea un account AdMob e registra un'app per Android e/o iOS

Scarica il plug-in Unity di Google Ads

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

Utilizza i link riportati di seguito per scaricare il pacchetto Unity per il plug-in o per esaminarne il codice su GitHub.

SCARICA IL PLUG-IN VISUALIZZA LA FONTE

Importa il plug-in Mobile Ads Unity

Apri il progetto nell'editor Unity. Seleziona Asset > Importa pacchetto > Pacchetto personalizzato e individua il file GoogleMobileAdsPlugin.unitypackage che hai scaricato.

Assicurati che tutti i file siano selezionati e fai clic su Importa.

Includi l'SDK Google Mobile Ads

Il plug-in Unity di Google Mobile Ads viene distribuito con la libreria Solver di Unity Play Services. Questa libreria è destinata a essere utilizzata da qualsiasi plug-in Unity che richiede l'accesso a librerie specifiche di Android (ad esempio AAR) o CocoaPods di iOS. Offre ai plug-in Unity la possibilità di dichiarare le dipendenze, che vengono poi risolte automaticamente e copiate nel progetto Unity.

Segui i passaggi riportati di seguito per assicurarti che il tuo progetto includa l'SDK Mobile Ads.

Android

Nell'editor Unity, seleziona Assets > External Dependency Manager > Android Solver > Risolvi. La libreria Unity Dependency Manager copia le dipendenze dichiarate nella directory Assets/Plugins/Android della tua app Unity.

iOS

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

  • Quando utilizzi Unity 5.6 e versioni successive, viene generato uno spazio xcwork che include le librerie di dipendenza richieste. Usa xcworkspace generato invece del progetto Xcode standard.
  • Quando utilizzi versioni precedenti di Unity, le dipendenze sono incluse nel progetto Xcode standard.

Imposta il tuo ID app AdMob

Nell'editor Unity, seleziona Assets > Google Mobile Ads > Impostazioni dal menu.

Inserisci l'ID app AdMob per Android e iOS in ogni campo.

Aumentare gli eventi dell'annuncio sul thread principale di Unity

L'API Unity non è sicura per i thread e genera eccezioni se interagisci con l'API Unity da qualsiasi thread in background. Di conseguenza, devi sincronizzare gli eventi e i callback dell'SDK Mobile Ads con il thread principale.

Se vuoi che l'SDK Mobile Ads gestisca questo problema di thread, puoi impostare MobileAds.RaiseAdEventsOnUnityMainThread su true. In questo modo, l'SDK Google Mobile Ads genererà per te tutti gli eventi e i callback sul thread principale di Unity.

Inizializza l'SDK Google Mobile Ads

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

Ecco un esempio di come chiamare Initialize() nel metodo Start() di uno script associato a un GameObject:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be invoked
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

Se utilizzi la mediazione, attendi che si verifichi il callback prima di caricare gli annunci, per assicurarti che tutti gli adattatori di mediazione siano inizializzati.

Seleziona un formato dell'annuncio

L'SDK Mobile Ads ora è incluso nell'app Unity durante il deployment sulla piattaforma Android o iOS. Ora puoi implementare un annuncio. AdMob offre vari formati degli annunci, per consentirti di scegliere quello più adatto alla tua esperienza utente.

Gli annunci banner sono annunci illustrati o di testo rettangolari che occupano uno spazio all'interno del layout di un'app. Rimangono sullo schermo mentre gli utenti interagiscono con l'app e possono aggiornarsi automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità per il mobile, sono un ottimo punto di partenza.

Implementare un banner

Interstitial

Gli interstitial sono annunci a schermo intero che coprono l'interfaccia di un'app fino a quando non viene chiusa dall'utente. Vengono usati al meglio nelle pause naturali del flusso di esecuzione di un'app, ad esempio tra i livelli di un gioco o subito dopo il completamento di un'attività.

Implementare un annuncio interstitial

Nativo

Il formato nativo è un annuncio basato su componenti che ti consente di personalizzare il modo in cui gli asset, come titoli e inviti all'azione, vengono presentati nelle loro app. Scegliendo caratteri, colori e altri dettagli, puoi creare presentazioni di annunci naturali e discrete che possono essere utili per un'esperienza utente più coinvolgente.

Implementa gli annunci nativi

Con premio

Gli annunci video con premio sono annunci video a schermo intero che gli utenti possono guardare completamente in cambio di premi in-app.

Implementare gli annunci con premio

Richiedere l'autorizzazione per la trasparenza del monitoraggio delle app

Per visualizzare la richiesta di autorizzazione per la trasparenza del monitoraggio delle app (ATT) per accedere all'IDFA, utilizza il pacchetto di assistenza pubblicitaria per iOS 14 di Unity.

Stessa chiave dell'app

Prerequisiti: plug-in Google Mobile Ads Unity 6.1.0 o versioni successive

L'SDK Google Mobile Ads introduce la stessa chiave dell'app per aiutarti a pubblicare annunci più pertinenti e personalizzati utilizzando i dati raccolti dall'app utilizzata dall'utente.

La stessa chiave dell'app è abilitata per impostazione predefinita, ma puoi disattivarla con la seguente API:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }