Iniziare a utilizzare AdMob nel progetto per iOS

Questa guida rapida è rivolta a publisher e sviluppatori che vogliono utilizzare AdMob per monetizzare un'app creata con Firebase. Se non prevedi di includere Firebase nella tua app, consulta la autonoma AdMob guida di Google Cloud.

Se non l'hai ancora fatto, scopri tutte le vantaggi dell'utilizzo di AdMob, Firebase e Google Analytics insieme.

Prima di iniziare

• Se non hai ancora un progetto e un'app Firebase, segui la guida introduttiva di Firebase: Aggiungi Firebase al tuo progetto iOS.

• Assicurati che Google Analytics sia abilitato nel tuo progetto Firebase:

  • Se stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

  • Se hai già un progetto Firebase in cui Google Analytics non è attivo, puoi attivarlo dalla scheda Integrazioni di > Impostazioni progetto.

  Nota: l'aggiunta dell'SDK Firebase per Google Analytics alla tua app facoltativo ma vivamente consigliato. Scopri di più sui vantaggi dell'aggiunta di l'SDK Firebase per Google Analytics.

Passaggio 1: configura l'app nel tuo account AdMob

1. Registra la tua app come app AdMob.

   1. Accedi o registrati per un Account AdMob.

   2. Registra la tua app con AdMob. Questo passaggio crea un'app AdMob con un AdMob ID app univoco di cui avrai bisogno in seguito in questa guida.

   Ti verrà chiesto di aggiungere l'SDK Mobile Ads alla tua app. Trova istruzioni dettagliate per questa attività più avanti nella guida.

2. Collega l'app AdMob all'app Firebase.

   Questo passaggio è facoltativo, ma vivamente consigliato. Scopri di più sui vantaggi dell'attivazione delle metriche utente e del collegamento dell'app AdMob a Firebase.

   Completa i seguenti due passaggi nella dashboard App del tuo account AdMob:

   1. Attiva Metriche utente per consentire a AdMob di elaborare e visualizzare i dati di analisi selezionati nel tuo accountAdMob. Inoltre, è un'impostazione obbligatoria per collegare AdMob app in Firebase.

   2. Collega la tua appAdMob al progetto e all'app Firebase esistenti.

      Assicurati di inserire lo stesso ID bundle che hai inserito per la tua app Firebase. Puoi trovare l'ID bundle della tua app Firebase nella scheda Le tue app di > Impostazioni progetto.

Passaggio 2: aggiungi l'ID app AdMob al file Info.plist

Nel file Info.plist dell'app, aggiungi una chiave GADApplicationIdentifier con un valore di stringa del tuo AdMob ID app.

Importante: questo passaggio è obbligatorio a partire dalla versione 7.42.0 dell'SDK Google Mobile Ads. Se non aggiungi questa voce Info.plist, l'app si arresterà in modo anomalo con il messaggio: "The Google Mobile Ads SDK was initialized incorrectly."

Puoi apportare questa modifica in modo programmatico:

<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 -->
<key>GADApplicationIdentifier</key>
<string>ADMOB_APP_ID</string>

In alternativa, modificalo nell'editor dell'elenco di proprietà:

Passaggio 3: aggiungi e inizializza l'SDK Mobile Ads

1. Aggiungi la dipendenza per l'SDK Google Mobile Ads agli attributi Podfile:

   pod 'Google-Mobile-Ads-SDK'
   

2. Prima di caricare gli annunci, chiama il metodo startWithCompletionHandler: nella GADMobileAds.sharedInstance

   Questa chiamata inizializza l'SDK e richiama un gestore di completamento al termine dell'inizializzazione (o dopo un timeout di 30 secondi). Chiama questo metodo solo una volta e il prima possibile, idealmente all'avvio dell'app, ma dopo l'inizializzazione di Firebase.

   Avviso: gli annunci potrebbero essere precaricati dall'SDK Mobile Ads o dagli SDK dei partner di mediazione al momento della chiamata di startWithCompletionHandler:. Se devi intervenire in qualche modo di caricare gli annunci, è bene farlo prima di inizializzare SDK Mobile Ads. Di seguito sono riportati alcuni esempi di azioni che potrebbero necessarie prima dell'inizializzazione:

   • 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)

   Scopri di più nel AdMob documentazione.

   Ecco un esempio di come chiamare il metodo startWithCompletionHandler: in il tuo AppDelegate:

   Swift

   import Firebase
   import GoogleMobileAds
   ...
   
   @UIApplicationMain
   class AppDelegate: UIResponder, UIApplicationDelegate {
   
     var window: UIWindow?
   
     func application(_ application: UIApplication,
         didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
   
       // Use Firebase library to configure APIs.
       FirebaseApp.configure()
   
       // Initialize the Google Mobile Ads SDK.
       GADMobileAds.sharedInstance().start(completionHandler: nil)
   
       return true
     }
   
   }
   

   Objective-C

   @import Firebase;
   @import GoogleMobileAds;
   ...
   
   @implementation AppDelegate
   
   - (BOOL)application:(UIApplication *)application
       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     // Use Firebase library to configure APIs.
     [FIRApp configure];
     // Initialize the Google Mobile Ads SDK.
     [[GADMobileAds sharedInstance] startWithCompletionHandler:nil];
     return YES;
   }
   
   @end
   

