Questa guida mostra come integrare un adattatore di mediazione con la tua app per iOS.
Prerequisiti
Prima di poter integrare la mediazione per un formato annuncio, devi integrare quest'ultimo nella tua app:
- Annunci banner
- Annunci interstitial
- Annunci nativi
- Annunci con premio
- Annunci interstitial con premio
Non hai mai utilizzato la mediazione? Leggi Introduzione alla mediazione.
Per le offerte: SDK Google Mobile Ads 7.53.1 o versioni successive.
Inizializza l'SDK Google Mobile Ads
La guida rapida mostra come inizializzare l'SDK Google Mobile Ads. Durante la chiamata di inizializzazione, vengono inizializzati anche gli adattatori di mediazione. È importante attendere il completamento dell'inizializzazione prima di caricare gli annunci per verificare la piena partecipazione di ogni ad network alla prima richiesta di annuncio.
Il seguente esempio di codice mostra come controllare lo stato di inizializzazione di ogni adattatore prima di effettuare una richiesta di annuncio.
Swift
import GoogleMobileAds
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
MobileAds.shared.start { status in
// Optional: Log each adapter's initialization latency.
let adapterStatuses = status.adapterStatusesByClassName
for adapter in adapterStatuses {
let adapterStatus = adapter.value
NSLog("Adapter Name: %@, Description: %@, Latency: %f", adapter.key,
adapterStatus.description, adapterStatus.latency)
}
// Start loading ads here...
}
return true
}
}
Objective-C
@import GoogleMobileAds;
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
GADMobileAds *ads = [GADMobileAds sharedInstance];
[ads startWithCompletionHandler:^(GADInitializationStatus *status) {
// Optional: Log each adapter's initialization latency.
NSDictionary *adapterStatuses = [status adapterStatusesByClassName];
for (NSString *adapter in adapterStatuses) {
GADAdapterStatus *adapterStatus = adapterStatuses[adapter];
NSLog(@"Adapter Name: %@, Description: %@, Latency: %f", adapter,
adapterStatus.description, adapterStatus.latency);
}
// Start loading ads here...
}];
return YES;
}
@end
Sapere quale rete pubblicitaria vince
Ogni classe di formato dell'annuncio ha una proprietà GADResponseInfo
che contiene
adNetworkClassName
che restituisce il nome della classe della rete pubblicitaria per l'annuncio
corrente. adNetworkClassName
ha un valore solo dopo che un annuncio è stato caricato
correttamente. Il seguente codice mostra come ottenere queste informazioni per gli annunci banner.
Swift
func adViewDidReceiveAd(_ bannerView: AdManagerBannerView) {
print("Banner adapter class name: \(bannerView.responseInfo.adNetworkClassName)")
}
Objective-C
- (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {
NSLog(@"Banner adapter class name: %@", bannerView.responseInfo.adNetworkClassName);
}
Per ulteriori dettagli, consulta Recuperare informazioni sulla risposta all'annuncio.
Utilizzare gli annunci banner con la mediazione
Assicurati di disattivare l'aggiornamento in tutte le UI delle origini annuncio di terze parti per le unità pubblicitarie banner utilizzate nella mediazione. In questo modo si evita un doppio aggiornamento, poiché Ad Manager attiva anche un aggiornamento in base alla frequenza di aggiornamento dell'unità pubblicitaria banner.
Utilizzare gli annunci nativi con la mediazione
Di seguito sono riportate alcune best practice da tenere in considerazione quando implementi la mediazione nativa.
- Norme sulla presentazione degli annunci nativi
- Ogni rete pubblicitaria ha le proprie norme. Quando utilizzi la mediazione, è importante ricordare che la tua app deve comunque rispettare le norme della rete di mediazione che ha fornito l'annuncio.
- Evita di utilizzare la classe
GADMultipleAdsAdLoaderOptions
quando effettui richieste - Le richieste di più annunci nativi pubblicano solo annunci Google. La funzionalità relativa a più annunci nativi non supporta la mediazione.
Leggi statali sulla privacy degli Stati Uniti e GDPR
Se devi rispettare le leggi sulla privacy degli stati USA o il Regolamento generale sulla protezione dei dati (GDPR), segui i passaggi descritti nelle impostazioni relative alle normative degli stati USA o nelle impostazioni relative al GDPR per aggiungere i tuoi partner di mediazione all'elenco dei partner pubblicitari per gli stati USA o per il GDPR di Privacy e messaggi di Ad Manager. In caso contrario, i partner non potranno pubblicare annunci nella tua app.
Scopri di più sull'attivazione del trattamento dati limitato (RDP) e sull'ottenimento del consenso ai sensi del GDPR con l'SDK Google User Messaging Platform (UMP).