En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles mostrar anuncios de Mintegral con mediación, abarca las integraciones en cascada y de ofertas. Abarca 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 un Android app.
Integraciones y formatos de anuncios admitidos
El adaptador de mediación de Mintegral tiene las siguientes funciones:
Integración | |
---|---|
Ofertas | 1 |
Cascada | 2 |
Formatos | |
Aplicación abierta | |
Banner | |
Intersticial | |
Recompensado | |
Intersticial recompensado | |
Nativo |
2 La integración de Waterfall está en beta cerrada.
Requisitos
- Nivel de API 21 o versiones posteriores de Android
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 Mintegral
Paso 2: Configura la demanda Mintegral en la Ad Manager IU
Agregar Mintegral a la lista de socios publicitarios del GDPR y las reglamentaciones estatales de EE.UU.
Paso 3: Importa el SDK de Mintegral y el adaptador
Integración de Android Studio (recomendada)
En el archivo settings.gradle.kts
de nivel de proyecto, agrega lo siguiente:
repositorios:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
}
}
}
Luego, en el archivo build.gradle.kts
a nivel de la app, agrega lo siguiente:
las dependencias y configuraciones
de la implementación. Usa las versiones más recientes del
SDK de Mintegral y adaptador:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:mintegral:16.8.31.0")
}
Integración manual
Para incluir el SDK de Mintegral, ve al SDK de Mintegral para Android.
Navega a la Artefactos del adaptador mintegral en el repositorio Maven de Google. Selecciona la versión más reciente y descarga el Mintegral
.aar
de tu adaptador y agrégalo a tu proyecto.
Paso 4: Implementa la configuración de privacidad en el SDK de Mintegral
Consentimiento para la UE y GDPR
Según el Consentimiento de Usuarios de la UE de Google política, debe asegurarse de que se proporcionen ciertas divulgaciones los consentimientos obtenidos de los usuarios del Espacio Económico Europeo (EEE) en relación con y el uso de identificadores de dispositivos y datos personales. Esta política refleja el requisitos de la Directiva de Privacidad Electrónica y de la Protección General de Datos Reglamento General de Protección de Datos (RGPD). Cuando solicite el consentimiento, debe identificar cada red de publicidad de tu cadena de mediación que recopilen, reciban o usen datos personales y proporcionar información sobre el uso de cada red. Por el momento, Google no puede pasar automáticamente la elección de consentimiento del usuario a esas redes.
El SDK de Mintegral incluye el método setConsentStatus
para pasar el consentimiento
información al SDK de Mintegral.
El siguiente código de muestra indica cómo pasar la información de consentimiento al Mintegral de Google Cloud. Debes establecer estas opciones antes de inicializar SDK de anuncios de Google para dispositivos móviles para garantizar que se reenvíen correctamente al SDK de Mintegral.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
Consulta la documentación de privacidad de Mintegral. para obtener más información.
Leyes de privacidad estatales de EE.UU.
EE.UU. leyes de privacidad estatales deben brindar a los usuarios los permisos para inhabilitar la "oferta" de su "información personal" (como lo define la ley condiciones), con la opción de inhabilitación ofrecida por medio de un mensaje destacado "No vender Información" el vínculo en la página la página de inicio del grupo. El EE.UU. privacidad de estados en la guía de cumplimiento de leyes ofrece la posibilidad de habilitar procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada anuncio en tu cadena de mediación. Por lo tanto, debes identificar cada red de publicidad de su cadena de mediación que puedan participar en la venta de información y seguir las indicaciones de cada una de esas redes para garantizar y cumplimiento.
El SDK de Mintegral incluye el método setDoNotTrackStatus
para pasar el consentimiento
información al SDK de Mintegral.
El siguiente código de muestra indica cómo pasar la información de consentimiento al Mintegral de Google Cloud. Si necesitas llamar a este método, llámalo. después de inicialización del SDK de anuncios de Google para dispositivos móviles pero antes de solicitarlos a través del SDK de anuncios de Google para dispositivos móviles.
Java
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
Kotlin
import com.mbridge.msdk.out.MBridgeSDKFactory
// ...
var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)
Consulta la documentación de privacidad de Mintegral. para obtener más información.
Paso 5: Agrega el código requerido
No se requiere ningún código adicional para la integración de Mintegral.
Paso 6: 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.
Pasos opcionales
Agregue Mintegral a la lista de socios publicitarios de la CCPA
Sigue los pasos que se indican en Configuración de la CCPA para agregar Mintegral a la lista de socios publicitarios de la CCPA en el Ad Manager IU.
Anuncios nativos
Renderización de anuncios
El adaptador Mintegral muestra sus anuncios nativos como
NativeAd
objetos. Propaga los siguientes elementos
campos
durante un
NativeAd
.
Campo | Recursos siempre incluidos por el adaptador Mintegral |
---|---|
Título | |
Imagen | 1 |
Cuerpo | |
Ícono | |
Llamado a la acción | |
Calificación por estrellas | |
Tienda | |
Precio | |
Advertiser |
1 El adaptador Mintegral no
proporcionan acceso directo al recurso de imagen principal de sus anuncios nativos. En cambio, el
de forma predeterminada completa
MediaView
con un video o una imagen.
Códigos de error
Si el adaptador no recibe un anuncio de Mintegral, puedes verificar el
subyacente de la respuesta del anuncio mediante
ResponseInfo.getAdapterResponses()
en las siguientes clases:
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
Estos son los códigos y los mensajes adjuntos que arroja el adaptador Mintegral Cuando un anuncio no se carga:
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. |
Registro de cambios del adaptador de mediación de Mintegral para Android
Versión 16.8.31.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.8.31.
Compilado y probado con lo siguiente:
- Versión 23.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.8.31 del SDK de Mintegral.
Versión 16.8.11.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.8.11.
Compilado y probado con lo siguiente:
- Versión 23.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.8.11 del SDK de Mintegral.
Versión 16.7.91.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.91.
Compilado y probado con lo siguiente:
- Versión 23.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.91 del SDK de Mintegral.
Versión 16.7.81.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.81.
Compilado y probado con lo siguiente:
- Versión 23.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.81 del SDK de Mintegral.
Versión 16.7.71.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.71.
Compilado y probado con lo siguiente:
- Versión 23.1.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.71 del SDK de Mintegral.
Versión 16.7.61.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.61.
Compilado y probado con lo siguiente:
- Versión 23.1.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.61 del SDK de Mintegral.
Versión 16.7.51.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.51.
Compilado y probado con lo siguiente:
- Versión 23.1.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.51 del SDK de Mintegral.
Versión 16.7.41.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.41.
Compilado y probado con lo siguiente:
- Versión 23.1.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.41 del SDK de Mintegral.
Versión 16.7.31.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.31.
Compilado y probado con lo siguiente:
- Versión 23.1.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.31 del SDK de Mintegral.
Versión 16.7.21.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.21.
Compilado y probado con lo siguiente:
- Versión 23.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.21 del SDK de Mintegral.
Versión 16.7.11.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.7.11.
Compilado y probado con lo siguiente:
- Versión 23.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.7.11 del SDK de Mintegral.
Versión 16.6.71.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.6.71.
Compilado y probado con lo siguiente:
- Versión 23.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.6.71 del SDK de Mintegral.
Versión 16.6.61.0
- Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 23.0.0.
- Se verificó la compatibilidad con el SDK de Mintegral 16.6.61.
Compilado y probado con lo siguiente:
- Versión 23.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.6.61 del SDK de Mintegral.
Versión 16.6.51.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.6.51.
Compilado y probado con lo siguiente:
- Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.6.51 del SDK de Mintegral.
Versión 16.6.41.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.6.41.
Compilado y probado con lo siguiente:
- Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.6.41 del SDK de Mintegral.
Versión 16.6.34.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.6.34.
Compilado y probado con lo siguiente:
- Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.6.34 del SDK de Mintegral.
Versión 16.6.21.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.6.21.
Compilado y probado con lo siguiente:
- Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.6.21 del SDK de Mintegral.
Versión 16.5.91.1
- Se agregó compatibilidad con licitación para el formato de anuncio de aplicación abierta.
Compilado y probado con lo siguiente:
- Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.5.91 del SDK de Mintegral.
Versión 16.5.91.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.5.91.
- Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 22.6.0.
Compilado y probado con lo siguiente:
- Versión 22.6.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.5.91 del SDK de Mintegral.
Versión 16.5.51.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.5.51.
Compilado y probado con lo siguiente:
- Versión 22.3.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.5.51 del SDK de Mintegral.
Versión 16.5.41.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.5.41.
Compilado y probado con lo siguiente:
- Versión 22.3.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.5.41 del SDK de Mintegral.
Versión 16.5.31.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.5.31.
- Se revirtió el adaptador para que dependiera de la versión 22.3.0 del SDK de anuncios de Google para dispositivos móviles.
- Se agregó compatibilidad con cascada para el formato de anuncio de aplicación abierta.
Compilado y probado con lo siguiente:
- Versión 22.3.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.5.31 del SDK de Mintegral.
Versión 16.5.21.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.5.21.
- Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 22.4.0.
Compilado y probado con lo siguiente:
- Versión 22.4.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.5.21 del SDK de Mintegral.
Versión 16.5.11.0
- Se agregó compatibilidad con marcas de agua para anuncios de licitación.
- Se verificó la compatibilidad con el SDK de Mintegral 16.5.11.
Compilado y probado con lo siguiente:
- Versión 22.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.5.11 del SDK de Mintegral.
Versión 16.4.91.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.4.91.
Compilado y probado con lo siguiente:
- Versión 22.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.4.91 del SDK de Mintegral.
Versión 16.4.81.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.4.81.
Compilado y probado con lo siguiente:
- Versión 22.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.4.81 del SDK de Mintegral.
Versión 16.4.71.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.4.71.
Compilado y probado con lo siguiente:
- Versión 22.2.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.4.71 del SDK de Mintegral.
Versión 16.4.61.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.4.61.
Compilado y probado con lo siguiente:
- Versión 22.1.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.4.61 del SDK de Mintegral.
Versión 16.4.51.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.4.51.
Compilado y probado con lo siguiente:
- Versión 22.1.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.4.51 del SDK de Mintegral.
Versión 16.4.41.0
- Se solucionó un problema por el que los anuncios de banner se renderizaban con tamaños incorrectos.
- Se verificó la compatibilidad con el SDK de Mintegral 16.4.41.
Compilado y probado con lo siguiente:
- Versión 22.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.4.41 del SDK de Mintegral.
Versión 16.4.31.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.4.31.
Compilado y probado con lo siguiente:
- Versión 22.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.4.31 del SDK de Mintegral.
Versión 16.4.21.0
- Se actualizó el adaptador para usar la nueva clase
VersionInfo
. - Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 22.0.0.
- Se verificó la compatibilidad con el SDK de Mintegral 16.4.21.
Compilado y probado con lo siguiente:
- Versión 22.0.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.4.21 del SDK de Mintegral.
Versión 16.3.91.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.3.91.
Compilado y probado con lo siguiente:
- Versión 21.5.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.3.91 del SDK de Mintegral.
Versión 16.3.81.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.3.81.
Compilado y probado con lo siguiente:
- Versión 21.5.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.3.81 del SDK de Mintegral.
Versión 16.3.71.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.3.71.
Compilado y probado con lo siguiente:
- Versión 21.5.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.3.71 del SDK de Mintegral.
Versión 16.3.61.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.3.61.
Compilado y probado con lo siguiente:
- Versión 21.5.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.3.61 del SDK de Mintegral.
Versión 16.3.51.1
- Se agregó compatibilidad con cascada para formatos de banner (incluye MREC), intersticiales, recompensados y nativos.
- Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 21.5.0.
Compilado y probado con lo siguiente:
- Versión 21.5.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.3.51 del SDK de Mintegral.
Versión 16.3.51.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.3.51.
Compilado y probado con lo siguiente:
- Versión 21.4.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.3.51 del SDK de Mintegral.
Versión 16.3.41.0
- Se verificó la compatibilidad con el SDK de Mintegral 16.3.41.
- Se actualizó la versión mínima requerida del SDK de anuncios de Google para dispositivos móviles a la 21.4.0.
Compilado y probado con lo siguiente:
- Versión 21.4.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.3.41 del SDK de Mintegral.
Versión 16.3.11.0
- Compatibilidad verificada con el SDK de Mintegral 16.3.11
- Se actualizó el adaptador para reenviar
onUserEarnedReward()
antes delonAdClosed()
cuando se muestren anuncios recompensados.
Compilado y probado con lo siguiente:
- Versión 21.3.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.3.11 del SDK de Mintegral.
Versión 16.2.61.0
- Versión inicial
- Se agregó compatibilidad con ofertas para formatos de banner (incluye MREC), anuncios intersticiales, recompensados y nativos.
Compilado y probado con lo siguiente:
- Versión 21.3.0 del SDK de anuncios de Google para dispositivos móviles
- Versión 16.2.61 del SDK de Mintegral.