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 mediación, que abarcan integraciones en cascada. Aquí se explica cómo agregar Maio a la API de una unidad de anuncios configuración de mediación y cómo integrar el SDK de Maio y el adaptador a una iOS app.
La interfaz del panel de maio usa texto en japonés para las etiquetas, los botones y descripciones, y las capturas de pantalla de esta guía no se tradujeron. Sin embargo, en las descripciones e instrucciones de esta guía, las etiquetas y los botones a las que se hace referencia con sus equivalentes en inglés. "URL 炭ー," por ejemplo, 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 superior
SDK de anuncios de Google para dispositivos móviles más reciente
Cómo completar la mediación Guía de introducción
Paso 1: Establece la configuración en la IU de Maio
First, sign up or log in to your maio account. Click the Application management button on the left sidebar and click on New app.
Select the tab corresponding to your preferred Ad Type.
Interstitial
Enter the Name of your app, select the platform and provide your App URL. Select Video interstitial as the Ad Type, and then click Update.
Rewarded
Enter the Name of your app, select the platform and provide your App URL. Select Video Rewards as the Ad Type, and then click Update.
In the Application Management page, make a note of the Media ID. It's needed to set up your Ad Manager ad unit in the next section.
In the Zone Management page, make a note of the Zone ID. It will also be needed to set up your Ad Manager ad unit in the next section.
Paso 2: Configura la demanda de CPA en la Ad Manager IU
Cómo configurar la mediación para tu unidad de anuncios
Accede a tu cuenta de Ad Manager.
Navega a Publicación > Grupos de rendimiento y haz clic en el botón Nuevo grupo de rendimiento.
Ingresa un Nombre único para tu grupo de rendimiento, establece el Estado en Activo, selecciona el Formato del anuncio y establece el Tipo de inventario en Aplicación para dispositivos móviles. En la sección Segmentación > Inventario, selecciona la unidad de anuncios en Inventario y Aplicación para dispositivos móviles a la que deseas agregar la mediación.
Luego, haz clic en el botón Agregar socio de rendimiento.
Si ya tienes un socio de rendimiento paramaio, puedes seleccionarlo. De lo contrario, selecciona Crear un socio de rendimiento nuevo.
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 obtenido en la sección anterior.
Una vez que hayas seleccionado el Socio de rendimiento, 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 elMedia ID and Zone ID obtenido en la sección anterior. Luego, ingresa un valor de CPM predeterminado.
Haz clic en Guardar en la parte inferior de la página cuando termines.
Paso 3: Importa el SDK y el adaptador de maio
Usando 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
Registro de cambios,
y vincula
maioAdapter.framework
en tu proyecto.
Paso 4: Agrega el código requerido
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
GADResponseInfo.adNetworkInfoArray
en las siguientes clases:
Formato | Nombre de clase |
---|---|
Intersticial | GADMMaioInterstitialAdapter |
Recompensado | GADMMaioRewardedAdapter |
A continuación, se muestran los códigos y los mensajes adjuntos que arroja el adaptador maio cuando no se puede cargar un anuncio:
Código de error | Motivo |
---|---|
0-10 | maio mostró un error específico del SDK. Consulta código de maio para obtener más información. |
101 | María 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 adaptador de mediación de iOS de maio
Versión 2.1.5.0
- Se verificó la compatibilidad con la versión 2.1.5 del SDK de maio.
Compilado y probado 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.
Compilado y probado 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.
Compilado y probado 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
.
Compilado y probado 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.
Compilado y probado 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.
Compilado y probado 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 se requiere una versión mínima de iOS 12.0.
- Ahora se requiere la versión 10.4.0 o una 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
- Versión 2.0.0 del SDK de Maio.
Versión 1.6.3.1
- Ahora se requiere la versión 10.0.0 o una 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.
- 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 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 con la versión 2.0.0-alpha 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.
- 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 con la versión 2.0.0-alpha 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.
- 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 con la versión 2.0.0-alpha 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.
- 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 se requiere la versión 9.0.0 o una 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
- 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 con la versión 2.0.0-alpha 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 una versión mínima de iOS de 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 con la versión 2.0.0-alpha de maioOB.
- Se agregó la función de ofertas al adaptador para formatos de anuncios intersticiales y recompensados.
- Se relajó la dependencia a la versión 8.0.0 o posterior del SDK de anuncios de Google para dispositivos móviles.
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.
- Versión 2.0.0-alpha del SDK de MaioOB
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 a veces no se reenvíaban 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
- 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 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
- 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 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 inmediatamente si maio no tiene un anuncio listo para mostrarse.
- 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 corrigió 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 con recompensas.
- 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 por el que el adaptador 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ó una 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 video recompensados.