Inizia

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 mostrare gli annunci AdMob e generare entrate. Una volta completata l'integrazione, puoi scegliere un formato dell'annuncio (ad es. video nativo o con premio) per ottenere istruzioni dettagliate sull'implementazione.

Prerequisiti

  • Utilizza Unity 2019 o versioni successive
  • Per il deployment su iOS
    • Xcode 14.1 o versioni successive
    • Scegli come target iOS 11.0 o versioni successive
    • CocoaPods
  • 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
  • Consigliato: crea un account AdMob e registra un'app per Android e/o iOS

Scarica il plug-in Unity Mobile Ads

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

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

SCARICA IL PLUGIN VISUALIZZA LA FONTE

Importa il plug-in Unity Mobile Ads

Apri il progetto nell'editor di Unity. Seleziona Asset > Importa pacchetto > Pacchetto personalizzato e individua il file GoogleMobileAdsPlugin.unitypackage 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 resolver 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 e copiate automaticamente nel progetto Unity.

Per assicurarti che il tuo progetto includa l'SDK Mobile Ads, procedi nel seguente modo.

Android

Nell'editor Unity, seleziona Assets > External Dependency Manager > Android resolver > Risolvi. La libreria di Dipendenza esterna di Unity copia le dipendenze dichiarate nella directory Assets/Plugins/Android dell'app Unity.

iOS

Non sono necessari ulteriori passaggi 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. Utilizza l'ambiente xcworkspace generato al posto del progetto Xcode standard.
  • Quando utilizzi versioni precedenti di Unity, le dipendenze sono incluse nel progetto Xcode standard.

Impostare l'ID app AdMob

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

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

Aumenta gli eventi annuncio sul thread principale di Unity

A volte l'SDK Google Mobile Ads genera eventi su un thread diverso rispetto al thread principale di Unity. Questo potrebbe causare problemi durante l'interazione con gli oggetti Unity da eventi inviati dall'SDK Google Mobile Ads. Per risolvere il problema, potrebbe essere necessario aggiungere codice per sincronizzare gli eventi dell'SDK Mobile Ads con il thread principale di Unity.

Se vuoi che l'SDK Mobile Ads gestisca questo problema di thread per te, imposta MobileAds.RaiseAdEventsOnUnityMainThread su true. Questa operazione obbliga l'SDK Google Mobile Ads a raccogliere tutti gli eventi e i callback nel thread principale di Unity.

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

Inizializzare l'SDK Google Mobile Ads

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

Di seguito è riportato un esempio di come chiamare Initialize() nel 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 si verifichi il callback prima di caricare gli annunci, in questo modo ti assicuri che tutti gli adattatori di mediazione vengano inizializzati.

Seleziona un formato dell'annuncio

L'SDK Mobile Ads è ora incluso nell'app Unity quando si esegue il deployment sulla piattaforma Android o iOS. Ora puoi implementare un annuncio. AdMob offre diversi formati di annunci, in modo che tu possa scegliere quello più adatto alle tue esigenze relative all'esperienza utente.

Gli annunci banner sono annunci illustrati o di testo rettangolari che occupano uno spazio nel 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, questa è un ottimo punto di partenza.

Implementazione di un banner

Interstitial

Gli annunci interstitial sono annunci a schermo intero che coprono l'interfaccia di un'app finché non viene chiuso dall'utente. Sono ideali per le pause naturali nel flusso dell'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 formato di annuncio basato su componenti che ti consente di personalizzare il modo in cui gli asset, ad esempio 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 possano arricchire l'esperienza utente.

Implementazione degli annunci nativi

Con premio

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

Implementare gli annunci con premio

Richiedere l'autorizzazione di trasparenza della funzionalità di 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 iOS 14 di Unity.

Stessa chiave dell'app

Prerequisiti: plug-in Unity di Google Mobile Ads 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 usando 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);
    }