Cómo integrar Vungle a la mediación

Esta guía está destinada a los editores que desean usar el SDK de anuncios de Google para dispositivos móviles a fin de cargar y mostrar anuncios de Vungle a través de la mediación. Abarca cómo agregar Vungle a la configuración de mediación de un bloque de anuncios, cómo configurar la optimización de la fuente del anuncio y cómo integrar el SDK y el adaptador de Vungle a una app de Unity.

Integraciones y formatos de anuncios admitidos

Integración
Ofertas
Cascada
Formatos
Banner
Intersticial
Recompensado

Requisitos

  • Unity 4 o una versión posterior
  • SDK de anuncios de Google para dispositivos móviles más recientes
  • Para implementar en Android
    • Nivel 21 o versiones posteriores de la API de Android
  • Para implementar en iOS:
    • Objetivo de implementación de iOS 10.0 o superior
  • Un proyecto de Unity que funcione y que esté configurado con el SDK de anuncios de Google para dispositivos móviles Consulta Comenzar para obtener más información.

Limitaciones

  • Vungle no admite la carga de varios anuncios con el mismo ID de referencia de posición.
    • El adaptador Vungle falla correctamente a la segunda solicitud si otra solicitud para esa posición se carga o está esperando para mostrarse.
  • Vungle solo admite la carga de 1 anuncio de banner por 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.

Agrega tu app al panel de aplicaciones de Vungle haciendo clic en el botón Agregar aplicación.

Completa el formulario y, luego, ingresa todos los detalles necesarios. Luego, haz clic en el botón Continuar, en la parte inferior de la página, para agregar tu app a Vungle.

Android

iOS

Una vez que hayas creado tu app, selecciónala en el panel de aplicaciones de Vungle.

Android

iOS

Anota el ID de app.

Android

iOS

Cómo agregar posiciones nuevas

Si deseas crear una posición nueva para usarla con la mediación de AdMob, navega al panel de Posiciones de Vungle, haz clic en el botón Agregar posición y selecciona tu app en la lista desplegable.

A continuación, se incluyen detalles sobre cómo agregar nuevas posiciones:

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

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

Banner (300 x 250)

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

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

Intersticial

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

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

Recompensado

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

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

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 al panel de los 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 de 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 ve directamente a Agregar Vungle como fuente del anuncio.

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

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

Android

Asigne un nombre al 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, haz 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, haga clic en Listo.

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

iOS

Asigne un nombre al 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, haz 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, haga clic en Listo.

Ahora debería aparecer 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

En la tarjeta Fuentes del anuncio, selecciona Agregar red de publicidad. Selecciona Vungle y habilita el interruptor Optimize (Optimizar). En Reporting API Key, ingresa la Reporting API Key obtenida en la sección anterior a fin de configurar la optimización de la fuente del anuncio para Vungle. Luego, ingrese un valor de eCPM para Vungle y haga 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

Con anuncios recompensados

En la configuración de su bloque de anuncios recompensados, marque la casilla Aplicar a todas las redes en los grupos de mediación para que proporcione la misma recompensa al usuario sin importar qué red se publique.

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

Puedes obtener más información para configurar valores de recompensa para los bloques de anuncios de AdMob en Cómo crear un bloque de anuncios.

Paso 3: Importa el SDK y el adaptador de Vungle

Descarga la versión más reciente del complemento de mediación de anuncios de Google para dispositivos móviles de Vungle del vínculo de descarga en Changelog y extrae el 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 de resolución de Servicios de Play de Unity se realizará desde cero la copia de dependencias y copiará las dependencias declaradas en el directorio Assets/Plugins/Android de tu app de Unity.

Paso 4: Se requiere 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 a tu panel de Vungle y navega a Aplicaciones.

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

Android

iOS

Listo. Ahora tiene una integración de mediación activa en Vungle.

Pasos opcionales

Según la Política de Consentimiento de Usuarios de la UE de Google, debe asegurarse de que se divulguen ciertas divulgaciones y consentimientos 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 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 de publicidad en tu cadena de mediación que pueda recopilar, recibir o usar datos personales y proporcionar información sobre el uso de cada red. Por el momento, Google no puede pasar automáticamente el consentimiento de los usuarios a esas redes.

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

El complemento de mediación de los 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 cuando actualiza el estado de consentimiento:

  • VungleConsent.ACCEPTED
  • VungleConsent.DENIED

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

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 Google Mobile Ads 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 de preguntas y respuestas del GDPR de Vungle para obtener más información.

Agregar Vungle a la lista de socios de anuncios 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

La Ley de Privacidad del Consumidor de California (CCPA) requiere que los residentes del estado de California tengan el derecho de rechazar la &venta La guía sobre preparación de la CCPA ofrece la posibilidad de habilitar el procesamiento de datos restringido para la publicación de anuncios de Google, pero 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 las indicaciones de cada una de esas redes para garantizar el cumplimiento de la CCPA.

Agregar Vungle a la lista de socios de anuncios 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 GADMAdapterVungleIntersticial
Intersticial GADMAdapterVungleIntersticial
Recompensado Anuncio GADMAdapterVungleRewardBasedVideo

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

iOS

Código de error Motivo
1-100 El SDK de Vungle mostró un error. Consulta 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 con el mismo ID de posición.
103 El tamaño del anuncio solicitado no coincide con un tamaño de banner compatible con Vungle.
104 El SDK de Vungle no pudo renderizar el anuncio de banner.
105 El SDK de Vungle solo admite la carga de 1 anuncio de banner por vez, independientemente del ID de posición.
106 El SDK de Vungle envió una devolución de llamada para indicar que el anuncio no se puede reproducir.

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

Versión 3.8.1

Versión 3.8.0

Versión 3.7.5

Versión 3.7.4

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 esta versión, quita vungle-extras-library.jar del proyecto.
  • Admite la versión 6.5.3.0 del adaptador de Android Vungle.
  • Compatible con 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 para 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 abierta 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 hacer que el parámetro consentMessageVersion sea opcional. El valor de consentMessageVersion ahora se ignora para iOS.
  • Se dio de baja Vungle.GetCurrentConsentMessageVersion() 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 proporcionado por 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 para 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.