Cómo integrar Vungle con la mediación

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta guía, se muestra cómo usar el SDK de anuncios de Google para dispositivos móviles a fin de cargar y mostrar anuncios de Vungle mediante mediación, que abarcan las integraciones de ofertas y cascadas. También se explica cómo agregar Vungle a la configuración de mediación de un bloque de anuncios y cómo integrar el SDK y el adaptador de Vungle en una app de Unity.

Integraciones admitidas y formatos de anuncios

Integración
Ofertas 1
Cascada
Formatos
Banner 2
Intersticial
Recompensado

1 La integración con ofertas está disponible en versión beta.

Los anuncios de banner solo son compatibles con la mediación en cascada. Actualmente, las ofertas no son compatibles con los anuncios de banner.

Requisitos

  • Unity 4 o una versión posterior
  • SDK de anuncios de Google para dispositivos móviles más recientes [para ofertas]: Complemento de mediación de anuncios de Google para dispositivos móviles para Vungle 3.8.2 o versiones posteriores (se recomienda la versión más reciente)
  • Para implementar en Android:
    • Nivel 21 de la API de Android o superior
  • Para implementar en iOS, haz lo siguiente
    • Objetivo de implementación para iOS 10.0 o versiones posteriores
    • [Para ofertas]: Adaptador Vungle 6.11.0.1 o superior (se recomienda la versión más reciente)
  • Un proyecto de Unity que funcione y tenga configurado el SDK de Google Mobile Ads. Consulta Comenzar para obtener más detalles.

Limitaciones

  • Vungle no admite la carga de varios anuncios con el mismo ID de referencia de posición.
    • El adaptador Vungle falla correctamente la segunda solicitud si otra solicitud de esa ubicación se está cargando o esperando para mostrarse.
  • Vungle solo admite cargar 1 anuncio de banner a la vez.
    • El adaptador Vungle rechaza correctamente las solicitudes de banners posteriores si ya se cargó un anuncio de banner.

Paso 1: Configura Vungle

Regístrate o accede a tu cuenta de Vungle.

Para agregar tu app al panel Aplicaciones de Vungle, haz clic en el botón Agregar aplicación.

Completa el formulario e ingresa todos los detalles necesarios.

Android

iOS

Una vez que se haya creado la app, selecciónala en el panel Aplicaciones de Vungle.

Android

iOS

Anota el ID de app.

Android

iOS

Agregar nuevas ubicaciones

Para crear una posición nueva que se use con la Mediación de AdMob, navega al panel de ubicaciones de Vungle, haz clic en el botón Agregar ubicación y selecciona tu app en la lista desplegable.

A continuación, se incluyen los detalles para agregar ubicaciones nuevas:

Selecciona Banner, ingresa el Nombre de la posición que desees y completa el resto del formulario. [Solo en cascada] Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Banner de 300 x 250

Selecciona MREC, ingresa el Nombre de la posición que desees y completa el resto del formulario. [Solo en cascada] Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Intersticial

Selecciona Intersticial, ingresa el Nombre de la ubicación y completa el resto del formulario. [Solo en cascada] Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Recompensado

Selecciona Recompensado, ingresa el Nombre de la posición que desees y completa el resto del formulario. [Solo en cascada] Haz clic en el botón Continuar en la parte inferior de la página para crear la posición.

Especifique cómo monetizar su inventario

Ofertas

En Monetización, desactiva el interruptor de Ofertas integradas en la aplicación y la opción Habilitado. Luego, haz clic en el botón Continuar.

Cascada

No se requieren pasos adicionales.

Anota el ID de referencia y haz clic en Suena bien.

Banner de 300 x 250

Intersticial

Recompensado

Ubica tu clave de API de informes

Ofertas

Este paso no es obligatorio para las integraciones de ofertas.

Cascada

Además del ID de app y el ID de referencia, también necesitarás tu clave de API de informes de Vungle para configurar tu ID de bloque de anuncios de AdMob. Navega hasta el panel de informes de Vungle y haz clic en el botón Clave de API de informes para ver tu Clave de API de informes.

Paso 2: Configure su bloque de anuncios de AdMob

Debe agregar Vungle a la configuración de mediación para sus bloques de anuncios de AdMob. Primero, acceda a su cuenta de AdMob.

Navegue a la pestaña Mediación. Si tienes un grupo de mediación existente que deseas modificar, haz clic en el nombre de ese grupo de mediación para editarlo y pasa a Agregar Vungle como una fuente del anuncio.

Para crear un nuevo grupo de mediación, seleccione Crear grupo de mediación.

Ingrese el formato del anuncio y la plataforma y, luego, haga clic en Continuar.

Android

