Integre maio con la mediación

En esta guía, se muestra cómo usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de Maio mediante mediación, que abarca las integraciones en cascada. En él, se explica 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 Unity.

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

Integraciones y formatos de anuncios admitidos

El adaptador de mediación para Maio tiene las siguientes funciones:

Integración
Ofertas
Cascada
Formatos
Banner
Anuncios intersticiales
Recompensado

Requisitos

  • Unity 4 o versiones posteriores
  • SDK de anuncios de Google para dispositivos móviles más reciente
  • Para implementar en Android, haz lo siguiente:
    • Nivel de API 21 o versiones posteriores de Android
  • Para implementar en iOS:
    • Objetivo de implementación de iOS 12.0 o superior
  • Un proyecto de Unity en funcionamiento configurado con el SDK de anuncios de Google para dispositivos móviles Consulta Cómo comenzar para obtener más información.
  • Completa la guía de introducción de mediación.

Paso 1: Configura los parámetros 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 al tipo de anuncio que prefieras.

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

Android

iOS

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

Android

iOS

(Solo cascada) Además del ID de media 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, anota el ID de API y la CLAVE DE API.

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

Cómo configurar la mediación para tu unidad de anuncios

Android

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

iOS

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

Paso 3: Importa el SDK de maio y el adaptador

OpenUPM-CLI

Si tienes instalado OpenUPM-CLI, puedes instalar el complemento de mediación de Google Mobile Ads para Unity en tu proyecto. Para ello, ejecuta el siguiente comando desde el directorio raíz de tu proyecto:

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

En el editor de proyectos de Unity, selecciona Edit > Project Settings > Package Manager para abrir la configuración de Unity Package Manager.

En la pestaña Registros con alcance (Scoped Registries), agrega OpenUPM como un registro con alcance con los siguientes detalles:

  • Nombre: OpenUPM
  • URL: https://package.openupm.com
  • Permisos: com.google

Detalles de OpenUPM

Luego, ve a Window > Package Manager para abrir Unity Package Manager y selecciona My Registries en el menú desplegable.

Registros de Unity

Selecciona el paquete de Google Mobile Ads maio Mediation y haz clic en Install.

Instalar desde OpenUPM

Paquete de Unity

Descarga la versión más reciente del complemento de mediación de Google Mobile Ads para Magento desde el vínculo de descarga en el Registro de cambios y extrae el GoogleMobileAdsMaioMediation.unitypackage del archivo ZIP.

En el editor de tu proyecto de Unity, selecciona Assets > Import Package > Custom Package y busca el archivo GoogleMobileAdsMaioMediation.unitypackage que descargaste. Asegúrate de que todos los archivos estén seleccionados y haz clic en Importar.

Importa desde Unity

Luego, selecciona Assets > External Dependency Manager > Android Resolver > Force Resolve. La biblioteca de External Dependency Manager realizará la resolución de dependencias desde cero y copiará las dependencias declaradas en el directorio Assets/Plugins/Android de tu app de Unity.

Forzar resolución

Paso 4: Agrega el código obligatorio

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

Habilitar anuncios de prueba

Asegúrate de registrar tu dispositivo de prueba en Ad Manager.

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.

Cómo verificar los anuncios de prueba

Para verificar que recibes anuncios de prueba demaio, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la maio (Waterfall) fuente de anuncios.

Códigos de error

Si el adaptador no recibe un anuncio de maio, los publicadores pueden verificar el error subyacente de la respuesta del 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

Estos son los códigos y los mensajes adjuntos que arroja el adaptador de Maio cuando no se carga un anuncio:

Android

Código de error Motivo
0-10 maio mostró 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 de 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 mostró un error específico del SDK. Consulta el código de maio para obtener más detalles.
101 mayo aún no tiene un anuncio disponible.
102 Parámetros de servidor no válidos (p. ej., falta el ID de posición)
103 El adaptador 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 complemento de mediación de Unity de mayo

Versión 2.0.4

Versión 2.0.3

Versión 2.0.2

Versión 2.0.1

Versión 2.0.0

Versión 1.4.3

Versión 1.4.2

Versión 1.4.1

Versión 1.4.0

Versión 1.3.6

Versión 1.3.5

Versión 1.3.4

Versión 1.3.3

Versión 1.3.2

Versión 1.3.1

Versión 1.3.0

Versión 1.2.3

  • Se actualizó el complemento para admitir la nueva API de Rewarded.
  • Admite la versión 1.1.7.0 del adaptador de Android de mayo.
  • Admite la versión 1.4.6.0 del adaptador para iOS de mayo.

Versión 1.2.2

  • Admite la versión 1.1.6.0 del adaptador de Android de Maio.
  • Admite la versión 1.4.2.0 del adaptador para iOS de mayo.

Versión 1.2.1

  • Admite la versión 1.1.6.0 del adaptador de Android de Maio.
  • Admite la versión 1.4.1.0 del adaptador para iOS de mayo.

Versión 1.2.0

  • Es compatible con la versión 1.1.4.1 del adaptador de Android de Maio.
  • Admite la versión 1.4.0.0 del adaptador para iOS de mayo.

Versión 1.1.3

  • Admite la versión 1.1.3.1 del adaptador de Android de mayo.
  • Admite la versión 1.3.2.0 del adaptador para iOS de mayo.

Versión 1.1.2

  • Admite la versión 1.1.3.0 del adaptador de Android de Maio.
  • Compatible con el adaptador de macOS para iOS versión 1.3.2.0.

Versión 1.1.1

  • Admite la versión 1.1.1.0 del adaptador de Android de Maio.
  • Admite la versión 1.3.1.1 del adaptador para iOS de Maio.

Versión 1.1.0

  • Admite la versión 1.1.0.0 del adaptador de Android de Maio.
  • Compatible con el adaptador de macOS para iOS versión 1.3.0.0.

Versión 1.0.2

  • Admite la versión 1.0.8 del SDK de Android.
  • Admite la versión 1.2.19 del SDK de iOS de mayo.

Versión 1.0.1

  • Admite la versión 1.0.7 del SDK de Android de mayo.
  • Compatible con la versión 1.2.19 del SDK de maio iOS.

Versión 1.0.0

  • Primer lanzamiento
  • Admite la versión 1.0.6 del SDK de Android de mayo.
  • Admite la versión 1.2.18 del SDK de iOS de mayo.