Integre Mintegral con la licitación (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 iOS 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

  • Objetivo de implementación de iOS 11.0 o superior
  • 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

Sign up or Log in to your Mintegral account.

Locate the App Key

Navigate to the APP Setting tab and take note of the APP Key.

Add a new application

From the APP Setting tab, click the Add APP button.

Select the Platform and fill out the rest of the form. Then, click Save.

Take note of your application's APP ID.

Create an ad placement

Once your application has been created, navigate to the Placements & Units tab and click on the Add Placement button as shown below to create your ad placement.

Enter a Placement Name and AD Format.

Select Header Bidding as the Bidding Type. Fill out the rest of the form and click Save.

Once your ad placement is created, take note of the Placement ID.

Click the 1 AD Units drop down and take note of the AD Unit ID.

Locate your Mintegral Reporting API Key

Bidding

This step isn't required for bidding integrations.

Waterfall

You will need your Mintegral Reporting API Key for setting up your Ad Manager ad unit ID. Navigate to Account > API Tools. Take note of your Skey and 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, iOS 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

  • Agrega la siguiente línea al Podfile de tu proyecto:

    pod 'GoogleMobileAdsMediationMintegral'
    
  • 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 Mintegral para iOS y vincular todos los archivos y paquetes .framework de tu proyecto.
  • Descarga la última versión del adaptador Mintegral desde el vínculo de descarga en el registro de cambios y vincula MintegralAdapter.xcframework en 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 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.

Swift

import MTGSDK
// ...

MTGSDK.sharedInstance().setConsentStatus(true)

Objective-C

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setConsentStatus:YES];

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. antes de inicialización del SDK de anuncios de Google para dispositivos móviles para garantizar que se reenvíen correctamente al SDK de Mintegral.

Swift

import MTGSDK
// ...

MTGSDK.sharedInstance().setDoNotTrackStatus(false)

Objective-C

#import <MTGSDK/MTGSDK.h>
// ...

[[MTGSDK sharedInstance] setDoNotTrackStatus:NO];

Consulta la documentación de Privacidad de Mintegral. para obtener más información.

Paso 5: Agrega el código requerido

Integración de SKAdNetwork

Sigue la documentación de Mintegral para agregar los identificadores de SKAdNetwork al archivo Info.plist de tu proyecto.

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 GADNativeAd objetos. Completa la siguiente campos durante un GADNativeAd

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 un adaptador propaga la GADMediaView 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 GADResponseInfo.adNetworkInfoArray en las siguientes clases:

GADMediationAdapterMintegral

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.

Registro de cambios del adaptador de mediación de Mintegral para iOS

Versión 7.6.8.0

  • Se verificó la compatibilidad con la versión 7.6.8 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.7.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.6.8 del SDK de Mintegral.

Versión 7.6.7.0

  • Se verificó la compatibilidad con la versión 7.6.7 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.6.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.6.7 del SDK de Mintegral.

Versión 7.6.6.0

  • Se verificó la compatibilidad con la versión 7.6.6 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.5.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.6.6 del SDK de Mintegral.

Versión 7.6.4.0

  • Se verificó la compatibilidad con la versión 7.6.4 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.4.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.6.4 del SDK de Mintegral.

Versión 7.6.3.0

  • Se verificó la compatibilidad con la versión 7.6.3 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.3.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.6.3 del SDK de Mintegral.

Versión 7.6.2.0

  • Se verificó la compatibilidad con la versión 7.6.2 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.3.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.6.2 del SDK de Mintegral.

Versión 7.6.1.0

  • Se verificó la compatibilidad con la versión 7.6.1 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.3.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.6.1 del SDK de Mintegral.

Versión 7.6.0.0

  • Se verificó la compatibilidad con la versión 7.6.0 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.6.0 del SDK de Mintegral.

Versión 7.5.9.0

  • Se verificó la compatibilidad con la versión 7.5.9 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.5.9 del SDK de Mintegral.

Versión 7.5.8.0

  • Se verificó la compatibilidad con la versión 7.5.8 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 11.1.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.5.8 del SDK de Mintegral.

Versión 7.5.7.0

  • Se verificó la compatibilidad con la versión 7.5.7 del SDK de Mintegral.
  • Ahora se requiere una versión mínima de iOS 12.0.
  • Ahora 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 MintegralAdapter.xcframework.

