Integrando Vungle con Mediación

Esta guía está destinada a los editores que desean utilizar el SDK de anuncios móviles de Google para 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 red publicitaria (ANO) y cómo integrar el SDK y el adaptador de Vungle en una aplicación de Unity.

Integraciones y formatos de anuncios compatibles

Integración
Ofertas
Cascada
Formatos
Bandera
intersticial
recompensado

Requisitos

  • Unidad 4 o superior
  • Último SDK de anuncios de Google para móviles
  • Para implementar en Android
    • Android API nivel 16 o superior
  • Para implementar en iOS
    • Objetivo de implementación de iOS de 10.0 o superior
  • Un proyecto de Unity en funcionamiento configurado con el SDK de Google Mobile Ads. Consulte Comenzar para obtener más detalles.

Limitaciones

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

Paso 1: configurar Vungle

Regístrese o inicie sesión en su cuenta de Vungle.

Agregue su aplicación al panel de aplicaciones de Vungle haciendo clic en el botón Agregar aplicación .

Complete el formulario, ingrese todos los detalles necesarios, luego haga clic en el botón Continuar en la parte inferior de la página para agregar su aplicación a Vungle.

Androide

iOS

Una vez que haya creado su aplicación, seleccione su aplicación desde el panel de aplicaciones de Vungle .

Androide

iOS

Tome nota de la ID de la aplicación .

Androide

iOS

Adición de nuevas ubicaciones

Para crear una nueva ubicación que se utilizará con la mediación de AdMob, navegue hasta el panel Ubicaciones de Vungle , haga clic en el botón Agregar ubicación y seleccione su aplicación de la lista desplegable.

Los detalles para agregar nuevas ubicaciones se incluyen a continuación:

Seleccione Banner , ingrese el Nombre de ubicación deseado y complete el resto del formulario. Haga clic en el botón Continuar en la parte inferior de la página para crear la ubicación.

Tome nota de la ID de referencia y haga clic en Suena bien .

Pancarta de 300x250

Seleccione MREC , ingrese el Nombre de la ubicación deseada y complete el resto del formulario. Haga clic en el botón Continuar en la parte inferior de la página para crear la ubicación.

Tome nota de la ID de referencia y haga clic en Suena bien .

intersticial

Seleccione Intersticial , ingrese el Nombre de ubicación deseado y complete el resto del formulario. Haga clic en el botón Continuar en la parte inferior de la página para crear la ubicación.

Tome nota de la ID de referencia y haga clic en Suena bien .

recompensado

Seleccione Recompensa , ingrese el Nombre de la ubicación deseada y complete el resto del formulario. Haga clic en el botón Continuar en la parte inferior de la página para crear la ubicación.

Tome nota de la ID de referencia y haga clic en Suena bien .

Además del ID de aplicación y el ID de referencia , también necesitará su clave API de informes de Vungle para configurar su ID de bloque de anuncios de AdMob. Navegue hasta el panel de informes de Vungle y haga clic en el botón Clave de API de informes para ver su 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 inicie sesión en su cuenta de AdMob .

Vaya a la pestaña Mediación . Si tiene un grupo de mediación existente que le gustaría modificar, haga clic en el nombre de ese grupo de mediación para editarlo y vaya directamente a Agregar Vungle como fuente de anuncios .

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

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

Androide

Asigne un nombre a su grupo de mediación y seleccione las ubicaciones a las que dirigirse. A continuación, establezca el estado del grupo de mediación en Habilitado . A continuación, haga clic en Añadir bloques de anuncios .

Asocie este grupo de mediación con uno o más de sus bloques de anuncios de AdMob existentes. Luego haga clic en Listo .

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

iOS

Asigne un nombre a su grupo de mediación y seleccione las ubicaciones a las que dirigirse. A continuación, establezca el estado del grupo de mediación en Habilitado . A continuación, haga clic en Añadir bloques de anuncios .

Asocie este grupo de mediación con uno o más de sus bloques de anuncios de AdMob existentes. Luego haga clic en Listo .

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

Agregar Vungle como fuente de publicidad

En la tarjeta Fuentes de anuncios , seleccione Agregar red publicitaria . Seleccione Vungle y habilite el interruptor Optimizar . Para Reporting API Key , ingrese la Reporting API Key obtenida en la sección anterior para configurar ANO para Vungle. Luego ingrese un valor de eCPM para Vungle y haga clic en Continuar .

Ingrese el ID de la aplicación y el ID de referencia de la ubicación obtenidos en la sección anterior. Si usa la versión 4.x o anterior del SDK de Vungle, el ID de referencia de ubicación se puede dejar en blanco.

Androide

iOS

Uso de anuncios recompensados

En la configuración de su bloque de anuncios bonificados, 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 publicitaria se sirva.

Si no anula la recompensa, el adaptador de Vungle tiene como valor predeterminado una recompensa de tipo "vungle" con 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, consulte Crear un bloque de anuncios .

Paso 3: Importe el SDK y el adaptador de Vungle

