Configurare la mediazione

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

Prerequisiti

Prima di poter integrare la mediazione per un formato dell'annuncio, devi integrare il formato dell'annuncio nella tua app:

Non hai familiarità con la mediazione? Leggi Introduzione alla mediazione.

Per le offerte: Google Mobile Ads SDK 7.53.1 o versioni successive.

Inizializzare Google Mobile Ads SDK

La guida rapida mostra come inizializzare Google Mobile Ads SDK. 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 partecipazione completa di ogni rete pubblicitaria alla prima richiesta di annuncio.

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

Swift

MobileAds.shared.start { initializationStatus in
  // Check each adapter's initialization status.
  for (adapterName, status) in initializationStatus.adapterStatusesByClassName {
    print(
      "Adapter: \(adapterName), Description: \(status.description), Latency: \(status.latency)")
  }
}

Objective-C

[[GADMobileAds sharedInstance]
    startWithCompletionHandler:^(GADInitializationStatus *_Nonnull status) {
      // Check each adapter's initialization status.
      NSDictionary<NSString *, GADAdapterStatus *> *adapterStatuses =
          status.adapterStatusesByClassName;
      for (NSString *adapterName in adapterStatuses) {
        GADAdapterStatus *adapterStatus = adapterStatuses[adapterName];
        NSLog(@"Adapter: %@, Description: %@, Latency: %f", adapterName,
              adapterStatus.description, adapterStatus.latency);
      }
    }];

Scopri 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

print(
  "Adapter class name: \(ad.responseInfo?.loadedAdNetworkResponseInfo?.adNetworkClassName ?? "Unknown")"
)

Objective-C

NSLog(@"Adapter class name: %@",
      ad.responseInfo.loadedAdNetworkResponseInfo.adNetworkClassName ?: @"Unknown");

Per ulteriori dettagli, consulta Recuperare informazioni sulla risposta all'annuncio.

Assicurati di disattivare l'aggiornamento nelle UI di tutte le 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 di 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à di più annunci nativi 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 in Impostazioni delle normative statali degli Stati Uniti o Impostazioni GDPR per aggiungere i partner di mediazione all'elenco dei partner pubblicitari statali degli Stati Uniti o GDPR di Privacy e messaggi di Ad Manager. In caso contrario, i partner potrebbero non pubblicare annunci sulla tua app.

Scopri di più su come attivare il trattamento dati limitato (RDP) e ottenere il consenso GDPR con l' SDK Google User Messaging Platform (UMP).