Per iniziare

Il plug-in Unity degli annunci per dispositivi mobili di Google consente agli sviluppatori di Unity di pubblicare annunci per dispositivi mobili di Google nelle 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.

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

Prerequisiti

• Utilizzare Unity 2019.4 o versioni successive
• Per il deployment su iOS:
  • Xcode 15.3 o successivo
  • Scegli come target iOS 12.0 o versioni successive
  • CocoaPods
• Per il deployment su Android
  • Livello API Android minimo 21 o superiore
  • Livello API Android target 31 o successivo

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

Importa il plug-in Mobile Ads for Unity

Interfaccia a riga di comando di 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

Rimuovi .unitypackage asset plug-in

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage all'utilizzo di OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. Rimuovi le seguenti directory importate da .unitypackage:

• Asset/ExternalDependencyManager
• Asset/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. Apri le impostazioni del gestore di pacchetti selezionando l'opzione del 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
   

3. Apri il menu del gestore di pacchetti selezionando l'opzione del menu Unity Finestra > Gestore pacchetti.

4. Imposta il menu a discesa dell'ambito del gestore per selezionare I miei registri.

   

5. Seleziona il pacchetto Google Mobile Ads per Unity dall'elenco e premi Installa.

Rimuovi .unitypackage asset plug-in

Se stai eseguendo la migrazione dall'utilizzo di un .unitypackage all'utilizzo di OpenUPM, devi disinstallare manualmente gli asset dalla posizione precedente. Rimuovi le seguenti directory importate da .unitypackage:

• Asset/ExternalDependencyManager
• Asset/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

1. Scarica la release più recente di .unitypackage da GitHub.
2. Importa il file .unitypackage selezionando l'opzione di menu Unity Asset > Importa pacchetto > Pacchetto personalizzato e importando tutti gli elementi.

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 di Android, come gli AAR o i CocoaPods per iOS. Offre ai plug-in Unity la possibilità di dichiarare le dipendenze, che vengono poi risolte e copiate automaticamente nel progetto Unity.

Importante: utilizza l'SDK Google Mobile Ads più recente 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 di proprietà Gradle personalizzato

Nell'editor Unity, seleziona Assets > External Dependency Manager > Android Resolver > Risolvi per fare in modo che la libreria del Gestore delle dipendenze esterne di Unity copia le dipendenze dichiarate nella directory Assets/Plugins/Android dell'app Unity.

iOS

Per includere l'SDK Google Mobile Ads nel progetto Unity non sono necessari ulteriori passaggi.

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

• Quando utilizzi Unity 5.6 o versioni successive, viene generata un'area di lavoro xcworkspace che include le librerie delle dipendenze necessarie. Utilizza l'area di lavoro 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 l' Ad Manager ID dell'app

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

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

Inizializzare l'SDK

Prima di caricare gli annunci, chiedi alla tua app di inizializzare 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 dei partner di mediazione al momento della chiamata a MobileAds.Initialize(). Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), imposta eventuali flag specifici per la richiesta, ad esempio tagForChildDirectedTreatment o tag_for_under_age_of_consent, oppure intervieni 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 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 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 nella tua app Unity quando viene implementato sulla piattaforma Android o iOS. Ora puoi implementare un annuncio. AdMob offre una serie di formati di annunci diversi, per consentirti di scegliere quello più adatto alla 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 al 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 quali titoli e inviti all'azione vengono presentati nelle tue app. Scegliendo personalmente l'annuncio, puoi creare presentazioni naturali e non invadenti che possono 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 guadagnare premi in-app come monete, vite extra o punti. Puoi impostare premi diversi per unità pubblicitarie diverse e specificare i valori e gli elementi del premio ricevuti dall'utente.

Implementare gli annunci con premio