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:
Banner
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
Consentimiento de la UE y GDPR
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
- Compatible con adaptador de Android versión 6.11.0.1.
- Compatible con 6.11.0.0 del adaptador de iOS de Vungle
- Se creó y se probó con la versión 7.0.2 del complemento de Unity de Google Mobile Ads.
Versión 3.8.0
- Admite la versión 6.11.0.0 del adaptador de Android Vungle.
- Compatible con 6.11.0.0 del adaptador de iOS de Vungle
- Se creó y se probó con la versión 7.0.0 del complemento de Unity de Google Mobile Ads.
Versión 3.7.5
- Admite la versión 6.10.5.0 del adaptador de Android Vungle.
- Compatible con 6.10.6.1 del adaptador de iOS de Vungle
- Se creó y se probó con la versión 7.0.0 del complemento de Unity de Google Mobile Ads.
Versión 3.7.4
- Admite la versión 6.10.4.0 del adaptador de Android Vungle.
- Compatible con 6.10.6.1 del adaptador de iOS de Vungle
- Se creó y se probó con la versión 7.0.0 del complemento de Unity de Google Mobile Ads.
Versión 3.7.3
- Admite la versión 6.10.3.0 del adaptador de Android Vungle.
- Compatible con 6.10.5.1 del adaptador de iOS de Vungle.
Versión 3.7.2
- Compatible con adaptador de Android versión 6.10.2.1.
- Compatible con 6.10.5.1 del adaptador de iOS de Vungle.
Versión 3.7.1
- Admite la versión 6.10.2.0 del adaptador de Android Vungle.
- Compatible con 6.10.4.0 del adaptador de iOS de Vungle
Versión 3.7.0
- Admite la versión 6.10.2.0 del adaptador de Android Vungle.
- Compatible con 6.10.3.0 del adaptador de iOS de Vungle
Versión 3.6.0
- Compatible con 6.9.1.1 del adaptador de Android Vungle.
- Compatible con el adaptador iOS iOS versión 6.9.2.0.
Versión 3.5.1
- Compatible con Vungle Android Adapter versión 6.8.1.0.
- Compatible con 6.8.1.0 del adaptador de iOS de Vungle
Versión 3.5.0
- Admite la versión 6.8.0.0 del adaptador de Android Vungle.
- Compatible con 6.8.0.0 del adaptador de iOS de Vungle
Versión 3.4.1
- Compatible con 6.7.1.0 del adaptador de Android Vungle.
- Compatible con 6.7.1.0 del adaptador para iOS de Vungle.
Versión 3.4.0
- Admite la versión 6.7.0.0 del adaptador de Android Vungle.
- Compatible con 6.7.0.0 del adaptador para iOS de Vungle
Versión 3.3.1
- Se volvió a empaquetar
vungle-extras-library.jar
envungle-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.
- Cuando actualices esta versión, quita
- 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
- 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.2.0
- Compatible con 6.4.11.1 de adaptador de Android Vungle.
- Compatible con 6.4.6.0 del adaptador de iOS de Vungle
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ámetroconsentMessageVersion
sea opcional. El valor deconsentMessageVersion
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ámetroString
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.