Mediar con Android

En este artículo se describe cómo instalar y configurar adaptadores de mediación para el SDK de Android.

Información general

La mediación permite que la aplicación solicite anuncios de varias redes de anuncios a través del SDK de Android. Cada adaptador conecta el SDK de Android a un SDK de red. Durante una solicitud de anuncio, la mediación comprueba los orígenes de demanda configurados hasta que uno llena la solicitud o no queda ninguna demanda.

Redes y tipos de medios admitidos

Se admiten los siguientes adaptadores de mediación y tipos de medios:

Origen de demanda Versión del SDK de red Banner Intersticial Nativa Docs
Google AdMob 24.5.0 Sí Sí Sí Mediación de AdMob
Administrador de anuncios de Google 24.5.0 Sí Sí No Mediación de Google Ad Manager
SmartAdServer 7.23.0 Sí Sí No Documentación del SDK de SmartAdServer

Requisitos

  • La aplicación debe usar Android 6.0 (nivel de API 23) o posterior al integrar el SDK de anuncios de Google para móviles (heredado) 24.5.0.
  • En estas instrucciones, se asume que usa Android Studio y Gradle.
  • Instale una versión de SDK de Android compatible. Para obtener instrucciones, consulta las instrucciones de integración del SDK de Android.

Gradle combina automáticamente las entradas de manifiesto requeridas de cada adaptador y las reglas de ProGuard del consumidor en su aplicación.

Instalar adaptadores de mediación

Asegúrese de que Maven Central esté incluido en los repositorios del proyecto. A continuación, agrega el SDK de Android y los adaptadores de mediación necesarios al archivo del módulo de build.gradle la aplicación:

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.appnexus.opensdk:appnexus-sdk:[9,10)'
    implementation 'com.appnexus.opensdk.mediatedviews:appnexus-googleplay-mediation:[9,10)'
    implementation 'com.appnexus.opensdk.mediatedviews:appnexus-smartadserver-mediation:[9,10)'
}

Cada dependencia del adaptador incluye una versión compatible de su SDK de red.

Después de instalar los adaptadores, completa la configuración de cada adaptador antes de cargar los anuncios.

SDK de anuncios de Google para móviles (heredado)

El adaptador de Google admite la demanda de Google AdMob y Google Ad Manager. Ambas fuentes de demanda admiten anuncios publicitarios e intersticiales. La mediación nativa solo está disponible para AdMob.

Agregar el id. de la aplicación de Google (AdMob y Google Ad Manager)

Agregue la clave de com.google.android.gms.ads.APPLICATION_IDAndroidManifest.xmlmetadatos al archivo . Establece su valor en el id. de tu aplicación de AdMob o Google Ad Manager. Esta configuración a nivel de aplicación se aplica a todos los formatos de anuncios de Google:

<application>
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-################~##########" />
</application>

Devoluciones de llamada del ciclo de vida directo (AdMob y Google Ad Manager)

La mediación de banners de Google requiere reenviar las devoluciones de llamada del ciclo de vida de la actividad del host a BannerAdView. En el caso de los anuncios intersticiales, las devoluciones de llamada evitan respuestas tardías después de que la actividad se pause o destruya. Para obtener ejemplos de implementación, consulte Reenvío de devoluciones de llamada del ciclo de vida.

Pasar una URL de contenido (AdMob y Google Ad Manager)

Para pasar la URL del contenido que rodea a un anuncio a Google, agréguela content_url como palabra clave personalizada al bloque de anuncios. Esto se aplica a las solicitudes de banners e intersticiales de AdMob y Google Ad Manager, y a las solicitudes nativas de AdMob. En el ejemplo siguiente se usa BannerAdView:

// Banner
val banner = BannerAdView(this) // Create the banner ad view
banner.addCustomKeywords("content_url", "https://www.example.com") // Set the content URL

Establecer un ID proporcionado por el editor (solo Google Ad Manager)

Para pasar un identificador definido por el editor a Google Ad Manager para la segmentación y la generación de informes de anuncios, establece un ID proporcionado por el editor (PPID) antes de realizar solicitudes de anuncios. Esto solo se aplica a petición de Google Ad Manager:

GooglePlayAdsSettings.setGooglePublisherProvidedId("example-ppid-123") // Set the Google PPID

Configurar el procesamiento de medios nativos (solo AdMob)

Elige cómo tu aplicación procesa los medios en los anuncios nativos de AdMob:

  • Representación predeterminada: El adaptador devuelve las URL de los activos de imagen y no rellena el MediaViewarchivo .
  • Renderizado multimedia de Google: Para permitir que MediaView se procese la imagen o el recurso de vídeo, llame AdMobNativeSettings.setEnableMediaView(true) antes de realizar la solicitud de anuncio nativo. La vista utilizada para representar la respuesta debe extenderse com.google.android.gms.ads.nativead.NativeAdView.
  • Reproducción de vídeo: Opcionalmente, utilícelo VideoOptions para configurar cómo se reproduce el vídeo nativo.

En el ejemplo siguiente se habilita MediaView e inicia el vídeo nativo silenciado:

val videoOptions = VideoOptions.Builder().setStartMuted(true).build() // Start native video muted
AdMobNativeSettings.setVideoOptions(videoOptions) // Configure native video playback
AdMobNativeSettings.setEnableMediaView(true) // Enable Google MediaView rendering
val nativeAdRequest = NativeAdRequest(this, "123456") // Create the native ad request
nativeAdRequest.loadAd() // Load the native ad

SmartAdServer

El adaptador SmartAdServer no requiere configuración adicional después de agregar su dependencia.

Redes de mediación personalizadas

Microsoft Monetize proporciona compatibilidad integrada para varias redes de anuncios móviles. Para mediar en otra red:

  • Se actualizó por última vez el