Integrar Mintegral con ofertas (beta)

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
1 La integración de ofertas está disponible beta cerrada (excepto para el formato del anuncio nativo en versión beta abierta)

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.

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

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

  1. Para incluir el SDK de Mintegral, ve al SDK de Mintegral para Android.

  2. 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

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 del onAdClosed() 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.