Começar

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:

• Anúncios de banner
• Anúncios intersticiais
• Anúncios nativos
• Anúncios premiados
• Anúncios intersticiais premiados

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

Para lances: SDK dos anúncios para dispositivos móveis do Google 18.3.0 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.

import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.AdapterStatus;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;

public class MainActivity extends AppCompatActivity {

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        new Thread(
                () ->
                    // Initialize the Google Mobile Ads SDK on a background thread.
                    MobileAds.initialize(
                        this,
                        initializationStatus -> {
                          Map<String, AdapterStatus> statusMap =
                              initializationStatus.getAdapterStatusMap();
                          for (String adapterClass : statusMap.keySet()) {
                            AdapterStatus status = statusMap.get(adapterClass);
                            Log.d(
                                "MyApp",
                                String.format(
                                    "Adapter name: %s, Description: %s, Latency: %d",
                                    adapterClass, status.getDescription(), status.getLatency()));
                          }
                          // Start loading ads here...
                        }))
            .start();
    }
}

import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val backgroundScope = CoroutineScope(Dispatchers.IO)
    backgroundScope.launch {
      // Initialize the Google Mobile Ads SDK on a background thread.
      MobileAds.initialize(this@MainActivity) { initializationStatus ->
        val statusMap =
          initializationStatus.adapterStatusMap
        for (adapterClass in statusMap.keys) {
          val status = statusMap[adapterClass]
          Log.d(
            "MyApp", String.format(
              "Adapter name: %s, Description: %s, Latency: %d",
              adapterClass, status!!.description, status.latency
            )
          )
        }
        // Start loading ads here...
      }
    }
  }
}

Verificar qual classe do 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 para um anúncio de banner:

public void onAdLoaded() {
  Log.d("Banner adapter class name: " + ad.getResponseInfo().getMediationAdapterClassName());
}

override fun onAdLoaded() {
  Log.d("Banner adapter class name:" + ad.responseInfo.mediationAdapterClassName)
}

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

Inicializar o objeto do anúncio com uma instância Activity

No construtor de um novo objeto de anúncio (por exemplo, AdManagerAdView), é necessário transmitir um objeto do tipo Context. Esse Context é transmitido para outras redes de publicidade ao usar a mediação. Algumas redes de publicidade exigem um Context mais restritivo que seja do tipo Activity e podem não conseguir veicular anúncios sem uma instância Activity. Portanto, recomendamos passar uma instância Activity ao inicializar objetos de anúncio para garantir uma experiência consistente com suas redes de anúncio mediadas.

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.

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 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.