Comenzar

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

Requisitos previos

Para poder integrar la mediación en un formato de anuncio, primero debes integrar esa formato del anuncio en tu app:

¿Es la primera vez que utilizas la mediación? Leído Introducción a la mediación.

Para establecer ofertas: SDK de anuncios de Google para dispositivos móviles 18.3.0 o una superior.

Inicializa el SDK de Mobile Ads

La guía de inicio rápido te muestra cómo inicializar los anuncios móviles SDK. Durante esa llamada de inicialización, los adaptadores de mediación también se inicializan. Es importante esperar a que se complete la inicialización antes de cargas anuncios para garantizar la participación total de todas las redes de publicidad en el primera solicitud de anuncio.

En el siguiente código de muestra, se muestra cómo puedes verificar la inicialización de cada adaptador estado 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 información sobre este método.

Inicializa tu objeto de anuncio con una instancia de actividad

En el constructor de un objeto de anuncio nuevo (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. Algunos Las redes de publicidad requieren una Context más restrictiva que sea del tipo Activity y es posible que no puedan publicar anuncios sin una instancia de Activity. Por lo tanto, se recomienda 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 anuncios de banner las unidades que se usan en la mediación. Esto evita un doble actualización, ya que Ad Manager también activa una actualización según la frecuencia de actualización de tu unidad de anuncios de banner.

Cómo usar anuncios nativos con la mediación

A continuación, se incluyen algunas prácticas recomendadas que se deben tener en cuenta a la hora de implementar anuncios nativos mediación.

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

RGPD y Leyes de Privacidad Estatales de EE.UU.

Si necesitas cumplir con la Especificación de privacidad de estados leyes o la Protección General de Datos Reglamento General de Protección de Datos (RGPD), sigue las pasos en las reglamentaciones estatales de EE.UU. de texto o GDPR para agregar tu socios de mediación en la privacidad de Ad Manager de la mensajería lista de socios publicitarios del GDPR o estados de EE.UU. De lo contrario, es posible que los socios la publicación de anuncios en tu app.

Más información para habilitar el procesamiento de datos restringido (RDP) y cómo obtener el GDPR consentimiento con la Plataforma de mensajes de usuarios de Google (UMP) SDK.