Começar

Este guia mostra como integrar um adaptador de mediação ao seu app iOS.

Pré-requisitos

Antes de integrar a mediação a um formato de anúncio, você precisa integrar esse formato ao seu app:

Você é novo na mediação? Leia Introdução à mediação.

Para lances: SDK dos anúncios para dispositivos móveis do Google 7.53.1 ou mais recente.

Inicializar o SDK dos anúncios para dispositivos móveis

O guia de início rápido mostra como inicializar o SDK dos anúncios para dispositivos móveis. Durante essa chamada de inicialização, os adaptadores de mediação também são inicializados. É importante esperar a inicialização ser concluída antes de carregar anúncios para garantir a participação total de todas as redes de publicidade na primeira solicitação de anúncio.

O exemplo de código abaixo mostra como verificar o status de inicialização de cada adaptador antes de fazer uma solicitação de anúncio.

Swift

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
  }

}

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

Descubra qual rede de publicidade vence

Cada classe de formato de anúncio tem uma propriedade GADResponseInfo que contém adNetworkClassName, que retorna o nome da classe da rede de publicidade para o anúncio atual. O adNetworkClassName só tem um valor quando um anúncio é carregado com sucesso. O código a seguir mostra como conseguir essas informações para anúncios de banner.

Swift

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

Objective-C

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

Consulte Como recuperar informações sobre a resposta do anúncio para saber mais.

Usar anúncios de banner com a mediação

Desative a atualização em todas as interfaces de origem de anúncios de terceiros para blocos de anúncios banner usados na mediação. Isso evita uma atualização dupla, já que o Ad Manager também aciona uma atualização com base na taxa de atualização do bloco de anúncios de banner.

Usar anúncios nativos com mediação

Confira a seguir algumas práticas recomendadas a serem consideradas ao implementar a mediação nativa.

Política de apresentação de anúncios nativos
Cada rede de publicidade tem suas próprias políticas. Ao usar a mediação, é importante lembrar que seu app ainda precisa obedecer às políticas da rede mediada que forneceu o anúncio.
Evite usar a classe GADMultipleAdsAdLoaderOptions ao fazer solicitações
As solicitações de vários anúncios nativos veiculam apenas anúncios do Google. O recurso de vários anúncios nativos não oferece suporte à mediação.

Leis estaduais de privacidade dos EUA e o GDPR

Se você precisar obedecer às leis estaduais de privacidade dos EUA ou ao Regulamento geral de proteção de dados (GDPR), siga as etapas em Configurações de regulamentos estaduais dos EUA ou Configurações do GDPR para adicionar seus parceiros de mediação na lista de estados dos EUA ou de parceiros de anúncios do GDPR em "Privacidade e mensagens" do Ad Manager. Se isso não for feito, os parceiros não vão poder veicular anúncios no seu app.

Saiba como ativar o processamento de dados restrito (RDP, na sigla em inglês) e receber o consentimento do GDPR com o SDK da plataforma de mensagens de usuários do Google (UMP, na sigla em inglês).