Integra maio con la Mediación de AdMob

En esta guía, se muestra cómo usar el Google Mobile Ads SDK for React Native 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 React Native.

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 están traducidas. Sin embargo, en las descripciones y las instrucciones que se incluyen aquí, las etiquetas y los botones se mencionan con sus equivalentes en inglés. Por ejemplo, "URL スキーム" es "esquema de URL".

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de maio ofrece las siguientes funciones:

Integración
Ofertas
Cascada
Formatos
Aplicación abierta
Banner
Intersticial
Recompensado
Intersticial recompensado
Nativo

Requisitos previos

Antes de continuar, verifica lo siguiente:

  • Es la versión más reciente de Google Mobile Ads SDK for React Native.
  • Versión 0.85.0 o posterior del framework de React Native
  • Para realizar la implementación en Android, haz lo siguiente:
    • Nivel de API de Android 24 o posterior
  • Para realizar la implementación en iOS, haz lo siguiente:
    • Objetivo de implementación de iOS 15.0 o posterior
  • Un proyecto de React Native en funcionamiento configurado con Google Mobile Ads SDK for React Native. Consulta Configura Google Mobile Ads SDK for React Native para obtener más detalles.
  • Configura la Mediación de AdMob.

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

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 Anuncio intersticial de video 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 Update.

Android

iOS

En la página Application Management, toma nota del ID de contenido multimedia. Es necesario para configurar tu unidad de anuncios de AdMob en la siguiente 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 siguiente sección.

Android

iOS

(Solo para cascada) 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 tu ID de unidad de anuncios para la mediación. En la página de la API de informes, anota el ID de la 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

En el directorio raíz de tu proyecto, instala el adaptador de mediación de Google Mobile Ads SDK for React Native para maio. Completa lo siguiente:

  1. Copia el archivo tar del adaptador Google Mobile Ads SDK for React Native del directorio gma-sdk-react-native/adapters/maio/ al directorio local_packages/ de tu proyecto. Si no tienes la carpeta adapters, consulta Requisitos previos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/maio/gma-mediation-maio-0.1.0.tgz local_packages/

    Reemplaza EXTRACT_DIR por la ruta de acceso al directorio en el que extrajiste el archivo.

  2. Instala el paquete del adaptador con el administrador de paquetes que prefieras:

    npm

    npm install ./local_packages/gma-mediation-maio-0.1.0.tgz

    hilo

    yarn add ./local_packages/gma-mediation-maio-0.1.0.tgz

  3. Si compilas para Android, agrega el siguiente repositorio al archivo build.gradle en el directorio android de tu proyecto:

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

Paso 4: Agrega el código requerido

Android

No se requiere ningún 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 de Google Mobile Ads SDK for React Native recibirán automáticamente anuncios de prueba de maio en los teléfonos y las 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 lugar).
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 lugar).
103 El adaptador de maio no admite el formato del anuncio que se solicita.
104 Ya se cargó un anuncio para esta configuración de red.

Versión 0.1.0

  • Versión inicial