Descargue la última versión del complemento de mediación de Google Mobile Ads para Vungle desde el enlace de descarga en el Registro de cambios y extraiga el GoogleMobileAdsVungleMediation.unitypackage del archivo zip.

En su editor de proyectos de Unity, seleccione Activos > Importar paquete > Paquete personalizado y busque el archivo GoogleMobileAdsVungleMediation.unitypackage que descargó. Asegúrese de que todos los archivos estén seleccionados y haga clic en Importar .

Luego, seleccione Activos > Solucionador de servicios de juego > Solucionador de Android > Forzar resolución . La biblioteca Unity Play Services Resolver llevará a cabo la resolución de dependencias desde cero y copiará las dependencias declaradas en el directorio Assets/Plugins/Android de su aplicación Unity.

Paso 4: Código adicional requerido

Vungle requiere que se pase a su SDK una lista de todas las ubicaciones que se usarán dentro de su aplicación. Puede proporcionar la lista de ubicaciones al adaptador mediante las clases VungleInterstitialMediationExtras y VungleRewardedVideoMediationExtras . Los siguientes ejemplos de código muestran 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, vaya a su panel de Vungle y navegue a Aplicaciones .

Seleccione su aplicación para la que le gustaría habilitar los anuncios de prueba en la sección ID de referencia de ubicación de su aplicación. Los anuncios de prueba se pueden habilitar seleccionando Modo de prueba para Mostrar anuncios de prueba solo en la sección Estado .

Androide

iOS

¡Eso es todo! Ahora tiene una integración de mediación en funcionamiento con Vungle.

Pasos opcionales

De acuerdo con la Política de consentimiento de usuarios de la UE de Google, debe asegurarse de que se proporcionen ciertas divulgaciones y se obtengan consentimientos de los usuarios en el Espacio Económico Europeo (EEE) con respecto al 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). Al solicitar el consentimiento, debe identificar cada red publicitaria en su 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 opción de consentimiento del usuario a dichas redes automáticamente.

La siguiente sección le muestra cómo habilitar o deshabilitar anuncios personalizados para Vungle.

El complemento de mediación de Google Mobile Ads para la versión 3.0.0 de Vungle incluye los Vungle.UpdateConsentStatus() y Vungle.GetCurrentConsentStatus() . Hay dos posibles valores que puede indicar al actualizar el estado de consentimiento:

  • VungleConsent.ACCEPTED
  • VungleConsent.DENIED

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

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

Vungle.UpdateConsentStatus(VungleConsent.ACCEPTED);

También puede verificar el estado de consentimiento actual de Vungle usando el siguiente código:

Vungle.GetCurrentConsentStatus();

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

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

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

Puede obtener esta versión de mensaje de consentimiento para Vungle usando el siguiente código:

Vungle.GetCurrentConsentMessageVersion();

Consulte el artículo Preguntas y respuestas sobre el RGPD de Vungle para obtener más información.

Códigos de error

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

iOS

Formato Nombre de la clase
Bandera GADMAdapterVungleIntersticial
intersticial GADMAdapterVungleIntersticial
recompensado GADMAdapterVungleRewardBasedVideoAd

Estos son los códigos y los mensajes que los acompañan que arroja el adaptador Vungle cuando un anuncio no se carga:

iOS

Código de error Razón
1-100 Vungle SDK devolvió un error. Ver código para más detalles.
101 Los parámetros del servidor de Vungle configurados en la interfaz de usuario de AdMob faltan o no son válidos.
102 Ya hay un anuncio cargado para esta configuración de red. Vungle SDK no puede cargar un segundo anuncio para el mismo ID de ubicación.
103 El tamaño de anuncio solicitado no coincide con un tamaño de banner compatible con Vungle.
104 Vungle SDK no pudo mostrar el anuncio publicitario.
105 Vungle SDK solo admite la carga de 1 anuncio de banner a la vez, independientemente del ID de ubicación.
106 Vungle SDK envió una devolución de llamada diciendo que el anuncio no se puede reproducir.

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

Versión 3.8.0 (En Progreso)

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 del adaptador de Android 6.3.24.1.
  • Admite la versión 6.3.2.3 del adaptador iOS.

Versión 3.1.3

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

Versión 3.1.2

  • Se actualizó el complemento para admitir la nueva API recompensada de beta abierta.
  • Admite la versión del adaptador de Android 6.3.24.1.
  • Admite la versión 6.3.2.1 del adaptador iOS.

Versión 3.1.1

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

Versión 3.1.0

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

Versión 3.0.1

  • Compatible con el adaptador de Android versión 6.2.5.1.
  • Compatible con la versión 6.2.0.3 del adaptador iOS.

Versión 3.0.0

  • Admite la versión del adaptador de Android 6.2.5.0.
  • Admite la versión 6.2.0.2 del adaptador 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 el adaptador de Android versión 5.3.2.1.
  • Admite la versión 6.2.0.0 del adaptador iOS.

Versión 1.1.0

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

Versión 1.0.0

  • ¡Primer lanzamiento!
  • Admite el adaptador de Android versión 5.3.0.0.
  • Admite la versión 5.3.0.0 del adaptador iOS.