Configurar a mediação

Selecione a plataforma: Android Novo Android iOS Unity Flutter

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

Pré-requisitos

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

Não conhece a mediação? Leia Introdução à mediação.

Para lances: Google Mobile Ads SDK 18.3.0 ou mais recente.

Inicializar Google Mobile Ads SDK

O guia de início rápido mostra como inicializar o Google Mobile Ads SDK. Durante essa chamada de inicialização, os adaptadores de mediação também são inicializados. É importante aguardar a conclusão da inicialização antes de carregar anúncios para verificar a participação total de cada rede de publicidade na primeira solicitação de anúncio.

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

Java

public void initialize(Context context) {
  new Thread(
          () ->
              // Initialize the Google Mobile Ads SDK on a background thread.
              MobileAds.initialize(context, this::logAdapterStatus))
      .start();
}

private void logAdapterStatus(InitializationStatus initializationStatus) {
  // Check each adapter's initialization status.
  Map<String, AdapterStatus> statusMap = initializationStatus.getAdapterStatusMap();
  for (Map.Entry<String, AdapterStatus> entry : statusMap.entrySet()) {
    String adapterClass = entry.getKey();
    AdapterStatus status = entry.getValue();
    Log.d(
        TAG,
        String.format(
            "Adapter name: %s, Description: %s, Latency: %d",
            adapterClass, status.getDescription(), status.getLatency()));
  }
}
MediationSnippets.java

Kotlin

fun initialize(context: Context) {
  CoroutineScope(Dispatchers.IO).launch {
    // Initialize the Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(context, ::logAdapterStatus)
  }
}

private fun logAdapterStatus(initializationStatus: InitializationStatus) {
  // Check each adapter's initialization status.
  for ((adapterClass, status) in initializationStatus.adapterStatusMap) {
    Log.d(
      TAG,
      "Adapter: $adapterClass, Status: ${status.description}, Latency: ${status.latency}ms",
    )
  }
}

MediationSnippets.kt

Verificar qual classe de adaptador da rede de publicidade carregou o anúncio

Confira um exemplo de código que registra o nome da classe da rede de publicidade de um anúncio de banner:

Java

ResponseInfo responseInfo = ad.getResponseInfo();
String adapterClassName = null;
if (responseInfo != null) {
  adapterClassName = responseInfo.getMediationAdapterClassName();
}
Log.d(TAG, "Adapter class name: " + adapterClassName);
ResponseInfoSnippets.java

Kotlin

Log.d(TAG, "Adapter class name:" + ad.responseInfo?.mediationAdapterClassName)
ResponseInfoSnippets.kt

Consulte a documentação ResponseInfo em getMediationAdapterClassName() para mais detalhes sobre esse método.

Inicializar o objeto de anúncio com uma instância de atividade

No construtor de um novo objeto de anúncio (por exemplo, AdManagerAdView), você precisa transmitir um objeto do tipo Context. Esse Context é transmitido a outras redes de publicidade ao usar a mediação. Algumas redes de publicidade exigem um Context mais restritivo do tipo Activity e talvez não consigam veicular anúncios sem uma instância de Activity. Portanto, recomendamos transmitir uma instância de Activity ao inicializar objetos de anúncio para verificar uma experiência consistente com as redes de publicidade mediadas.

Desative a atualização em todas as interfaces de origem de anúncios de terceiros para blocos de anúncios de 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 algumas práticas recomendadas ao implementar a mediação nativa.

Política de apresentação de anúncios nativos
Cada rede de publicidade tem políticas próprias. Ao usar a mediação, é importante lembrar que seu app ainda precisa obedecer às políticas da rede mediada que forneceu o anúncio.
Usar loadAd() em vez de loadAds()
O método loadAds() veicula apenas anúncios do Google. Para anúncios mediados, use loadAd().

Leis Estaduais de Privacidade dos EUA e 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 nas configurações das regulamentações estaduais dos EUA ou nas configurações do GDPR para adicionar seus parceiros de mediação na lista de parceiros de anúncios das Leis Estaduais de Privacidade dos EUA ou do GDPR em Privacidade e mensagens do Ad Manager. Caso contrário, os parceiros não poderão veicular anúncios no seu app.

Saiba mais sobre como ativar o tratamento de dados restrito (RDP) e receber o consentimento do GDPR com o SDK da plataforma de mensagens de usuários (UMP) do Google.

Avançar
Escolher origens de anúncios