Integra maio con la mediación

En esta guía, se muestra cómo usar GMA Next-Gen SDK para cargar y mostrar anuncios de maio con la Mediación de AdMob, lo que incluye las integraciones en cascada. Además, indica cómo agregar maio a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de maio en una app para Android.

La interfaz del panel de maio usa texto en japonés para sus etiquetas, botones y descripciones, y las capturas de pantalla de esta guía no se tradujeron. Sin embargo, en las descripciones y las instrucciones de esta guía, se hace referencia a las etiquetas y los botones con sus equivalentes en inglés. Por ejemplo, "URL スキーム" es "Esquema de URL".

Integraciones y formatos de anuncios admitidos

El adaptador de mediación para maio tiene las siguientes capacidades:

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos

  • Nivel de API de Android 24 o superior
  • SDK de maio 1.0.7 o superior
  • La versión más reciente de GMA Next-Gen SDK.

  • Completa la guía de introducción a la mediación .

Paso 1: Establece los parámetros de configuración en la IU de maio

Primero, regístrate o accede a tu cuenta de maio. Haz clic en el botón Application management (Administración de aplicaciones) en la barra lateral izquierda y, luego, en New app (App nueva).

Selecciona la pestaña correspondiente al tipo de anuncio que prefieras.

Intersticial

Ingresa el nombre de tu app, selecciona la plataforma y proporciona la URL de la app. Selecciona Video interstitial (Intersticial de video) como el tipo de anuncio y, luego, haz clic en Update (Actualizar).

Recompensado

Ingresa el nombre de tu app, selecciona la plataforma y proporciona la URL de la app. Selecciona Video Rewards (Recompensas de video) como el tipo de anuncio y, luego, haz clic en Update (Actualizar).

En la página Application Management (Administración de aplicaciones), toma nota del ID de contenido multimedia. Es necesario para configurar tu unidad de anuncios de AdMob en la siguiente sección.

En la página Zone Management (Administración de zonas), toma nota del ID de zona. También será necesario para configurar tu unidad de anuncios de AdMob en la siguiente sección.

Además del ID de contenido multimedia y el ID de zona, necesitarás el ID de API y la clave de API para configurar el ID de tu unidad de anuncios para la mediación. En la página de la API de informes, toma nota del ID de API y la clave de API.

Paso 2: Configura la demanda de maio en la IU de AdMob

Configura los parámetros de la mediación para tu unidad de anuncios

Debes agregar maio a la configuración de mediación de tu unidad de anuncios.

Primero, accede a tu cuenta de AdMob. Luego, navega a la pestaña Mediación. Si tienes un grupo de mediación existente que deseas modificar, haz clic en su nombre para editarlo y pasa directamente a la sección Agrega maio como una fuente de anuncios.

Para crear un grupo de mediación nuevo, selecciona Crear grupo de mediación.

Ingresa el formato de anuncios y la plataforma. Luego, haz clic en Continuar.

Asigna un nombre a tu grupo de mediación y selecciona las ubicaciones de segmentación. A continuación, establece el estado del grupo de mediación como Habilitado y haz clic en Agregar unidades de anuncios.

Asocia este grupo de mediación a una o más de tus unidades de anuncios de AdMob existentes. Luego, haz clic en Listo.

Ahora deberías ver la tarjeta de unidades de anuncios completada con las unidades de anuncios que seleccionaste:

Agrega maio como una fuente de anuncios


En la tarjeta Cascada de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios.

Selecciona maio y habilita el interruptor Optimizar. Ingresa el ID de API y la clave de API que obtuviste en la sección anterior para configurar la optimización de la fuente de anuncios para maio. Luego, ingresa un valor de eCPM para maio y haz clic en Continuar.



Si ya tienes una asignación para maio, puedes seleccionarla. De lo contrario, haz clic en Agregar asignación.

A continuación, ingresa el ID de contenido multimedia y el ID de zona que obtuviste en la sección anterior. Luego, haz clic en Listo.


Paso 3: Importa el SDK y el adaptador de maio

En el archivo settings.gradle.kts a nivel del proyecto, agrega los siguientes repositorios:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

En el archivo gradle a nivel de la app, agrega las dependencias de implementación y las configuraciones que se indican a continuación:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:maio:2.0.8.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:maio:2.0.8.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integración manual

  • Descarga la versión más reciente del SDK de maio para Android y agrega la a tu proyecto.
  • Navega a los artefactos del adaptador de maio en el repositorio de Maven de Google. Selecciona la última versión, descarga el archivo `.aar` del adaptador de maio y agrégalo a tu proyecto.

Paso 4: Agrega el código requerido

No se requiere ningún código adicional para la integración de maio en Android.

Paso 5: Prueba tu implementación

Habilita los anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba para AdMob.

Los publicadores que usen la versión 11.6.0 o una posterior de GMA Next-Gen SDK recibirán automáticamente anuncios de prueba de maio en teléfonos y tablets registrados como dispositivos de prueba cuando realicen solicitudes.

Verifica los anuncios de prueba

Para verificar que recibes anuncios de prueba de maio, habilita la prueba de una única fuente de anuncios seleccionando maio (Waterfall) en el inspector de anuncios.

Códigos de error

Si el adaptador no recibe un anuncio de maio, los publicadores pueden verificar el error subyacente en la respuesta de solicitud de anuncio con ResponseInfo.getAdSourceResponses() en las siguientes clases:

Formato Nombre de clase
Intersticial jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Recompensado jp.maio.sdk.android.mediation.admob.adapter.Rewarded

A continuación, se indican los códigos y los correspondientes mensajes que arroja el adaptador de maio cuando se produce un error al cargar un anuncio:

Código de error Motivo
0-10 maio devolvió un error específico del SDK. Consulta el código y la documentación de maio para obtener más detalles.
101 Maio no tiene un anuncio disponible.
102 Parámetros del servidor no válidos (p.ej., falta el ID de posición).
103 El contexto que se usó para cargar un anuncio no era una instancia de `Activity`.