En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles a fin de cargar y mostrar anuncios de Maio mediante la mediación, que abarca las integraciones en cascada. Abarca 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 maio en una appiOS .
La interfaz del panel de maio usa texto en japonés para las etiquetas, los botones y las 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 Đキー carrera" es un "esquema de URL", y así sucesivamente.
Integraciones y formatos de anuncios admitidos
El adaptador de mediación Ad Manager para maio tiene las siguientes capacidades:
Integración | |
---|---|
Ofertas | |
Cascada | |
Formatos | |
Banner | |
Intersticial | |
Recompensado | |
Nativo |
Requisitos
- Objetivo de implementación para iOS 12.0 o versiones posteriores
Versión más reciente del SDK de anuncios de Google para dispositivos móviles
Completa la guía de introducción de la mediación.
Paso 1: Establece parámetros de configuración en la IU de Maio
Primero, regístrate o accede a tu cuenta principal. Haz clic en el botón Application management en la barra lateral izquierda y, luego, en New 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 tu app. Selecciona 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 tu app. Selecciona Recompensas de video 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 que configures tu Ad Manager unidad de anuncios en la siguiente sección.
En la página Administración de zonas, toma nota del ID de zona. También la necesitarás para configurar tu Ad Manager unidad de anuncios en la siguiente sección.
(Solo Waterfall) Además de Media ID y Zone ID, 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 API de Reporting, toma nota del ID de API y de la CLAVE DE API.Paso 2: Configura la mayor demanda en la Ad Manager IU
Accede a tu cuenta de Ad Manager.
Agregar maio en Empresas
Ofertas
Este paso no es obligatorio para las integraciones de ofertas.
Cascada
Navega a Administrador > Empresas y, luego, haz clic en el botón Nueva empresa en la pestaña Todas las empresas. Selecciona Red de publicidad.
Selecciona maio como la Red de publicidad, ingresa un Nombre único y habilita la Mediación. Activa Recopilación de datos automática y, luego, ingresa el API ID and API KEY que obtuviste en la sección anterior.
No es necesario que ingreses un nombre de usuario ni una contraseña. Haz clic en Save cuando termines.
Habilitar el uso compartido de indicadores seguros
Ofertas
Navega a Administrador > Configuración global. Ve a la pestaña Configuración de la cuenta de Ad Exchange, revisa y activa Uso compartido de indicadores seguros. Haz clic en Guardar.
Cascada
Este paso no es obligatorio para las integraciones en cascada.
Configura las maio ofertas
Ofertas
Navega a Publicación > Ofertantes y haz clic en Nuevo ofertante en la pestaña Ofertas de SDK.
Selecciona maio como ofertante.
Activa Agregar la biblioteca de indicadores de este ofertante a la lista de indicadores permitidos y Permitir que se compartan indicadores con este ofertante. Luego, haz clic en Continuar.
Haz clic en Continuar.
Haz clic en Listo.
Cascada
Este paso no es obligatorio para las integraciones en cascada.
Configura la asignación de unidades de anuncios
Ofertas
Navega a Publicación > Ofertantes y selecciona la empresa demaio en la pestaña Ofertas de SDK.
Ve a la pestaña Asignación de unidades de anuncios y haz clic en Nueva asignación de unidades de anuncios.
Elige Unidad de anuncios específica. Selecciona una unidad de anuncios y un formato, Aplicación para dispositivos móviles como el Tipo de inventario y tu Aplicación para dispositivos móviles. Luego, ingresa losPublisher ID obtenidos en la sección anterior. Por último, haz clic en Guardar.
Cascada
Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento. Selecciona tu Aplicación para dispositivos móviles.
Desplázate hacia abajo y haz clic en Agregar socio de rendimiento.
Selecciona la empresa para la que creaste maio en la sección anterior. Elige Mediación del SDK para dispositivos móviles como el Tipo de integración, iOS como la Plataforma y Activo como el Estado.
Ingresa el Media ID and Zone ID obtenido en la sección anterior y el valor de CPM predeterminado. Haz clic en Guardar.
Nota: La recopilación automática de datos tarda algunos días en recopilar datos antes de poder calcular con precisión un valor de CPM dinámico para una red de mediación. Una vez que se puede calcular el eCPM, se actualiza automáticamente por ti.
Paso 3: Importa el SDK y el adaptador de maio
Usa 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 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
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 (Bidding) and 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 mediante
GADResponseInfo.adNetworkInfoArray
en las siguientes clases:
Formato | Nombre de clase |
---|---|
Intersticial | GADMMaioInterstitialAdapter |
Recompensado | GADMMaioRewardedAdapter |
A continuación, se indican los códigos y los mensajes que arroja el adaptador maio cuando un anuncio no se carga:
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 | Los parámetros del servidor no son válidos (p.ej., falta el ID de posición). |
103 | El contexto que se usó para cargar un anuncio no fue una instancia de "Activity". |
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 | Los parámetros del servidor no son válidos (p.ej., falta el ID de posición). |
103 | El adaptador maio no es compatible con 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 iOS de maio
Versión 2.1.3.0
- Se verificó la compatibilidad con la versión 2.1.3 del SDK de Maio.
Compilado y probado con lo siguiente:
- Versión 11.1.0 del SDK de anuncios de Google para dispositivos móviles.
- Maio SDK versión 2.1.3.
Versión 2.1.2.1
- Ahora se 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
.
Compilado y probado con lo siguiente:
- Versión 11.0.1 del SDK de anuncios de Google para dispositivos móviles.
- Maio SDK versión 2.1.2.
Versión 2.1.2.0
- Se verificó la compatibilidad con la versión 2.1.2 del SDK de Maio.
Compilado y probado con lo siguiente:
- Versión 10.14.0 del SDK de anuncios de Google para dispositivos móviles.
- Maio SDK versión 2.1.2.
Versión 2.1.1.0
- Se verificó la compatibilidad con la versión 2.1.1 del SDK de Maio.
Compilado y probado con lo siguiente:
- Versión 10.12.0 del SDK de anuncios de Google para dispositivos móviles.
- Maio SDK versión 2.1.1.
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, como mínimo, la versión 12.0 de iOS.
- Ahora se requiere la versión 10.4.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado con lo siguiente:
- Versión 10.10.0 del SDK de anuncios de Google para dispositivos móviles.
- Maio SDK versión 2.0.0.
Versión 1.6.3.1
- Ahora se requiere la versión 10.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado 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.
- MaioOB SDK versión 2.0.0-alpha.
Versión 1.6.3.0
- Se actualizó el adaptador para usar la API de
didRewardUser
. - Ahora se 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.
Compilado y probado 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.
- MaioOB SDK versión 2.0.0-alpha.
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.
Compilado y probado con lo siguiente:
- Versión 9.5.0 del SDK de anuncios de Google para dispositivos móviles.
- Versión 1.6.2 del SDK de Maio.
- MaioOB SDK versión 2.0.0-alpha.
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.
Compilado y probado 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.
- MaioOB SDK versión 2.0.0-alpha.
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 se requiere la versión 9.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado con lo siguiente:
- Versión 9.0.0 del SDK de anuncios de Google para dispositivos móviles.
- Maio SDK versión 1.6.0.
- MaioOB SDK versión 2.0.0-alpha.
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.
Compilado y probado 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.
- Maio SDK versión 1.6.0.
- MaioOB SDK versión 2.0.0-alpha.
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ó una función de ofertas al adaptador para formatos de anuncios intersticiales y recompensados.
- Dependencia relajada del SDK de anuncios de Google para dispositivos móviles versión 8.0.0 o posterior.
Compilado y probado 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.
- MaioOB SDK versión 2.0.0-alpha.
Versión 1.5.6.1
- Se agregaron mensajes y códigos de error estandarizados del adaptador.
- Se actualizó el adaptador para usar el formato
.xcframework
. - Se corrigió un error por el que, en ocasiones, no se reenviaban los eventos de anuncios recompensados.
- Ahora se requiere la versión 8.3.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado con lo siguiente:
- Versión 8.3.0 del SDK de anuncios de Google para dispositivos móviles.
- Maio SDK versión 1.5.6.
Versión 1.5.6.0
- Se verificó la compatibilidad con la versión 1.5.6 del SDK de Maio.
- Ahora se requiere la versión 7.68.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado con lo siguiente:
- Versión 7.68.0 del SDK de anuncios de Google para dispositivos móviles.
- Maio SDK versión 1.5.6.
Versión 1.5.5.0
- Se verificó la compatibilidad con la versión 1.5.5 del SDK de Maio.
- Ahora se requiere la versión 7.64.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado 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 se requiere la versión 7.60.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
Compilado y probado 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 fallarán de inmediato si maio no tiene un anuncio listo para mostrar.
- Se quitó la compatibilidad con la arquitectura i386.
Compilado y probado 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.
Compilado y probado 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 solucionó un problema por el que el adaptador no invocaba la devolución de llamada
-rewardedAdDidPresent:
Compilado y probado 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.
Compilado y probado 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.
Compilado y probado 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.
Compilado y probado 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 se 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 en el que el adaptador maio podía fallar si se proporcionaban varios MediaIds de 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
- Primera versión
- Se agregó compatibilidad con anuncios intersticiales y de videos recompensados.