Se usó la API de Cloud Translation para traducir esta página.

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 de Mintegral y el adaptador a una Android app.

Integraciones y formatos de anuncios admitidos

El adaptador de mediación de Mintegral tiene las siguientes funciones:

Integración
Ofertas		¹
Cascada		²
Formatos
Aplicación abierta	¹ ²
Banner
Intersticial
Recompensado
Intersticial recompensado
Nativo	¹ ³

¹ Se cerró la integración de ofertas versión beta.

² 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

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.

Anota el ID de la app de tu aplicación.

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.

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.

Haz clic en el menú desplegable 1 unidad de anuncios y anota el ID de la unidad de anuncios.

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

Accede a tu cuenta de Ad Manager.

Agregar Mintegral 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 Mintegral como la Red de publicidad, ingresa un Nombre único y habilita la Mediación.

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 Mintegral ofertas

Ofertas

Navega a Publicación > Ofertantes y haz clic en Nuevo ofertante en la pestaña Ofertas de SDK.

Selecciona Mintegral 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 deMintegral 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 losApp Key, App ID, Placement ID, and Ad Unit 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 Mintegral en la sección anterior. Elige Mediación del SDK para dispositivos móviles como el Tipo de integración, Android como la Plataforma y Activo como el Estado.

Ingresa el App Key, App ID, Placement ID, and Ad Unit ID obtenido en la sección anterior y el valor de CPM predeterminado. Haz clic en Guardar.

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 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.2.0")
    implementation("com.google.ads.mediation:mintegral:16.7.81.0")
}

Integración manual

Para incluir el SDK de Mintegral, ve al SDK de Mintegral para Android.
Ve a la sección 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 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

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