Passaggio 4. Visualizza le metriche utente e i dati di analisi

Dopo l'inizializzazione, l'SDK Mobile Ads inizia automaticamente a registrare gli eventi e le proprietà utente di analisi dei dati della tua app. Puoi visualizzare questi dati senza aggiungere codice aggiuntivo alla tua app o implementare annunci. Ecco dove puoi visualizzare questi dati di analisi:

• Nella scheda Metriche utente del tuo account AdMob (dashboard Home o App), puoi visualizzare le metriche utente selezionate ricavate dai dati di analisi raccolti, come la durata media della sessione, l'ARPU e la fidelizzazione.

• Nella dashboard Analytics della console Firebase, puoi visualizzare statistiche aggregate e riepiloghi delle metriche chiave. Se aggiungi l'SDK Firebase per Google Analytics, puoi anche contrassegnare le conversioni per le campagne pubblicitarie e creare segmenti di pubblico personalizzati nella console Firebase.

Ricorda che per rappresentare al meglio ARPU e metriche ARPPU, potresti voler includere i dati di un evento personalizzato di Analytics chiamato ecommerce_purchase nel calcolo delle entrate per queste metriche (scopri come).

In genere i dati vengono visualizzati entro un'ora, ma potrebbero essere necessarie fino a 48 ore.

Passaggio 5:(facoltativo) utilizza altre funzionalità di Google Analytics e Firebase

Sfrutta nuove opportunità e funzionalità per migliorare la monetizzazione delle app e coinvolgimento degli utenti:

• Aggiungere e utilizzare l'SDK Firebase per Google Analytics

  • Implementa la registrazione degli eventi personalizzati nella tua app.

  • Contrassegna le conversioni per le campagne pubblicitarie personalizzate.

  • Includi i dati degli eventiecommerce_purchase nel calcolo delle entrate per le metriche ARPU e ARPPU.

  Per ulteriori informazioni, consulta la guida all'utilizzo di Google Analytics e Firebase con AdMob app.

• Utilizzare altri prodotti Firebase nella tua app

  Dopo aver aggiunto l'SDK Firebase per Google Analytics, utilizza altri prodotti Firebase per ottimizzare gli annunci nella tua app.

  • Remote Config ti consente di modificare il comportamento e l'aspetto dell'app senza pubblicare un aggiornamento, senza costi, per un numero illimitato di utenti attivi giornalieri.

  • A/B Testing ti consente di testare le modifiche a l'interfaccia utente, le funzionalità o le campagne di coinvolgimento della tua app per scoprire se l'impatto sulle metriche chiave (come entrate e fidelizzazione) prima di implementare cambia ampiamente.

• Ottimizzare la monetizzazione degli annunci per la tua app

  Provare configurazioni o formati di annunci diversi con un piccolo sottoinsieme di utenti. e poi prendere decisioni basate sui dati in merito all'implementazione dell'annuncio per tutti utenti. Per saperne di più, consulta i seguenti tutorial:

  • Testare l'adozione del nuovo formato dell'annuncio (panoramica | implementazione).

  • Ottimizza la frequenza degli annunci (panoramica | implementazione).

Passaggio 6. Scegli un formato dell'annuncio da implementare nell'app

AdMob offre diversi formati di annunci, quindi puoi scegliere quello più adatto all'esperienza utente della tua app. Fai clic su un pulsante per un formato dell'annuncio per visualizzare istruzioni dettagliate sull'implementazione nella documentazione AdMob.

Banner

Annunci rettangolari che vengono visualizzati nella parte superiore o inferiore dello schermo del dispositivo.

Gli annunci banner rimangono sullo schermo mentre gli utenti interagiscono con l'app e possono essere aggiornati automaticamente dopo un determinato periodo di tempo. Se non hai mai utilizzato la pubblicità per il mobile, sono un ottimo punto di partenza.

Implementare gli annunci banner

Interstitial

Annunci a schermo intero che coprono l'interfaccia di un'app fino alla chiusura dell'utente.

Gli annunci interstitial sono ideali per le pause naturali nel flusso dell'esecuzione, ad esempio tra i livelli di un gioco o subito dopo il completamento di un'attività.

Implementare gli annunci interstitial

Nativo

Annunci personalizzabili che si adattano all'aspetto e al design della tua app

Gli annunci nativi sono un formato dell'annuncio basato su componenti. Sei tu a decidere come e dove devono essere posizionati gli annunci nativi, in modo che il layout sia più in linea con il design della tua app. Scegliendo personalmente caratteri, colori e altri dettagli, puoi creare presentazioni di annunci naturali e non invadenti che possono contribuire a un'esperienza utente completa.

Implementare gli annunci nativi avanzati

Con premio

Annunci che premiano gli utenti per la visione di brevi video e l'interazione con contenuti riproducibili annunci e sondaggi

Gli annunci con premio (o "basati su premi") possono aiutare a monetizzare gli utenti free-to-play.

Implementa gli annunci con premio

Implementa gli annunci con premio (nuove API)