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, 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, las etiquetas y los botones se incluyen junto con su traducción en español. Por ejemplo, "URL スキーム" es "URL Scheme".

Integraciones y formatos de anuncios admitidos

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

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado
Nativo

Requisitos

  • Nivel de API 24 o posterior de Android
  • SDK de maio 1.0.7 o versiones posteriores

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 Administración de aplicaciones en la barra lateral izquierda y, luego, en Nueva aplicación.

Selecciona la pestaña correspondiente a tu Tipo de anuncio preferido.

Intersticial

Ingresa el Nombre de tu app, selecciona la plataforma y proporciona la URL de la app. Selecciona Video interstitial como el Tipo de anuncio y, luego, haz clic en Actualizar.

Recompensado

Ingresa el Nombre de tu app, selecciona la plataforma y proporciona la URL de la app. Selecciona Video Rewards como el Tipo de anuncio y, luego, haz clic en Actualizar.

En la página Administración de aplicaciones, toma nota del ID de medios. Es necesario para configurar tu bloque de anuncios de Ad Manager en la próxima sección.

En la página Administración de zonas, anota el ID de zona. También se necesitará para configurar tu bloque de anuncios de Ad Manager en la próxima sección.

Además del ID de medio y el ID de zona, necesitarás el ID de API y la CLAVE DE API para configurar tu ID de unidad de anuncios para la mediación. En la página de la API de Reporting, anota el ID de API y la CLAVE DE API.

Paso 2: Configura la demanda de maio en la IU de Ad Manager

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

Accede a tu cuenta de Ad Manager.

Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento.

Ingresa un Nombre único para tu grupo de rendimiento, establece el Estado en Activo, selecciona tu Formato del anuncio y establece el Tipo de inventario en Aplicación para dispositivos móviles. En la sección Segmentación > Inventario, selecciona la unidad de anuncios en Inventario y Aplicación para dispositivos móviles a la que deseas agregar la mediación.

A continuación, haz clic en el botón Agregar socio de rendimiento.

Si ya tienes un socio de rendimiento para maio, puedes seleccionarlo. De lo contrario, selecciona Crear un socio de rendimiento nuevo.

Selecciona maio como la red de anuncios, ingresa un nombre único y habilita la Mediación.

Activa la recopilación automática de datos y, luego, ingresa el ID de API y la clave de API que obtuviste en la sección anterior.

Una vez que se selecciona el Socio de rendimiento, elige Mediación del SDK para dispositivos móviles como el Tipo de integración, Android como la Plataforma y Activo como el Estado. Ingresa el ID de medios y el ID de zona que obtuviste en la sección anterior. Luego, ingresa un valor de CPM predeterminado.

Cuando termines, haz clic en Guardar en la parte inferior de la página.

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 siguientes dependencias de implementación y configuraciones:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

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.24.0-beta02'
    implementation 'com.google.ads.mediation:maio:2.0.8.0'
}

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 agrégala a tu proyecto.
  • Navega a los artefactos del adaptador de maio en el repositorio de Maven de Google. Selecciona la versión más reciente, descarga el archivo.aar del adaptador de maio y agrégalo a tu proyecto.

Paso 4: Agrega el código requerido

No se requiere 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 en Ad Manager.

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 mensajes correspondientes que arroja el adaptador de maio cuando no se carga 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".