Se usó la API de Cloud Translation para traducir esta página.

Comenzar

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

Requisitos previos

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

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

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

Inicializa el SDK de Mobile Ads

En la guía de inicio rápido, se muestra cómo inicializar el SDK de Mobile Ads. 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 garantizar la participación completa de cada red de publicidad en la primera solicitud de anuncios.

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

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();
    }
}

Kotlin

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

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

A continuación, se incluye un código de muestra que registra el nombre de clase de la red de publicidad de un anuncio de banner:

Java

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

Kotlin

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

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

Inicializa tu objeto de anuncio con una instancia de actividad

En el constructor de un nuevo objeto de anuncio (por ejemplo, AdManagerAdView), debes pasar un objeto de 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 que sea del tipo Activity y es posible que no puedan publicar anuncios sin una instancia de Activity. Por lo tanto, recomendamos pasar una instancia de Activity cuando inicialices objetos de anuncios para garantizar una experiencia coherente con tus redes de publicidad mediadas.

Cómo utilizar 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 los bloques de anuncios de banner que se usan en la mediación. De esta manera, se evita una actualización doble, ya que Ad Manager también activa una actualización en función de la frecuencia de actualización de la unidad de anuncios de banner.

Cómo usar anuncios nativos con la mediación

Las siguientes son algunas prácticas recomendadas que se deben tener en cuenta cuando se implementa la mediación nativa.

Política de presentación de anuncios nativos: Cada red de publicidad tiene sus propias políticas. Cuando uses la mediación, es importante recordar que tu app debe cumplir con las políticas de la red mediada 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.

RGPD y Leyes de Privacidad Estatales de EE.UU.

Si necesitas cumplir con 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 GDPR para agregar tus socios de mediación a los estados de EE.UU. o la lista de socios de anuncios del GDPR en 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 (RDP) y obtener el consentimiento del GDPR con el SDK de Google User Messaging Platform (UMP).

Elija las redes