Cómo integrar Vungle con la mediación

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Esta guía está destinada a los editores que desean usar el SDK de Google Mobile Ads para cargar y mostrar anuncios de Vungle a través de ofertas y mediación de cascadas. Se explica 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 en una app de Unity.

Integraciones y formatos de anuncios compatibles

Integración
Ofertas 1
Cascada
Formatos
Banner 2
Intersticial
Recompensado

1 La integración de ofertas está 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 Móvil más reciente [para ofertas]: Complemento de mediación de los anuncios de Google Móvil para Vungle 3.8.2 o versiones posteriores (se recomienda la versión más reciente)
  • Para implementar en Android, haz lo siguiente:
    • 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 superior
    • [For bidding]: Adaptador de Vungle 6.11.0.1 o superior (se recomienda la versión más reciente)
  • 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 detalles.

Limitaciones

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

Llene el formulario e ingrese todos los detalles necesarios.

Android

iOS

Una vez creada la app, selecciónala en el panel de aplicaciones de Vungle.

Android

iOS

Toma nota del ID de la app.

Android

iOS

Agregar ubicaciones nuevas

A fin de crear una posición nueva para usarla con la Mediación de AdMob, navega al panel 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 ubicaciones:

Selecciona Banner, ingresa el Nombre de la posición que desees y llena el resto del formulario. [Solo 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 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 posición que desees y completa el resto del formulario. [Solo 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 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, active o desactive el interruptor Ofertas en la aplicación Habilitada y, luego, haga clic en el botón Continuar.

Cascada

No se requieren pasos adicionales.

Toma nota del ID de referencia y haz clic en Suena bien.

Banner de 300 x 250

Intersticial

Recompensado

Ubique su 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 al 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 de sus bloques de anuncios de AdMob. Primero, acceda a su cuenta de AdMob.

Navegue a la pestaña Mediación. Si tiene un grupo de mediación existente que desea modificar, haga clic en el nombre de ese grupo de mediación para editarlo y continúe con Agregar Vungle como fuente del anuncio.

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

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

Android

Asigne un nombre al grupo de mediación y seleccione las ubicaciones para orientar. A continuación, establece el estado del grupo de mediación en Habilitado. 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, haga 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 al grupo de mediación y seleccione las ubicaciones para orientar. A continuación, establece el estado del grupo de mediación en Habilitado. 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, haga 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 y el ID de referencia de posición que obtuviste en la sección anterior,y haz clic en Listo.

Por último, haga clic en Guardar.

Cascada

En la tarjeta Fuentes del anuncio, selecciona Agregar red de publicidad. 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 versión 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, independientemente de qué red de publicidad se publique.

Si no anulas la recompensa, el adaptador Vungle tendrá como valor predeterminado 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 versión más reciente 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 de 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 pasarse a su SDK. Puedes proporcionar la lista de posiciones para el 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: Prueba tu implementación

Para habilitar los anuncios de prueba, ve al 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 solo anuncios de prueba en la sección Estado.

Android

iOS

Eso es todo. Ahora tienes 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 garantizar que se divulguen ciertas divulgaciones y consentimientos obtenidos de 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 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 automáticamente la elección de consentimiento del usuario 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 Google Mobile Ads para 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

En el siguiente código de muestra, se actualiza el estado de 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 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 Google Mobile Ads para Vungle, se actualizó el método UpdateConsentStatus() para incluir una versión de mensajes 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 sobre el GDPR de Vungle's 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

Ley de Privacidad del Consumidor de California (CCPA) Otorga a los residentes del estado de California el derecho de rechazar la “venta” de su información personal (según la definición de esos términos) con la opción de inhabilitar la página principal: La guía de Preparación de la CCPA ofrece la capacidad 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 publicitaria 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 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 GADMAdapterVungleInterstitial
Intersticial GADMAdapterVungleInterstitial
Recompensado Anuncio de video de GADMAdapterVungleRewardBased

Estos son los códigos y mensajes adjuntos que arroja 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 la carga de 1 anuncio de banner a la vez, independientemente del ID de posición.
106 El SDK de Vungle envió una devolución de llamada para indicar que no se puede reproducir el anuncio.

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

Versión 3.9.0

Versión 3.8.2

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

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 versión Beta abierta de la API recompensada.
  • 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.
  • 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 proporcionado por el editor.

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.