Inizia

Questa guida è rivolta ai publisher che vogliono monetizzare un'app per iOS con AdMob e non utilizzano Firebase. Se prevedi di includere Firebase nella tua app (o lo stai valutando), consulta la versione di questa guida relativa ad AdMob con Firebase.

L'integrazione dell'SDK Google Mobile Ads in un'app è il primo passo per poter mostrare annunci e generare entrate. Una volta integrato l'SDK, puoi procedere con l'implementazione di uno o più formati degli annunci supportati.

Prerequisiti

• Utilizza Xcode 15.3 o versioni successive
• Target iOS 12.0 o versioni successive

• Consigliato: crea un account AdMob e registra un'app.

Importa l'SDK Mobile Ads

Utilizza uno dei seguenti metodi per importare l'SDK Google Mobile Ads.

CocoaPods (opzione preferita)

Il modo più semplice per importare l'SDK in un progetto iOS è utilizzare CocoaPods. Apri il Podfile del progetto e aggiungi questa riga al target dell'app:

pod 'Google-Mobile-Ads-SDK'

Quindi, dalla riga di comando, esegui:

pod install --repo-update

Se non hai mai utilizzato CocoaPods, consulta la documentazione ufficiale per informazioni su come creare e utilizzare i file Podfile.

Gestore pacchetti Swift

Punto chiave: le librerie degli adattatori di mediazione non sono ancora disponibili su Swift Package Manager. Se utilizzi la mediazione, ti consigliamo di eseguire l'integrazione con CocoaPods.

L'SDK Google Mobile Ads supporta Swift Package Manager a partire dalla versione 9.0.0. Segui questi passaggi per importare il pacchetto Swift:

Nota: se esegui la migrazione da un progetto basato su CocoaPods, esegui pod deintegrate per rimuovere CocoaPods dal progetto Xcode. Il file .xcworkspace generato da CocoaPods può essere eliminato in sicurezza in un secondo momento. Se aggiungi l'SDK Google Mobile Ads a un progetto per la prima volta, puoi ignorare questo passaggio.

1. In Xcode, installa il pacchetto Swift Google Mobile Ads selezionando File > Add Packages... (File > Aggiungi pacchetti...).

2. Nella richiesta visualizzata, cerca il repository GitHub del pacchetto Swift di Google Mobile Ads:

   https://github.com/googleads/swift-package-manager-google-mobile-ads.git
   

3. Seleziona la versione del pacchetto Swift Google Mobile Ads che vuoi utilizzare. Per i nuovi progetti, ti consigliamo di utilizzare la funzionalità Fino alla versione principale successiva.

Al termine, Xcode inizierà a risolvere le dipendenze del pacchetto e a scaricarle in background. Per maggiori dettagli su come aggiungere le dipendenze del pacchetto, consulta l'articolo di Apple.

Download manuale

1. Scarica l'SDK Google Mobile Ads e Embed & Sign i seguenti framework nel tuo progetto Xcode:

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. Nelle impostazioni di compilazione del progetto:

   • Aggiungi il percorso /usr/lib/swift a Percorsi di ricerca Runpath.
   • Aggiungi il flag del linker -ObjC a Altri flag del linker.

Aggiorna il file Info.plist

Aggiorna il file Info.plist dell'app per aggiungere due chiavi:

1. Una chiave GADApplicationIdentifier con un valore stringa dell'elementoAdMob app ID found in the AdMob UI.

2. Una chiave SKAdNetworkItems con valori SKAdNetworkIdentifier per Google (cstr6suwn9.skadnetwork) e per alcuni acquirenti di terze parti che hanno fornito questi valori a Google.

Snippet completo

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</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>3qy4746246.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>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>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>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>pwa73g5rt2.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>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>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

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

In un'app reale, sostituisci l'ID app di esempio con il tuo ID AdMob app effettivo. Puoi utilizzare l'ID di esempio se stai solo sperimentando l'SDK in un'app Hello World.

Inizializzare l'SDK Mobile Ads

Prima di caricare gli annunci, chiama il metodo startWithCompletionHandler: su GADMobileAds.sharedInstance, che inizializza l'SDK e richiama un gestore di completamento al termine dell'inizializzazione (o dopo un timeout di 30 secondi). Questa operazione deve essere eseguita solo una volta, idealmente al momento del lancio dell'app. Ti consigliamo di chiamare startWithCompletionHandler: il prima possibile.

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 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) o intervieni in altro modo prima di caricare gli annunci, assicurati di farlo prima di inizializzare l'SDK Google Mobile Ads.

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

AppDelegate di esempio (estratto)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }
}

SwiftUI

import GoogleMobileAds

class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }
}

@main
struct YourApp: App {
  // To handle app delegate callbacks in an app that uses the SwiftUI lifecycle,
  // you must create an application delegate and attach it to your `App` struct
  // using `UIApplicationDelegateAdaptor`.
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds.sharedInstance startWithCompletionHandler:nil];
  return YES;
}

@end

Nota: se utilizzi la mediazione, attendi che venga chiamato il gestore del completamento prima di caricare gli annunci per assicurarti che tutti gli adattatori di mediazione siano inizializzati.

Seleziona un formato dell'annuncio

Ora che l'SDK Mobile Ads è stato importato e inizializzato, puoi implementare un annuncio. AdMob offre diversi formati di annunci, quindi puoi scegliere quello più adatto all'esperienza utente della tua app.

Gli sviluppatori SwiftUI possono seguire la nostra guida SwiftUI.

Banner

Le unità pubblicitarie banner mostrano annunci rettangolari che occupano una porzione del layout dell'app. possono essere aggiornate 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. È inoltre il formato dell'annuncio più semplice da implementare.

Implementare gli annunci banner

Interstitial

Le unità pubblicitarie interstitial mostrano annunci a schermo intero nell'app. Posiziona gli annunci 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.

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. Personalizzando l'annuncio, puoi creare presentazioni naturali e non invadenti che possono contribuire a un'esperienza utente completa.

Implementare gli annunci nativi

Con premio

Le unità pubblicitarie con premio consentono agli utenti di giocare, partecipare a sondaggi o guardare video per vincere 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

Interstitial con premio

L'interstitial con premio è un nuovo tipo di formato dell'annuncio con incentivi che consente di offrire premi, ad esempio monete o vite extra, per gli annunci che vengono visualizzati automaticamente durante le normali transizioni dell'app.

A differenza degli annunci con premio, gli utenti non devono attivare la visualizzazione degli annunci interstitial con premio.

Invece della richiesta di attivazione degli annunci con premio, quelli interstitial con premio prevedono una schermata introduttiva che annuncia il premio e offre agli utenti la possibilità di disattivare l'annuncio.

Implementare gli annunci interstitial con premio

Apertura app

Apertura app è un formato dell'annuncio visualizzato quando gli utenti aprono la tua app o vi tornano. L'annuncio si sovrappone alla schermata di caricamento.

Implementare gli annunci apertura app