Asigne un nombre a su grupo de mediación y seleccione las ubicaciones de segmentación. A continuación, establece el estado del grupo de mediación en Enabled. Luego, haga clic en Agregar bloques de anuncios.

Asocia este grupo de mediación con uno o más de tus bloques de anuncios de AdMob existentes. Luego, haz clic en Listo.

Ahora deberías ver la tarjeta de bloques de anuncios propagada con los bloques de anuncios que seleccionaste, como se muestra a continuación:

iOS

Asigne un nombre a su grupo de mediación y seleccione las ubicaciones de segmentación. A continuación, establece el estado del grupo de mediación en Enabled. Luego, haga clic en Agregar bloques de anuncios.

Asocia este grupo de mediación con uno o más de tus bloques de anuncios de AdMob existentes. Luego, haz clic en Listo.

Ahora deberías ver la tarjeta de bloques de anuncios propagada con los bloques de anuncios que seleccionaste, como se muestra a continuación:

Agregar Vungle como fuente del anuncio

Ofertas

En la tarjeta Ofertas en la sección Fuentes del anuncio, selecciona Agregar fuente del anuncio. Luego, selecciona Vungle.

Luego, ingresa el ID de aplicación, el ID de referencia de posición que obtuviste en la sección anterior y haz clic en Listo.

Por último, haz clic en Guardar.

Cascada

En la tarjeta Fuentes del anuncio, seleccione Agregar red publicitaria. Selecciona Vungle y habilita el interruptor Optimizar. En Clave de API de informes, ingresa la Clave de API de informes que obtuviste en la sección anterior a fin de configurar la optimización de la fuente del anuncio para Vungle. Luego, ingresa un valor de eCPM para Vungle y haz clic en Continuar.

Ingresa el ID de aplicación y el ID de referencia de posición que obtuviste en la sección anterior. Si usas la versión 4.x o una anterior del SDK de Vungle, el ID de referencia de posición puede quedar en blanco.

Android

iOS

Cómo usar anuncios recompensados

En la configuración de tu bloque de anuncios recompensados, marca la casilla Aplicar a todas las redes de los grupos de mediación para proporcionar la misma recompensa al usuario, sin importar qué red de publicidad se publique.

Si no anulas la recompensa, el adaptador de Vungle usará de forma predeterminada una recompensa de tipo "vungle" con el valor 1. El SDK de Vungle no proporciona valores de recompensa específicos para sus anuncios recompensados.

Para obtener más información sobre cómo establecer valores de recompensa para los bloques de anuncios de AdMob, consulta Cómo crear un bloque de anuncios.

Paso 3: Importa el SDK y el adaptador de Vungle

Descarga la última versión del complemento de mediación de anuncios de Google para dispositivos móviles de Vungle desde el vínculo de descarga en el Registro de cambios y extrae GoogleMobileAdsVungleMediation.unitypackage del archivo ZIP.

En el editor de proyectos de Unity, selecciona Assets > Import Package > Custom Package y busca el archivo GoogleMobileAdsVungleMediation.unitypackage que descargaste. Asegúrese de que todos los archivos estén seleccionados y haga clic en Importar.

Luego, selecciona Assets > Play Services Resolver > Android Resolver > Force Resolve. La biblioteca del agente de resolución de Servicios de Play para Unity realizará la resolución de dependencias desde cero y copiará las dependencias declaradas en el directorio Assets/Plugins/Android de tu app de Unity.

Paso 4: Se requiere un código adicional

Vungle requiere una lista de todas las posiciones que se usarán en tu app para pasarlas a su SDK. Puedes proporcionar la lista de posiciones al adaptador mediante las clases VungleInterstitialMediationExtras y VungleRewardedVideoMediationExtras. En los siguientes ejemplos de código, se muestra cómo usar estas clases.

Intersticial

VungleInterstitialMediationExtras extras = new VungleInterstitialMediationExtras();
#if UNITY_ANDROID
    extras.SetAllPlacements(new string[] { "ANDROID_PLACEMENT_1", "ANDROID_PLACEMENT_2" });
#elif UNITY_IPHONE
    extras.SetAllPlacements(new string[] { "IOS_PLACEMENT_1", "IOS_PLACEMENT_2" });
#endif

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

Recompensado

VungleRewardedVideoMediationExtras extras = new VungleRewardedVideoMediationExtras();
#if UNITY_ANDROID
    extras.SetAllPlacements(new string[] { "ANDROID_PLACEMENT_1", "ANDROID_PLACEMENT_2" });
#elif UNITY_IPHONE
    extras.SetAllPlacements(new string[] { "IOS_PLACEMENT_1", "IOS_PLACEMENT_2" });
#endif

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

Paso 5: Pruebe su implementación

Para habilitar los anuncios de prueba, ve al panel de Vungle y navega a Aplicaciones.

