En esta guía, se muestra cómo usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de Maio con la Mediación de AdMob, que abarca las integraciones de cascada. En ella, 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 iOS.
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 funciones:
Integración | |
---|---|
Ofertas | |
Cascada | |
Formatos | |
Banner | |
Intersticial | |
Recompensado | |
Nativo |
Requisitos
- Objetivo de implementación de iOS 12.0 o una versión posterior
SDK de anuncios de Google para dispositivos móviles más reciente
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.
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 contenido multimedia. Es necesario configurar tu unidad de anuncios de AdMob en la siguiente sección.
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.
(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 maio en la IU de AdMob
Configura la configuración de 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 Mediation. Si tienes un grupo de mediación existente que deseas modificar, haz clic en su nombre para editarlo y avanza al apartado Cómo agregar Maio como fuente de anuncios.
Para crear un grupo de mediación nuevo, selecciona Crear grupo de mediación.
Ingresa el formato y la plataforma de tu anuncio y, luego, haz clic en Continuar.
Asigna un nombre a tu grupo de mediación y selecciona las ubicaciones para segmentar. A continuación, establece el estado del grupo de mediación en Habilitado y, luego, haz clic en Agregar unidades de anuncios.
Asocia este grupo de mediación con una o más de tus unidades de anuncios existentes de AdMob. Luego, haz clic en Listo.
Ahora deberías ver la tarjeta de unidades de anuncios propagada con las unidades de anuncios que seleccionaste:
Agrega maio como fuente del anuncio
En la tarjeta Cascada de la sección Fuentes de anuncios, selecciona Agregar fuente de anuncios. Luego, selecciona maio.
Selecciona maio y habilita el interruptor Optimize. 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 mayo y haz clic en Continuar.
Si ya tienes una asignación para mayo, 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
Con CocoaPods (recomendado)
Agrega la siguiente línea al Podfile de tu proyecto:
pod 'GoogleMobileAdsMediationMaio'
Desde la línea de comandos, ejecuta lo siguiente:
pod install --repo-update
Integración manual
- Descarga la versión más reciente del SDK de Maio.
- Descarga la versión más reciente del adaptador de Maio desde el vínculo de descarga en el registro de cambios y vincula
maioAdapter.framework
en tu proyecto.
Paso 4: Agrega el código obligatorio
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 fuente del anuncio individual en el inspector de anuncios con las fuentes de anuncios de maio (cascada).
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 GADResponseInfo.adNetworkInfoArray
en las siguientes clases:
Formato | Nombre de clase |
---|---|
Intersticial | GADMMaioInterstitialAdapter |
Recompensado | GADMMaioRewardedAdapter |
Estos son los códigos y los mensajes que genera el adaptador de Maio cuando no se carga un anuncio:
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 | maio 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 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 para iOS de mayo
Versión 2.1.5.1
- Se actualizó
CFBundleShortVersionString
para que tenga tres componentes en lugar de cuatro.
Se compiló y probó con lo siguiente:
- Versión 11.10.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 2.1.5 del SDK de Maio
Versión 2.1.5.0
- Se verificó la compatibilidad con la versión 2.1.5 del SDK de Maio.
Se compiló y probó con lo siguiente:
- Versión 11.6.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 2.1.5 del SDK de Maio
Versión 2.1.4.0
- Se verificó la compatibilidad con la versión 2.1.4 del SDK de Maio.
Se compiló y probó con lo siguiente:
- Versión 11.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 2.1.4 del SDK de Maio
Versión 2.1.3.0
- Se verificó la compatibilidad con la versión 2.1.3 del SDK de Maio.
Se compiló y probó con lo siguiente:
- Versión 11.1.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 2.1.3 del SDK de Maio
Versión 2.1.2.1
- Ahora requiere la versión 11.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
- Se incluyó
Info.plist
en los frameworks dentro deMaioAdapter.xcframework
.
Se compiló y probó con lo siguiente:
- Versión 11.0.1 del SDK de anuncios de Google para dispositivos móviles
- Versión 2.1.2 del SDK de Maio
Versión 2.1.2.0
- Se verificó la compatibilidad con la versión 2.1.2 del SDK de Maio.
Se compiló y probó con lo siguiente:
- Versión 10.14.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 2.1.2 del SDK de Maio
Versión 2.1.1.0
- Se verificó la compatibilidad con la versión 2.1.1 del SDK de Maio.
Se compiló y probó con lo siguiente:
- Versión 10.12.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 2.1.1 del SDK de Maio
Versión 2.0.0.0
- Se verificó la compatibilidad con la versión 2.0.0 del SDK de Maio.
- Se quitó la dependencia de
MaioOB SDK
. - Se quitó la compatibilidad con la arquitectura
armv7
. - Ahora requiere la versión mínima de iOS 12.0.
- Ahora requiere la versión 10.4.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Se compiló y probó con lo siguiente:
- Versión 10.10.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 2.0.0 del SDK de Maio
Versión 1.6.3.1
- Ahora requiere la versión 10.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Se compiló y probó con lo siguiente:
- Versión 10.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.6.3 del SDK de Maio
- Versión 2.0.0-alpha del SDK de MaioOB
Versión 1.6.3.0
- Se actualizó el adaptador para usar la API de
didRewardUser
. - Ahora requiere la versión 9.8.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
- Se verificó la compatibilidad con la versión 1.6.3 del SDK de maio y la versión 2.0.0-alpha del SDK de maioOB.
Se compiló y probó con lo siguiente:
- Versión 9.12.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.6.3 del SDK de Maio
- Versión 2.0.0-alpha del SDK de MaioOB
Versión 1.6.2.0
- Se verificó la compatibilidad con la versión 1.6.2 del SDK de maio y la versión 2.0.0-alpha del SDK de maioOB.
Se compiló y probó con lo siguiente:
- Versión 9.5.0 del SDK de anuncios de Google para dispositivos móviles
- SDK de Maio versión 1.6.2.
- Versión 2.0.0-alpha del SDK de MaioOB
Versión 1.6.1.0
- Se verificó la compatibilidad con la versión 1.6.1 del SDK de maio y la versión 2.0.0-alpha del SDK de maioOB.
Se compiló y probó con lo siguiente:
- Versión 9.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.6.1 del SDK de Maio
- Versión 2.0.0-alpha del SDK de MaioOB
Versión 1.6.0.1
- Se verificó la compatibilidad con la versión 9.0.0 del SDK de anuncios de Google para dispositivos móviles.
- Ahora requiere la versión 9.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Se compiló y probó con lo siguiente:
- Versión 9.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.6.0 del SDK de Maio
- Versión 2.0.0-alpha del SDK de MaioOB
Versión 1.6.0.0
- Se verificó la compatibilidad con la versión 1.6.0 del SDK de maio y la versión 2.0.0-alpha del SDK de maioOB.
Se compiló y probó con lo siguiente:
- Versión 8.13.0 del SDK de anuncios de Google para dispositivos móviles
- Ahora requiere la versión mínima de iOS 10.0.
- Versión 1.6.0 del SDK de Maio
- Versión 2.0.0-alpha del SDK de MaioOB
Versión 1.5.8.0
- Se verificó la compatibilidad con la versión 1.5.8 del SDK de maio y la versión 2.0.0-alpha del SDK de maioOB.
- Se agregó la capacidad de oferta al adaptador para los formatos de anuncios intersticiales y recompensados.
- Se relajó la dependencia del SDK de anuncios de Google para dispositivos móviles versión 8.0.0 o posterior.
Se compiló y probó con lo siguiente:
- Versión 8.7.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.8 del SDK de Maio
- Versión 2.0.0-alpha del SDK de MaioOB
Versión 1.5.6.1
- Se agregaron códigos de error y mensajes estandarizados del adaptador.
- Se actualizó el adaptador para usar el formato
.xcframework
. - Se corrigió un error por el cual, a veces, no se reenviaban los eventos de anuncios recompensados.
- Ahora requiere la versión 8.3.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Se compiló y probó con lo siguiente:
- Versión 8.3.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.6 del SDK de Maio
Versión 1.5.6.0
- Se verificó la compatibilidad con la versión 1.5.6 del SDK de Maio.
- Ahora requiere la versión 7.68.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Se compiló y probó con lo siguiente:
- Versión 7.68.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.6 del SDK de Maio
Versión 1.5.5.0
- Se verificó la compatibilidad con la versión 1.5.5 del SDK de Maio.
- Ahora requiere la versión 7.64.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Se compiló y probó con lo siguiente:
- Versión 7.64.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.5 del SDK de Maio
Versión 1.5.4.0
- Se verificó la compatibilidad con la versión 1.5.4 del SDK de Maio.
- Ahora requiere la versión 7.60.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Se compiló y probó con lo siguiente:
- Versión 7.60.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.4 del SDK de Maio
Versión 1.5.3.1
- Para limitar los tiempos de espera, las solicitudes de anuncios ahora fallarán de inmediato si Maio no tiene un anuncio listo para mostrarse.
- Se quitó la compatibilidad con la arquitectura i386.
Se compiló y probó con lo siguiente:
- Versión 7.58.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.3 del SDK de Maio
Versión 1.5.3.0
- Se verificó la compatibilidad con la versión 1.5.3 del SDK de Maio.
Se compiló y probó con lo siguiente:
- Versión 7.55.1 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.3 del SDK de Maio
Versión 1.5.2.1
- Se corrigió un problema por el que el adaptador no invocaba la devolución de llamada de
-rewardedAdDidPresent:
.
Se compiló y probó con lo siguiente:
- Versión 7.53.1 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.2 del SDK de Maio
Versión 1.5.2.0
- Se verificó la compatibilidad con la versión 1.5.2 del SDK de Maio.
Se compiló y probó con lo siguiente:
- Versión 7.53.1 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.2 del SDK de Maio
Versión 1.5.1.0
- Se verificó la compatibilidad con la versión 1.5.1 del SDK de Maio.
Se compiló y probó con lo siguiente:
- Versión 7.52.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.1 del SDK de Maio
Versión 1.5.0.0
- Se verificó la compatibilidad con la versión 1.5.0 del SDK de Maio.
Se compiló y probó con
- Versión 7.51.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 1.5.0 del SDK de Maio Ads
Versión 1.4.8.0
- Se verificó la compatibilidad con la versión 1.4.8 del SDK de Maio.
Versión 1.4.6.0
- Se verificó la compatibilidad con la versión 1.4.6 del SDK de Maio.
- Se actualizó el adaptador para usar la nueva API de anuncios recompensados.
- Ahora requiere la versión 7.42.2 o posterior del SDK de anuncios de Google para dispositivos móviles.
Versión 1.4.2.0
- Se verificó la compatibilidad con la versión 1.4.2 del SDK de Maio.
Versión 1.4.1.0
- Se verificó la compatibilidad con la versión 1.4.1 del SDK de Maio.
- Se corrigió un problema por el que el adaptador de Maio podía fallar si se proporcionaban varios MediaIds desde AdMob.
Versión 1.4.0.0
- Se verificó la compatibilidad con la versión 1.4.0 del SDK de Maio.
Versión 1.3.2.0
- Se verificó la compatibilidad con la versión 1.3.2 del SDK de Maio.
Versión 1.3.1.1
- Se agregó la devolución de llamada
adapterDidCompletePlayingRewardBasedVideoAd:
al adaptador.
Versión 1.3.1.0
- Se verificó la compatibilidad con la versión 1.3.1 del SDK de Maio.
Versión 1.3.0.0
- Se verificó la compatibilidad con la versión 1.3.0 del SDK de Maio.
Versión 1.2.19.0
- Se verificó la compatibilidad con la versión 1.2.19 del SDK de Maio.
Versión 1.2.18.0
- Primer lanzamiento
- Se agregó compatibilidad con anuncios intersticiales y de video recompensados.