Configura l'SDK Google Mobile Ads

Per pubblicare annunci e generare entrate, integra Google Mobile Ads SDK in la tua app per iOS. Per preparare il progetto, importa e inizializza Google Mobile Ads SDK prima di richiedere gli annunci.

Se includi Firebase nella tua app per iOS, consulta la guida introduttiva ad AdMob nel progetto iOS.

Questa guida illustra come importare e inizializzare Google Mobile Ads SDK e come selezionare un formato dell'annuncio.

Prerequisiti

Prima di continuare, assicurati di avere:

  • Xcode 16.0 o versioni successive.
  • iOS 13.0 o versioni successive.

Importa Google Mobile Ads SDK

Per importare Google Mobile Ads SDK, completa una delle seguenti sezioni:

Swift Package Manager

Per aggiungere una dipendenza del pacchetto al progetto:

  1. Apri Xcode.
  2. Vai a File > Add Package Dependencies... (File > Aggiungi dipendenze del pacchetto).
  3. Installa il pacchetto Swift Google Mobile Ads SDK.

  4. Nel prompt visualizzato, cerca il repository GitHub del pacchetto Swift dell'SDK Google Mobile Ads:

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  5. Seleziona la versione del pacchetto Swift Google Mobile Ads SDK che vuoi utilizzare. Per i nuovi progetti, ti consigliamo di utilizzare Up to Next Major Version (Fino alla prossima versione principale).

CocoaPods

Per utilizzare CocoaPods:

  1. Apri il Podfile del progetto e aggiungi questa riga alla configurazione di build target dell'app:

    pod 'Google-Mobile-Ads-SDK'
  2. In un terminale, esegui:

    pod install --repo-update

Download manuale

Per scaricare manualmente Google Mobile Ads SDK:

  1. Scarica Google Mobile Ads SDK.
  2. Estrai il pacchetto googlemobileadssdkios.zip.
  3. Nel progetto Xcode, aggiungi i seguenti framework:

    • GoogleMobileAds.xcframework
    • UserMessagingPlatform.xcframework
  4. Nelle impostazioni Generali del target, vai a Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati).

  5. Verifica di aver impostato GoogleMobileAds.xcframework e UserMessagingPlatform.xcframework su Embed & Sign (Incorpora e firma).

  6. Nelle impostazioni di build del progetto:

    • Aggiungi il percorso /usr/lib/swift a Runpath Search Paths (Percorsi di ricerca Runpath).
    • Aggiungi il flag del linker -ObjC a Other Linker Flags (Altri flag del linker).

Aggiornare il file Info.plist

Nel file Info.plist dell'app, aggiungi le seguenti chiavi:

Esempio completo

<key>GADApplicationIdentifier</key>
<!-- Sample AdMob app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wg4vff78zm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>44jx6755aq.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>k674qkevps.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbmxgpxpgc.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c3frkrj4fj.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>97r2b46745.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Sostituisci SAMPLE_APP_ID con l'ID della tua app monetizzata con AdMob. Durante i test, utilizza l'ID app di esempio mostrato nell'esempio precedente.

Se non hai ancora creato un account AdMob e registrato un'app, è il momento giusto per farlo.

Inizializzare Google Mobile Ads SDK

Prima di caricare gli annunci, inizializza Google Mobile Ads SDK chiamando il metodo start() dalla proprietà GADMobileAds.sharedInstance. Questo metodo chiama un gestore di completamento dopo Google Mobile Ads SDK e gli adattatori di mediazione hanno terminato l'elaborazione o dopo 30 secondi.

L'esempio seguente inizializza Google Mobile Ads SDK:

Swift

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()

SwiftUI

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()

Objective-C

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];

Durante l'inizializzazione, Google Mobile Ads SDK potrebbe precaricare gli annunci o inizializzare gli SDK di terze parti quando viene chiamato il metodo startWithCompletionHandler:. Se devi ottenere il consenso degli utenti nello Spazio economico europeo (SEE), nel Regno Unito o in Svizzera, imposta i flag specifici della richiesta. Se devi impostare flag specifici della richiesta, assicurati di farlo prima di inizializzare Google Mobile Ads SDK. Per maggiori dettagli, consulta la sezione Targeting.

Selezionare un formato dell'annuncio

Dopo aver importato Google Mobile Ads SDK, puoi selezionare un formato dell'annuncio da implementare.

AdMob offre i seguenti formati dell'annuncio:

Formato dell'annuncio Descrizione Documentazione
Banner Mostra annunci rettangolari in una sezione del layout dell'app. Questo annuncio viene aggiornato automaticamente a intervalli prestabiliti. Gli utenti vedono questi annunci periodicamente quando rimangono sulla stessa schermata. Configurare gli annunci banner
Interstitial Mostra annunci a schermo intero nell'app. Inserisci questo annuncio 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. Annunci interstitial
Nativo Consente di personalizzare gli asset, ad esempio titoli e inviti all'azione, nelle app. Quando personalizzi l'annuncio, crei annunci che corrispondono al design visivo dell'app. Caricare un annuncio nativo
Con premio Gli utenti vincono premi in-app, come monete o punti, giocando, partecipando a sondaggi o guardando video. Puoi impostare i premi per le unità pubblicitarie e specificare i valori e gli articoli dei premi che riceveranno gli utenti. Annunci con premio
Interstitial con premio Consente di offrire premi, ad esempio monete o vite extra, per gli annunci che vengono visualizzati durante le transizioni dell'app. Annunci interstitial con premio
Apertura app Viene visualizzato quando gli utenti aprono la tua app o vi tornano. L'annuncio si sovrappone alla schermata di caricamento. Annunci apertura app