Configura l'SDK Google Mobile Ads

Seleziona la piattaforma: Android (beta) Android iOS Unity Flutter

Integrare all'interno di un'app Google Mobile Ads SDK è il primo passaggio da compiere per poter mostrare annunci e generare entrate. Una volta integrato l'SDK, puoi procedere all'implementazione di uno o più dei formati di annunci supportati.

Prerequisiti

• Utilizza Xcode 16.0 o versioni successive
• Target iOS 13.0 o versioni successive

Importa Google Mobile Ads SDK

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

Swift Package Manager

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

Per aggiungere una dipendenza del pacchetto al tuo progetto:

1. In Xcode, installa il pacchetto Swift di Google Mobile Ads andando a File > Add Package Dependencies... (File > Aggiungi dipendenze del pacchetto).

2. Nella finestra di dialogo 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 di Google Mobile Ads che vuoi utilizzare. Per i nuovi progetti, ti consigliamo di utilizzare Up to Next Major Version (Fino alla prossima versione principale).

CocoaPods

Prima di continuare, consulta la pagina Utilizzare CocoaPods per informazioni sulla creazione e sull'utilizzo dei Podfile.

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

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

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. 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).

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'ID app Ad Manager che si trova nell'interfaccia utente di Ad Manager e nel formato ca-app-pub-################~##########.

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

Snippet completo

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager 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 app Ad Manager. Durante i test, utilizza l'ID app di esempio mostrato nell'esempio precedente.

Per un rendimento ottimale dell'inizializzazione, è importante associare i gruppi di rendimento alle app specifiche in cui vengono utilizzati. Le configurazioni dei gruppi di rendimento che hanno come target iOS e non sono associate a un'app specifica verranno inviate a tutte le app iOS nel tuo account, il che potrebbe allungare il tempo necessario per l'inizializzazione.

Inizializza Google Mobile Ads SDK

Prima di caricare gli annunci, chiama il metodo start() su GADMobileAds.sharedInstance, che inizializza l'SDK e richiama un gestore di completamento al termine dell' inizializzazione (o dopo un timeout di 30 secondi). Chiama start() il prima possibile.

Avviso: gli annunci potrebbero essere precaricati da Google Mobile Ads SDK o dagli SDK dei partner di mediazione dopo aver chiamato startWithCompletionHandler:. Se devi ottenere il consenso dagli utenti dello Spazio economico europeo (SEE), impostare flag specifici per le richieste (ad esempio tagForChildDirectedTreatment o tag_for_under_age_of_consent) o intraprendere altre azioni prima di caricare gli annunci, assicurati di farlo prima di inizializzare Google Mobile Ads SDK.

Swift

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

SwiftUI

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

Objective-C

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

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

Seleziona un formato dell'annuncio

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

Banner

Le unità pubblicitarie banner mostrano annunci rettangolari che occupano una porzione del layout di un'app. possono essere aggiornate automaticamente dopo un determinato periodo di tempo. Ciò significa che gli utenti vedranno un nuovo annuncio a intervalli regolari, anche se rimangono sulla stessa schermata della tua app. Inoltre, questo è il formato dell'annuncio più facile da implementare.

Implementa gli annunci banner

Interstitial

Le unità pubblicitarie interstitial mostrano annunci a pagina intera all'interno dell'app. Inseriscili durante le normali interruzioni e nei momenti di transizione nell'interfaccia dell'app, ad esempio dopo il completamento di un livello se si tratta di un'app di giochi.

Implementa gli annunci interstitial

Nativo

Gli annunci nativi sono annunci in cui puoi personalizzare la modalità di presentazione degli asset, come titoli e inviti all'azione, nelle tue app. Definendo lo stile dell'annuncio, puoi creare presentazioni di annunci naturali e non intrusive che possono arricchire l'esperienza utente.

Google Ad Manager offre due modi per implementare gli annunci nativi: gli stili nativi e gli annunci nativi standard tramite il rendering personalizzato.

Gli stili nativi sono stati progettati per semplificare l'implementazione degli annunci nativi e sono un'ottima scelta se non hai familiarità con questo formato. Il rendering personalizzato è stato progettato per massimizzare la libertà di creare le presentazioni.

Implementa gli stili nativi Implementa gli annunci nativi (rendering personalizzato)

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 distinti per le varie unità pubblicitarie, specificare quelli che riceveranno gli utenti e il relativo valore.

Implementa gli annunci con premio

Interstitial con premio

"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 di un interstitial con premio.

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

Implementa gli annunci interstitial con premio

Apertura app

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

Implementa gli annunci apertura app