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 Mintegral mediante la mediación, que abarca las integraciones de cascada y ofertas. Se explica cómo agregar Mintegral a la configuración de mediación de una unidad de anuncios y cómo integrar el SDK y el adaptador de Mintegral a una app de Flutter .
Integraciones y formatos de anuncios admitidos
El adaptador de mediación Ad Manager para Mintegral tiene las siguientes capacidades:
| Integración | ||
|---|---|---|
| Ofertas | 1 | |
| Cascada | 2 | |
| Formatos | ||
| Aplicación abierta | 1 2 | |
| Banner | ||
| Intersticial | ||
| Recompensado | ||
| Intersticial recompensado | ||
| Nativo | ||
2 La integración con Waterfall se encuentra en versión beta cerrada.
Requisitos
- Versión más reciente del SDK de anuncios de Google para dispositivos móviles
- Flutter 3.7.0 o versiones posteriores
- Para implementar en Android, haz lo siguiente:
- Nivel de API 21 o versiones posteriores de Android
- Sigue estos pasos para implementar en iOS:
- Objetivo de implementación de iOS 12.0 o superior
- Un proyecto en funcionamiento Flutter 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 sobre la mediación.
Paso 1: Establece la configuración en la IU de Mintegral
Regístrate o accede a tu cuenta de Mintegral.
Ubica la clave de la app
Ve a la pestaña Configuración de la app y toma nota de la clave de la app.
Agregar una aplicación nueva
En la pestaña Configuración de la app, haz clic en el botón Agregar app.
Selecciona la Plataforma y completa el resto del formulario. Luego, haz clic en Guardar.
Android
iOS
Anota el ID de la app de tu aplicación.
Android
iOS
Cómo crear una posición de anuncios
Una vez que se haya creado tu aplicación, navega a la pestaña Posiciones y unidades y haz clic en el botón Agregar posición, como se muestra a continuación para crear la posición de tu anuncio.
Android
iOS
Ingrese un Nombre de la posición y un Formato del anuncio.
Selecciona Oferta de encabezado como el Tipo de oferta. Completa el resto del formulario y haz clic en Guardar.
Una vez creada la colocación de anuncios, toma nota del ID de posición.
Android
iOS
Haz clic en el menú desplegable 1 unidad de anuncios y anota el ID de la unidad de anuncios.
Android
iOS
Localiza tu clave de API de Mintegral Reporting
Ofertas
Este paso no es obligatorio para las integraciones de ofertas.
Cascada
Necesitarás tu clave de API de Mintegral Reporting para configurar el ID de tu unidad de anuncios deAd Manager . Navega a Cuenta > Herramientas de API. Toma nota del Skey y el Secret.
Paso 2: Configura la demanda Mintegral 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.
Agregar Mintegral a la lista de socios publicitarios del GDPR y las reglamentaciones estatales de EE.UU.
Sigue los pasos que se indican en Configuración del GDPR y Configuración de las reglamentaciones estatales de EE.UU. para agregar Mintegral a la lista de socios publicitarios de las reglamentaciones estatales de EE.UU. y el GDPR en la Ad Manager IU.
Paso 3: Importa el SDK de Mintegral y el adaptador
Integración a través de pub.dev
Agrega la siguiente dependencia con las versiones más recientes del SDK y el adaptadorMintegral en el archivo pubspec.yaml de tu paquete:
dependencies:
gma_mediation_mintegral: ^1.0.0
Integración manual
Descarga la versión más reciente del complemento de mediación de Google Mobile Ads para Mintegral, extrae el archivo descargado y agrega la carpeta del complemento extraída (y su contenido) a tu proyecto de Flutter. Luego, agrega la siguiente dependencia para hacer referencia al complemento en tu archivo pubspec.yaml:
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
Paso 4: Agrega el código requerido
Android
No se requiere ningún código adicional para la integración de Mintegral.
iOS
Integración de SKAdNetwork
Sigue la documentación de Mintegral 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.
Para obtener anuncios de prueba de Mintegral para banners, anuncios intersticiales y formatos de anuncios recompensados y nativos, Mintegral recomienda usar las claves de app, los IDs de app, los IDs de posición y los IDs de unidades de anuncios que se proporcionan en la Página de ID de prueba de Mintegral.
Cómo verificar los anuncios de prueba
Para verificar que recibes anuncios de prueba deMintegral, habilita las pruebas de fuentes de anuncios individuales en el inspector de anuncios mediante la Mintegral (Bidding) and Mintegral (Waterfall) fuente de anuncios.
Códigos de error
Si el adaptador no recibe un anuncio de Mintegral, los editores pueden verificar el error subyacente de la respuesta del anuncio con ResponseInfo en las siguientes clases:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Estos son los códigos y los mensajes adjuntos que arroja el adaptador Mintegral cuando un anuncio no se carga:
Android
| Código de error | Dominio | Motivo |
|---|---|---|
| 101 | com.google.ads.mediation.mintegral | Parámetros de servidor no válidos (p.ej., falta el ID de la aplicación o el ID de posición). |
| 102 | com.google.ads.mediation.mintegral | El tamaño de anuncio solicitado no coincide con un tamaño de banner admitido por el nivel Mintegral. |
| 103 | com.google.ads.mediation.mintegral | Falta la respuesta de oferta o no es válida. |
| 104 | com.google.ads.mediation.mintegral | El SDK de Mintegral mostró un error de falta de relleno. |
iOS
| Código de error | Dominio | Motivo |
|---|---|---|
| 101 | com.google.mediation.mintegral | Parámetros de servidor no válidos (p.ej., falta el ID de la aplicación o el ID de posición). |
| 102 | com.google.mediation.mintegral | El SDK de Mintegral mostró un error de falta de relleno. |
| 103 | com.google.mediation.mintegral | El SDK de Mintegral no pudo mostrar un anuncio. |
| 104 | com.google.mediation.mintegral | El tamaño de anuncio solicitado no coincide con un tamaño de banner admitido por el nivel Mintegral. |
Registro de cambios del adaptador de mediación de Flutter de Mintegral
1.0.0
- Versión inicial
- Se verificó la compatibilidad con la versión 16.7.21.0 del adaptador Mintegral para Android.
- Se verificó la compatibilidad con la versión 7.6.3.0 del adaptador Mintegral para iOS.
- Se compiló y probó con la versión 5.1.0 del complemento de Flutter de los anuncios de Google para dispositivos móviles.