Integre maio con Mediación

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

  • 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 de MaioAdapter.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.