Per iniziare

Questa guida mostra come integrare un'app di mediazione con la tua app per iOS.

Prerequisiti

Prima di poter integrare la mediazione per un formato dell'annuncio, devi integrare il formato dell'annuncio 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 Mobile Ads

La guida rapida illustra come inizializzare l'SDK 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 garantire la piena partecipazione di ogni rete pubblicitaria alla prima richiesta di annuncio.

Il seguente codice di esempio mostra come controllare lo stato di inizializzazione di ogni adattatore prima di effettuare una richiesta di annunci.

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    let ads = GADMobileAds.sharedInstance()
    ads.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
  }

}

@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

Scopri quale rete pubblicitaria vince

Ogni classe di formato dell'annuncio ha una proprietà GADResponseInfo contenente adNetworkClassName che restituisce il nome della classe della rete pubblicitaria per l'annuncio attuale. adNetworkClassName ha un valore solo dopo che un annuncio è stato caricato correttamente. Il seguente codice mostra come ottenere queste informazioni per gli annunci banner.

func adViewDidReceiveAd(_ bannerView: GAMBannerView) {
  print("Banner adapter class name: \(bannerView.responseInfo.adNetworkClassName)")
}

- (void)adViewDidReceiveAd:(GAMBannerView *)bannerView {
  NSLog(@"Banner adapter class name: %@", bannerView.responseInfo.adNetworkClassName);
}

Per maggiori dettagli, consulta la sezione Recupero delle 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 basato sulla frequenza di aggiornamento dell'unità pubblicitaria banner.

Utilizzare gli annunci nativi con la mediazione

Di seguito sono riportate alcune best practice da tenere presenti quando si implementa la mediazione nativa.

Norme relative alla 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 mediata che ha fornito l'annuncio.

Evita di utilizzare la classe GADMultipleAdsAdLoaderOptions quando effettui richieste

Nelle richieste di più annunci nativi vengono pubblicati solo annunci Google. La funzionalità di annunci nativi multipli non supporta la mediazione.

Leggi statali sulla privacy degli Stati Uniti e GDPR

Se devi rispettare le leggi statali sulla privacy degli Stati Uniti o il Regolamento generale sulla protezione dei dati (GDPR), segui i passaggi descritti nelle impostazioni dei regolamenti statali degli Stati Uniti o nelle impostazioni GDPR per aggiungere i tuoi partner di mediazione all'elenco dei partner pubblicitari degli stati USA o GDPR di Ad Manager. In caso contrario, i partner potrebbero non pubblicare annunci nella tua app.