Utilice esta guía para añadir el SDK de Vungle para Android a su aplicación usando MoPub como la capa principal de mediación de anuncios.
Contenido
- Antes de empezar
- Paso 1. Establezca Vungle como una red nativa personalizada
- Paso 2. Añada Vungle como una red de anuncios externa
- Opciones de configuración
Antes de empezar
- El SDK de Vungle para Android no se ha probado con MoPub 4.15 y, por lo tanto, solo se debe integrar con MoPub 4.14.
- El panel de control (dashboard) de MoPub aún no incluye ubicaciones Vungle. Puede verificar el rendimiento del nivel de ubicación con nuestra API de informes para editores.
- MoPub debe configurarse en su aplicación antes de comenzar este tutorial. Para una guía paso a paso, consulte la Guía de introducción de MoPub para Android.
- Necesitará la id. de la aplicación de Vungle and y todas las id de ubicación que desee usar en la aplicación. Podrá encontrar esas id en el panel de control de Vungle (consulte Configurar y generar informes de las ubicaciones).
- El SDK de Vungle requiere:
- Android 3.0 (Honeycomb - API versión 11) o posterior
- Java 1.7: para fines de compatibilidad con Android 5.+, se necesita el JDK 7
- Java 1.8: para fines de compatibilidad con Android 7.+, se necesita el JDK 8
Paso 1. Establezca Vungle como una red nativa personalizada
Para garantizar que los servidores de MoPub reconozcan a los adaptadores integrados de Vungle, establezca Vungle como red nativa personalizada en el panel de control de MoPub.
- Inicie sesión en el panel de control (dashboard) de MoPub y seleccione Networks (redes) en la barra de navegación principal.
- Haga clic en Add a Network…
(Agregar una red) y seleccione Custom Native Network (Red nativa personalizada) en la parte inferior de la página.
- En la sección de establecer el inventario Set Up Your Inventory, para cada bloque o unidad de anuncios que usará el SDK de Vungle para presentar anuncios de video, asegúrese de que el SDK de MoPub pueda encontrar el adaptador de red utilizado para interactuar con el SDK de Vungle:
- Si está utilizando MoPub Rewarded Video para una unidad de anuncios, agregue
com.mopub.mobileads.VungleRewardedVideo
en la sección Custom Event Class (clases de eventos personalizadas).
- Si está utilizando Fullscreen (Interstitial) para una unidad de anuncios, agregue
com.mopub.mobileads.VungleInterstitial
en la sección Custom Event Class (clases de eventos personalizadas).
- Agregue su id. de la aplicación Vungle, id. de referencia de ubicación y todas las id. de referencia de ubicaciones en formato JSON en Custom Event Class Data.
- Establezca la id. de referencia de ubicación que desee vincular a la unidad MoPub Ad Unit para pid.
Nota: Se crea automáticamente una ubicación predeterminada para cada aplicación. Debe proporcionar la id. de referencia de la ubicación en este paso de la inicialización independientemente de si desea aprovechar la funcionalidad de las ubicaciones. Si crea varias ubicaciones, proporcione todas las id. de referencia.
- Asegúrese de vincular la id. de referencia de ubicación establecida como “con recompensa” a la unidad de anuncio de MoPub establecida como Rewarded Video (video con recompensa) y vincule la id. de referencia de ubicación que NO se estableció como “con recompensa” a la unidad de anuncio de MoPub establecida como anuncio de pantalla completa Fullscreen (Interstitial).
{ "appId":"5935efecc802d63d5100000f", "pid":"DEFAULT05223", "pids":"DEFAULT05223, PADUNIT49379, PADUNIT68848, PADUNIT04241, PADUNIT53279, PADUNIT08448" }
- Si está utilizando MoPub Rewarded Video para una unidad de anuncios, agregue
Nota: el SDK de Vungle almacenará en caché automáticamente un anuncio para la ubicación de almacenamiento automático en caché que seleccionó en el panel de control de Vungle. Recomendamos encarecidamente seleccionar la unidad de anuncio de MoPub en primer lugar o la unidad de anuncio que se muestra más frecuentemente como la ubicación de almacenamiento automático en caché.
Paso 2. Añada Vungle como una red de anuncios externa
Para añadir el SDK de Vungle para Android a su aplicación con MoPub mediation:
- Agregue todos los archivos relacionados con el adaptador Vungle (bajo
/extras/src/com/mopub/mobileads/
en el Repositorio del adaptador MoPub) al directorio/src/main/java/com/mopub/mobileads/
en el proyecto de su aplicación. Este paso es necesario porque MoPub SDK hace referencia a estos archivos como “Propiedades de clases de eventos personalizadas” en el directorio.VungleInterstitial.java
VungleRewardedVideo.java
VungleRouter.java
-
VungleRouterListener.java
- Siga las instrucciones en la sección “Paso 1. Incluya el SDK de Vungle en su proyecto” de “Introducción al SDK de Vungle para Android” para agregar los frameworks necesarios.
- Si debe configurar Multidex, Proguard y los servicios de Google Play, siga las instrucciones de la sección “Configuración avanzada” de “Introducción al SDK de Vungle para Android” para actualizar el archivo AndroidManifest.xml en su proyecto.
- Invoque el método MoPubInterstitial’s
show
(o, en el caso de los anuncios con recompensa, invoque el método MoPubRewardedVideos'sshowRewardedVideo
) cuando desee presentar un anuncio con video de Vungle. (No tiene que invocar directamente los métodos del SDK de Vungle para Android. Lo hará el SDK de MoPub). it.)
Opciones de configuración (opcional)
Anuncios intersticiales
Atributo |
Valor predeterminado |
Descripción |
SOUND_ENABLED_KEY |
true (verdadero) |
Reproducir anuncio con sonido silenciado o no silenciado. Establézcalo en “falso” (false) para reproducir silenciado, o en “verdadero” (true) para reproducir con sonido. |
ORDINAL_VIEW_COUNT_KEY |
null (nulo) |
Si recibe informes de datos ordinales de Vungle, use este campo para pasar el ordinal de mediación. Este es un número entero que indica el orden en que se mostró este anuncio en la sesión del juego (por ejemplo, si ya se mostraron dos anuncios en esta sesión, y este anuncio de Vungle se mostró tercero, pase “3”). Lea más sobre datos ordinales aquí. |
FLEX_VIEW_CLOSE_TIME_KEY |
null (nulo) |
Esta es la cantidad de segundos que reproducirán los videos Flex View antes de que se cierren automáticamente. |
Ejemplo
private Map<String, Object> getLocalExtras() { HashMap<String, Object> extras = new HashMap<>(); extras.put(VungleInterstitial.SOUND_ENABLED_KEY, mPreferences.getBoolean(SettingsActivity.KEY_PREF_SOUND_ENABLED, true)); extras.put(VungleInterstitial.ORDINAL_VIEW_COUNT_KEY, Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_ORDINAL, "3"), 0)); return extras;
Anuncios con recompensa
Atributo |
Valor predeterminado |
Descripción |
|
null (nulo) |
Pasa la id. de usuario único a su aplicación con el fin de verificar si el usuario debe recibir una recompensa por ver un anuncio incentivado. |
|
“Si cierra este video anticipadamente, no ganará su recompensa. ¿Está seguro?” |
Establece el cuerpo del cuadro de diálogo de confirmación al omitir un anuncio incentivado. |
|
“¿Cerrar el video?” |
Establece el texto del botón “Cancelar” del cuadro de diálogo de confirmación al omitir un anuncio incentivado. |
|
“Continuar viendo” |
Establece el texto del botón de “continuar mirando” del cuadro de diálogo de confirmación al omitir un anuncio incentivado. |
|
“¿Cerrar el video?” |
Establece el título del cuadro de diálogo de confirmación al omitir un anuncio incentivado. |
|
true (verdadero) |
Establece el estado inicial del sonido del anuncio. Si es “true” (verdadero), el audio respeta el volumen y los ajustes de sonido del dispositivo. Si es “false” (falso), el video comienza en silencio, pero el usuario puede modificarlo. |
|
null (nulo) |
Si recibe informes de datos ordinales de Vungle, use este campo para pasar el ordinal de mediación. Este es un número entero que indica el orden en que se mostró este anuncio en la sesión del juego (por ejemplo, si ya se mostraron dos anuncios en esta sesión, y este anuncio de Vungle se mostró tercero, pase “3”). Lea más sobre datos ordinales aquí. |
Ejemplo
private VungleMediationSettings getSettings() { return new VungleMediationSettings.Builder() .withUserId(mPreferences.getString(SettingsActivity.KEY_PREF_USER_ID, "user")) .withCancelDialogBody(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_BODY, "")) .withCancelDialogCloseButton(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_CLOSE, "")) .withFlexViewCloseTimeInSec(Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_FLEXVIEW_CLOSE_TIME, "5"), 0)) .withCancelDialogKeepWatchingButton(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_KEEP, "")) .withCancelDialogTitle(mPreferences.getString(SettingsActivity.KEY_PREF_CANCEL_TITLE, "")) .withSoundEnabled(mPreferences.getBoolean(SettingsActivity.KEY_PREF_SOUND_ENABLED, true)) .withOrdinalViewCount(Util.parseInt(mPreferences.getString(SettingsActivity.KEY_PREF_PREF_KEY_ORDINAL, "13"), 0)) .build(); }
Comentarios