Antes de empezar
Requisitos
El complemento de Vungle Unity es compatible con la versión 2017 del editor de Unity y superior, y contiene las siguientes versiones del SDK de Vungle.
iOS SDK v6.8.0
- iOS 9 o superior
Android SDK v6.8.0
- Android 4.0 (Ice Cream Sandwich: versión 14 de API y superior)
- Amazon OS 5.4 y superior
- Requiere Java 1.7 o superior para Android
Windows SDK v6.8.0
- Windows 10 UWP y Universal 8.1
Descargar el complemento
Descargue el complemento de Vungle para Unity aquí: https://publisher.vungle.com/sdk/plugins/unity
Referencia: aplicación de muestra
Consulte la aplicación de muestra que hemos proporcionado a medida que realiza la integración: https://github.com/Vungle/Unity-Plugin
Paso 1. Establezca su proyecto de Unity con el complemento Unity de Vungle
Agregue el complemento Unity de Vungle a su proyecto de Unity
Con su proyecto abierto en Unity, haga doble clic en el archivo descargado VunglePlugin.unitypackage para agregar el plugin Unity de Vungle a su aplicación. Cuando se abra la ventana Importar paquete de Unity, haga clic en Todos para seleccionar todo antes de realizar la importación.
Seleccione la plataforma correcta en Ajustes de compilación.
Para evitar errores de compilación durante el siguiente paso, asegúrese de que los ajustes de compilación (cmd + Shift + B) de su proyecto estén dirigidos a la plataforma iOS, Android o Universal Windows.
Amazon Appstore
El SDK de Vungle Android es compatible con Amazon OS 5.4 y superior. Puede enviar Android APK a Amazon Appstore, con los ajustes adicionales de la configuración de Unity Amazon Appstore. Consulte las instrucciones de Unity.
Servicios de Google Play
La inclusión de los servicios de Google Play en su proyecto le permite a Vungle proporcionar una experiencia publicitaria más personalizada al usuario final, pero no es obligatorio. Recomendamos usar la versión 16.0.0 o superior.
Para incluir los servicios de Google Play, recomendamos la guía de configuración de Google en el portal del desarrollador. En su aplicación, asegúrese de que el dispositivo tenga una versión suficientemente actualizada de los servicios de Google Play.
Dependencias de Android
El SDK de Vungle para Android requiere que incluya una de las siguientes dependencias en su compilación. Agréguelas manualmente o inclúyalas en una plantilla de Gradle si usa Gradle.
implementation 'androidx.appcompat:appcompat:1.2.0'
// When appcompat is not used, core and localbroadcastmanager can be used instead
// implementation "androidx.core:core:1.3.1"
// implementation "androidx.localbroadcastmanager:localbroadcastmanager:1.0.0"Agregar hardwareAccelerated para Android (Unity 2018.1 y versiones anteriores)
hardwareAccelerated es necesario para que el SDK de Vungle muestre correctamente los anuncios MREC. Unity obliga a que esta propiedad sea false, incluso si está configurada en true en AndroidManifest.xml dentro de su proyecto de Unity. El complemento de Vungle la configurará a true usando el script de posprocesador de Gradle, que está disponible para 2018.2 y versiones posteriores. Para editores que utilizan 2018.1 y versiones anteriores, incluido 2017, deben exportar el proyecto a Android Studio y agregar la configuración hardwareAccelerated con un valor de true.
Código de muestra:
<application android:hardwareAccelerated="true" ...>Configuración para el proyecto de la plataforma Universal Windows
Siga las instrucciones de nuestro artículo Preparar el complemento Unity del SDK de Vungle para Windows para configurar un proyecto de UWP.
Paso 2. Agregue el código
En este tutorial, inicializamos todo nuestro código relacionado con Vungle en un script adjunto al Game Object principal. Puede invocar el complemento Unity de Vungle desde cualquier script que considere apropiado.
Inicialice el SDK
Inicialice el SDK en cuanto inicie la aplicación, de modo que el SDK tenga tiempo suficiente para almacenar un anuncio en caché. Para inicializar el SDK, necesitará las id. de las aplicaciones para las plataformas que desea admitir. Puede encontrar estas id. en el panel de control de Vungle (consulte “Configurar y generar informes de las ubicaciones”).
Se crea una ubicación predeterminada para cada aplicación de forma automática. Debe proporcionar su id. de ubicación en este paso de inicialización, independientemente de si planea usar o no la funcionalidad de ubicaciones. Si crea varias ubicaciones, proporcione todas las id. de ubicación.
Código de muestra:
public class VungleScript : MonoBehaviour {
string appID = "";
string iosAppID = "ios_app_id";
string androidAppID = "android_app_id";
string windowsAppID = "windows_app_id";
#if UNITY_IPHONE
appID = iosAppID;
#elif UNITY_ANDROID
appID = androidAppID;
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
appID = windowsAppID;
#endif
Vungle.init(appID);
}Luego de que el SDK se inicializa correctamente, invoca el siguiente evento:
public static event Action onInitializeEvent;Consulte la sección sobre el manejo de eventos de un artículo de formato de anuncios que elija.
Póngase en contacto con su administrador de cuentas sobre las ubicaciones optimizadas de caché para maximizar el rendimiento del almacenamiento en caché.
Una vez que un anuncio se almacena en caché con éxito, se invoca el evento adPlayableEvent con la id. de referencia de ubicación que coincide con su ubicación. Consulte el artículo de formato de anuncios que elija para obtener más información.
Integre formatos de anuncios
Complete la integración de su complemento para cada formato de anuncio que planee mostrar en su aplicación. Consulte las instrucciones para cada formato de anuncio:
Personalice aún más sus anuncios
Siga las instrucciones en nuestro artículo Configuración avanzada para ajustar la integración de su aplicación con opciones de configuración adicionales, como GDPR, implementación de CCPA y muchas otras configuraciones.