Integra maio con la mediación

En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles 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 de Flutter.

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 mencionan con sus equivalentes en inglés. Por ejemplo, "URL スキーム" significa "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
Anuncios intersticiales
Recompensado
Nativo

Requisitos

  • SDK de anuncios de Google para dispositivos móviles más reciente
  • Flutter 3.7.0 o versiones posteriores
  • Para realizar la implementación en Android
    • Nivel de API 23 o posterior de Android
  • Para realizar la implementación en iOS:
    • Objetivo de implementación de iOS 12.0 o posterior
  • Un proyecto de Flutter en funcionamiento configurado con el SDK de anuncios de Google para dispositivos móviles Consulta Cómo comenzar para obtener más detalles.
  • Completar 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 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 intersticial como el Tipo de anuncio y, luego, haz clic en Actualizar.

Android

iOS

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.

Android

iOS

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

Android

iOS

En la página Administración de zonas, toma nota del ID de zona. También lo necesitarás para configurar tu unidad de anuncios de AdMob en la próxima sección.

Android

iOS

(Solo en cascada) Además del ID de medio 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 Reporting, 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

Android

Para obtener instrucciones, consulta el paso 2 de la guía para Android.

iOS

Para obtener instrucciones, consulta el paso 2 de la guía para iOS.

Paso 3: Importa el SDK y el adaptador de maio

Integración a través de pub.dev

Agrega la siguiente dependencia con las versiones más recientes del SDK y el adaptador de maio en el archivo pubspec.yaml de tu paquete:

dependencies:
  gma_mediation_maio: ^

Integración manual

Descarga la versión más reciente del complemento de mediación de Google Mobile Ads para maio, extrae el archivo descargado y agrega la carpeta del complemento extraído (y su contenido) a tu proyecto de Flutter. Luego, haz referencia al complemento en tu archivo pubspec.yaml agregando la siguiente dependencia:

dependencies:
  gma_mediation_maio:
    path: path/to/local/package

Paso 4: Agrega el código requerido

Android

No se requiere código adicional para la integración de maio.

iOS

Integración de SKAdNetwork

Sigue la documentación de maio para agregar los identificadores de SKAdNetwork al archivo Info.plist de tu proyecto.

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 7.26.0 o una posterior del SDK de anuncios de Google para dispositivos móviles 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 en las siguientes clases:

Android

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

iOS

Formato Nombre de clase
Intersticial GADMMaioInterstitialAdapter
Recompensado GADMMaioRewardedAdapter

A continuación, se indican los códigos y los mensajes correspondientes que arroja el adaptador de maio cuando no se carga un anuncio:

Android

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

iOS

Código de error Motivo
0-10 maio devolvió un error específico del SDK. Consulta el código de maio para obtener más detalles.
101 maio aún no tiene un anuncio disponible.
102 Parámetros del servidor no válidos (p.ej., falta el ID de posición).
103 El adaptador de maio no admite el formato de anuncio que se solicita.
104 Ya se cargó un anuncio para esta configuración de red.

Registro de cambios del adaptador de mediación de maio para Flutter

Versión 1.0.3

Versión 1.0.2

Versión 1.0.1

Versión 1.0.0