Selecciona tu app para la que deseas habilitar los anuncios de prueba en la sección ID de referencia de posición de tu app. Para habilitar los anuncios de prueba, selecciona Modo de prueba en Mostrar anuncios de prueba solamente en la sección Estado.

Android

iOS

Eso es todo. Ahora tiene una integración de mediación activa con Vungle.

Pasos opcionales

Según la Política de Consentimiento de Usuarios de la UE de Google, debe asegurarse de que se proporcionen ciertas divulgaciones y consentimientos obtenidos de usuarios del Espacio Económico Europeo (EEE) relacionados con el uso de identificadores personales y datos personales. Esta política refleja los requisitos de la Directiva de Privacidad Electrónica de la UE y el Reglamento General de Protección de Datos (GDPR). Cuando solicites consentimiento, debes identificar cada red publicitaria de tu cadena de mediación que pueda recopilar, recibir o usar datos personales y proporcionar información sobre el uso de cada red. Actualmente, Google no puede pasar la elección de consentimiento del usuario a esas redes automáticamente.

En la siguiente sección, se muestra cómo habilitar o inhabilitar los anuncios personalizados para Vungle.

El complemento de mediación de anuncios de Google para dispositivos móviles de la versión 3.0.0 de Vungle incluye los métodos Vungle.UpdateConsentStatus() y Vungle.GetCurrentConsentStatus(). Hay dos valores posibles que puede indicar para actualizar el estado de consentimiento:

  • VungleConsent.ACCEPTED
  • VungleConsent.DENIED

El siguiente código de muestra actualiza el estado de consentimiento a VungleConsent.ACCEPTED. Si decides llamar a este método, se recomienda que lo hagas antes de solicitar los anuncios a través del SDK de Google Mobile Ads.

using GoogleMobileAds.Api.Mediation.Vungle;
// ...

Vungle.UpdateConsentStatus(VungleConsent.ACCEPTED);

También puedes verificar el estado de consentimiento actual de Vungle con el siguiente código:

Vungle.GetCurrentConsentStatus();

En la versión 3.1.0 del complemento de mediación de anuncios móviles de Google para Vungle, se actualizó el método UpdateConsentStatus() para incluir una versión de mensaje de consentimiento:

using GoogleMobileAds.Api.Mediation.Vungle;
// ...

Vungle.UpdateConsentStatus(VungleConsent.ACCEPTED, "1.0.0");

Puedes obtener esta versión del mensaje de consentimiento para Vungle con el siguiente código:

Vungle.GetCurrentConsentMessageVersion();

Consulta el artículo sobre las preguntas y respuestas del GDPR de Vungle para obtener más información.

Agregar Vungle a la lista de socios publicitarios del GDPR

Sigue los pasos que se indican en la configuración del GDPR para agregar Vungle a la lista de socios de anuncios del GDPR en la IU de AdMob.

CCPA

Ley de Privacidad del Consumidor de California (CCPA) requiere que los residentes del estado de California tengan el derecho de rechazar la “venta” de su “información personal” (según la definición de esas condiciones), con la opción de no participar mediante el vínculo destacado “No vender mi información personal” en la página principal del “vendedor”. La guía de preparación de la CCPA ofrece la posibilidad de habilitar el procesamiento de datos restringido para la publicación de anuncios de Google, pero Google no puede aplicar esta configuración a cada red de publicidad en tu cadena de mediación. Por lo tanto, debes identificar cada red de publicidad en tu cadena de mediación que pueda participar en la venta de información personal y seguir la orientación de cada una de esas redes para garantizar el cumplimiento de la CCPA.

Agregar Vungle a la lista de socios publicitarios de la CCPA

Siga los pasos que se indican en la configuración de la CCPA para agregar Vungle a la lista de socios de anuncios de la CCPA en la IU de AdMob.

Códigos de error

Si el adaptador no recibe un anuncio de Vungle, los publicadores pueden verificar el error subyacente de la respuesta del anuncio mediante ResponseInfo en las siguientes clases:

iOS

Formato Nombre de clase
Banner GADMAdapterVungleInterstitial
Intersticial GADMAdapterVungleInterstitial
Recompensado Anuncio de video de recompensa por GADMAdapterVungleRewardBasedVideoAd

A continuación, se incluyen los códigos y mensajes adjuntos que muestra el adaptador Vungle cuando un anuncio no se carga:

iOS

