Comenzar

En esta guía, se muestra cómo integrar un adaptador de mediación en tu app para Android.

Requisitos previos

Antes de integrar la mediación para un formato de anuncio, debes integrar ese formato de anuncio en tu app:

¿Es la primera vez que utilizas la mediación? Lee la Introducción a la mediación.

Para la oferta: SDK de anuncios de Google para dispositivos móviles 18.3.0 o una versión posterior

Inicializa el SDK de anuncios de Google para dispositivos móviles

En la guía de inicio rápido, se muestra cómo inicializar el SDK de anuncios de Google para dispositivos móviles. Durante esa llamada de inicialización, también se inicializan los adaptadores de mediación. Es importante esperar a que se complete la inicialización antes de cargar anuncios para verificar la participación completa de cada red publicitaria en la primera solicitud de anuncio.

En el siguiente código de muestra, se muestra cómo puedes verificar el estado de inicialización de cada adaptador antes de realizar una solicitud de anuncio.

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

Verifica qué clase de adaptador de red de publicidad cargó el anuncio

A continuación, se muestra un código de muestra que registra el nombre de la clase de la red de publicidad para un anuncio 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

Consulta la documentación de ResponseInfo en getMediationAdapterClassName() para obtener detalles sobre este método.

Inicializa tu objeto de anuncio con una instancia de Activity

En el constructor de un objeto de anuncio nuevo (por ejemplo, AdManagerAdView), debes pasar un objeto del tipo Context. Este Context se pasa a otras redes de publicidad cuando se usa la mediación. Algunas redes de publicidad requieren un Context más restrictivo del tipo Activity y es posible que no puedan publicar anuncios sin una instancia de Activity. Por lo tanto, te recomendamos que pases una instancia de Activity cuando inicialices objetos de anuncios para verificar una experiencia coherente con tus redes de publicidad mediadas.

Usa anuncios de banner con la mediación

Asegúrate de inhabilitar la actualización en todas las IU de fuentes de anuncios de terceros para las unidades de anuncios de banner que se usan en la mediación. Esto evita una actualización doble, ya que Ad Manager también activa una actualización según la frecuencia de actualización de tu unidad de anuncios de banner.

Usa anuncios nativos con la mediación

A continuación, se indican algunas prácticas recomendadas que debes tener en cuenta cuando implementes la mediación nativa.

Política de presentación de anuncios nativos
Cada red publicitaria tiene sus propias políticas. Cuando usas la mediación, es importante recordar que tu app debe seguir cumpliendo con las políticas de la red de mediación que proporcionó el anuncio.
Usa loadAd() en lugar de loadAds()
El método loadAds() solo publica anuncios de Google. Para los anuncios mediados, usa loadAd() en su lugar.

Leyes de privacidad estatales de EE.UU. y RGPD

Si necesitas satisfacer las leyes de privacidad estatales de EE.UU. o el Reglamento General de Protección de Datos (RGPD), sigue los pasos que se indican en la configuración de las reglamentaciones estatales de EE.UU. o en la configuración del RGPD para agregar a tus socios de mediación a la lista de socios publicitarios de los estados de EE.UU. o del RGPD de Privacidad y mensajería de Ad Manager. De lo contrario, es posible que los socios no publiquen anuncios en tu app.

Obtén más información para habilitar el procesamiento de datos restringido (PDR) y obtener el consentimiento del RGPD con el SDK de Google User Messaging Platform (UMP).

Siguiente
Elige las redes