Compilado y probado con lo siguiente:

  • Versión 11.0.1 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.5.7 del SDK de Mintegral.

Versión 7.5.6.0

  • Se verificó la compatibilidad con la versión 7.5.6 del SDK de Mintegral.
  • Se convirtió GADMediationAdapterMintegral.h en un encabezado público.

Compilado y probado con lo siguiente:

  • Versión 11.0.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.5.6 del SDK de Mintegral.

Versión 7.5.3.0

  • Se verificó la compatibilidad con la versión 7.5.3 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.5.3 del SDK de Mintegral.

Versión 7.4.8.0

  • Se verificó la compatibilidad con la versión 7.4.8 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.13.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.4.8 del SDK de Mintegral.

Versión 7.4.7.0

  • Se actualizó el archivo podspec para que dependa de MintegralAdSDK/All en lugar de MintegralAdSDK.
  • Se verificó la compatibilidad con la versión 7.4.7 del SDK de Mintegral.
  • Se agregó compatibilidad con cascada para el formato de anuncio de aplicación abierta.

Compilado y probado con lo siguiente:

  • Versión 10.12.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.4.7 del SDK de Mintegral.

Versión 7.4.4.0

  • Se agregó compatibilidad con marcas de agua para anuncios de licitación.
  • Se verificó la compatibilidad con la versión 7.4.4 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.10.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.4.4 del SDK de Mintegral.

Versión 7.4.3.0

  • Se verificó la compatibilidad con la versión 7.4.3 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.9.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.4.3 del SDK de Mintegral.

Versión 7.4.1.0

  • Se verificó la compatibilidad con la versión 7.4.1 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.7.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.4.1 del SDK de Mintegral.

Versión 7.3.9.0

  • Se verificó la compatibilidad con la versión 7.3.9 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.7.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.3.9 del SDK de Mintegral.

Versión 7.3.8.0

  • Se verificó la compatibilidad con la versión 7.3.8 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.6.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.3.8 del SDK de Mintegral.

Versión 7.3.7.0

  • Se verificó la compatibilidad con la versión 7.3.7 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.5.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.3.7 del SDK de Mintegral.

Versión 7.3.6.0

  • Se verificó la compatibilidad con la versión 7.3.6 del SDK de Mintegral.
  • Se quitó la compatibilidad con la arquitectura armv7.
  • Ahora se requiere una versión mínima de iOS 11.0.
  • Ahora se requiere la versión 10.4.0 o una posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con lo siguiente:

  • Versión 10.5.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.3.6 del SDK de Mintegral.

Versión 7.3.4.0

  • Se verificó la compatibilidad con la versión 7.3.4 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.3.4 del SDK de Mintegral.

Versión 7.3.3.0

  • Se verificó la compatibilidad con la versión 7.3.3 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.2.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.3.3 del SDK de Mintegral.

Versión 7.3.0.0

  • Se verificó la compatibilidad con la versión 7.3.0 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 10.1.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.3.0 del SDK de Mintegral.

Versión 7.2.9.1

  • Se agregó compatibilidad con cascada para formatos de banner (incluye MREC), intersticiales, recompensados y nativos.
  • 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 7.2.9 del SDK de Mintegral.

Versión 7.2.9.0

  • Se verificó la compatibilidad con la versión 7.2.9 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 9.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.2.9 del SDK de Mintegral.

Versión 7.2.8.0

  • Se verificó la compatibilidad con la versión 7.2.8 del SDK de Mintegral.

Compilado y probado con lo siguiente:

  • Versión 9.14.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.2.8 del SDK de Mintegral.

Versión 7.2.6.0

  • Versión inicial
  • Se agregó compatibilidad con ofertas para formatos de banner (incluye MREC), anuncios intersticiales, recompensados y nativos.
  • Se verificó la compatibilidad con la versión 7.2.6 del SDK de Mintegral.
  • Se requiere la versión 9.8.0 o posterior del SDK de anuncios de Google para dispositivos móviles.

Compilado y probado con lo siguiente:

  • Versión 9.13.0 del SDK de anuncios de Google para dispositivos móviles
  • Versión 7.2.6 del SDK de Mintegral.