Código de error Motivo
1-100 El SDK de Vungle mostró un error. Consulta el código para obtener más detalles.
101 Faltan parámetros del servidor de Vungle configurados en la IU de AdMob o estos no son válidos.
102 Ya se cargó un anuncio para esta configuración de red. El SDK de Vungle no puede cargar un segundo anuncio para el mismo ID de posición.
103 El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con Vungle.
104 El SDK de Vungle no pudo procesar el anuncio de banner.
105 El SDK de Vungle solo admite cargar 1 anuncio de banner a la vez, independientemente del ID de posición.
106 El SDK de Vungle envió una devolución de llamada que indica que el anuncio no se puede reproducir.

Registro de cambios del complemento de mediación de Unity de Vungle

Versión 3.9.0

  • Admite la versión 6.12.0.0 del adaptador de Android Vungle .
  • Compatible con adaptador de iOS Vungle 6.12.0.0.
  • Compilado y probado con el complemento de Unity de anuncios de Google para dispositivos móviles versión 7.2.0.

Versión 3.8.2

Versión 3.8.1

Versión 3.8.0

Versión 3.7.5

  • Admite la versión 6.10.5.0 del adaptador de Android Vungle .
  • Compatible con adaptador de iOS Vungle 6.10.6.1.
  • Compilado y probado con el complemento de Unity de anuncios de Google para dispositivos móviles versión 7.0.0.

Versión 3.7.4

  • Admite la versión 6.10.4.0 del adaptador de Android Vungle .
  • Compatible con adaptador de iOS Vungle 6.10.6.1.
  • Compilado y probado con el complemento de Unity de anuncios de Google para dispositivos móviles versión 7.0.0.

Versión 3.7.3

Versión 3.7.2

Versión 3.7.1

Versión 3.7.0

Versión 3.6.0

Versión 3.5.1

Versión 3.5.0

Versión 3.4.1

Versión 3.4.0

Versión 3.3.1

  • Se volvió a empaquetar vungle-extras-library.jar en vungle-unity-android-library.aar, mediante una compilación .aar para admitir Unity 2020.
    • Cuando actualices a esta versión, quita vungle-extras-library.jar de tu proyecto.
  • Admite la versión 6.5.3.0 del adaptador de Android Vungle .
  • Compatible con la versión 6.5.3.0 del adaptador de iOS de Vungle.

Versión 3.3.0

Versión 3.2.0

Versión 3.1.4

  • Admite la versión 6.3.24.1 del adaptador de Android.
  • Admite la versión 6.3.2.3 del adaptador de iOS.

Versión 3.1.3

  • Admite la versión 6.3.24.1 del adaptador de Android.
  • Admite la versión 6.3.2.2 del adaptador de iOS.

Versión 3.1.2

  • Se actualizó el complemento para que sea compatible con la nueva API Beta recompensada abierta.
  • Admite la versión 6.3.24.1 del adaptador de Android.
  • Admite la versión 6.3.2.1 del adaptador de iOS.

Versión 3.1.1

  • Admite la versión 6.3.24.0 del adaptador de Android.
  • Admite la versión 6.3.2.0 del adaptador de iOS.
  • Se actualizó el método Vungle.UpdateConsentStatus() para que el parámetro consentMessageVersion sea opcional. El valor de consentMessageVersion ahora se ignora para iOS.
  • Vungle.GetCurrentConsentMessageVersion() dejó de estar disponible para iOS.

Versión 3.1.0

  • Admite la versión 6.3.17.0 del adaptador de Android.
  • Admite la versión 6.3.0.0 del adaptador de iOS.
  • Se actualizó el método Vungle.UpdateConsentStatus() a fin de tomar un parámetro String adicional para la versión del mensaje de consentimiento proporcionado por el publicador
  • Se agregó el método Vungle.GetCurrentConsentMessageVersion() para obtener la versión del mensaje de consentimiento que proporcionó el publicador.

Versión 3.0.1

  • Admite la versión 6.2.5.1 del adaptador de Android.
  • Admite la versión 6.2.0.3 del adaptador de iOS.

Versión 3.0.0

  • Admite la versión 6.2.5.0 del adaptador de Android.
  • Admite la versión 6.2.0.2 del adaptador de iOS.
  • Se agregaron los siguientes métodos:
    • Vungle.UpdateConsentStatus() para establecer el estado de consentimiento que se registrará en el SDK de Vungle.
    • Vungle.GetCurrentConsentStatus() para obtener el estado de consentimiento actual del usuario.

Versión 2.0.0

  • Admite la versión 5.3.2.1 del adaptador de Android.
  • Admite la versión 6.2.0.0 del adaptador de iOS.

Versión 1.1.0

  • Admite la versión 5.3.2.1 del adaptador de Android.
  • Admite la versión 5.4.0.0 del adaptador de iOS.

Versión 1.0.0

  • Primera versión
  • Admite la versión 5.3.0.0 del adaptador de Android.
  • Admite la versión 5.3.0.0 del adaptador de iOS.