Integrar el SDK de Vungle para Android o Amazon

David Kim

28 de enero de 2025 18:27

Antes de empezar

El SDK de Vungle se ha creado y probado hasta la versión 30 de API, Android 11.

Requisitos

La integración requiere una cuenta de Vungle, así que cree una cuenta de Vungle si aún no lo ha hecho y cree una nueva aplicación de Android o Amazon en su cuenta. Consulte la sección Agregar sus aplicaciones y ubicaciones de nuestro artículo Uso del panel de control del editor para aprender cómo configurar ubicaciones en el panel de control de Vungle.
Android 4.0 (Ice Cream Sandwich: versión 14 o superior de API)
Amazon OS 5.4 o superior
Su plataforma debe ser AndroidX en Android SDK 6.5.1 o superior

Descargar el SDK

Descargue el SDK de Vungle para Android o Amazon: https://publisher.vungle.com/sdk/sdks/android

Referencia: aplicación de muestra y documento de Java

Aplicación de muestra: consulte la aplicación de muestra que le proporcionamos a medida que realiza la integración: https://github.com/Vungle/Android-SDK

Documento de Java: https://vungle.github.io/vungle-android-sdk/javadoc

Paso 1. Incluya el SDK de Vungle en su proyecto

Puede integrar el SDK de Vungle como una dependencia de Gradle o manualmente mediante una integración JAR o AAR.

// API version compatibility
minSdkVersion 14
compileSdkVersion 30
targetSdkVersion 30

Gradle

Abra el archivo build.gradle a nivel del proyecto y asegúrese de que los detalles de JCenter sean los que se muestran aquí:

allprojects {
  repositories {
    jcenter()
  }
}

Abra el archivo build.gradle a nivel de la aplicación para su aplicación y agregue las dependencias de compilación en la sección dependencies.

buildscript {
  repositories {
    jcenter()
  }
}

dependencies { 
  // Vungle SDK
  implementation 'com.vungle:publisher-sdk-android:6.9.1'
 
  implementation 'androidx.core:core:1.3.2'
  implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.0.0'

  // When appcompat is being used, core and localbroadcastmanager are the dependencies
  // that is getting included
  // implementation 'androidx.appcompat:appcompat:1.2.0'

  // Recommended for SDK to be able to get Android Advertising ID
  implementation 'com.google.android.gms:play-services-basement:17.5.0'
  implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
}

JAR

Download the Vungle SDK and unzip it. From the libs folder, copy all the .jar files, and add them to your project libs folder:
- vungle-android-sdk-6.9.1.jar
- gson-2.8.6.jar
- okhttp-3.12.12.jar
- okio-1.15.0.jar

Abra el archivo build.gradle a nivel de la aplicación para su aplicación y agregue otras dependencias en la sección dependencies.

dependencies {
  // Vungle SDK
  implementation files('libs/vungle-android-sdk-6.9.1.jar')

  // Required Third-party Dependencies
  implementation files('libs/gson-2.8.6.jar')
  implementation files('libs/okhttp-3.12.12.jar')
  implementation files('libs/okio-1.15.0.jar')

  implementation 'androidx.core:core:1.3.2'
  implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.0.0'

  // When appcompat is being used, core and localbroadcastmanager are the dependencies
  // that is getting included
  // implementation 'androidx.appcompat:appcompat:1.2.0'

  // Recommended for SDK to be able to get Android Advertising ID
  implementation 'com.google.android.gms:play-services-basement:17.5.0'
  implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
}

Actualice su AndroidManifest.xml agregando las siguientes líneas y asignando el nombre del elemento de la aplicación al nombre de la clase de su aplicación:

<uses-sdk
    android:minSdkVersion="14"
    android:targetSdkVersion="30" />

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18" />

<application
    android:fullBackupContent="@xml/vungle_backup_rule"
    android:hardwareAccelerated="true"
    android:supportsRtl="true" >
    <activity
        android:name="com.vungle.warren.ui.VungleActivity"
        android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize|uiMode"
        android:launchMode="singleTop"
        android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />

    <receiver
        android:name="com.vungle.warren.NetworkProviderReceiver"
        android:enabled="false" >
        <intent-filter>
            <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
            <category android:name="android.intent.category.DEFAULT" />
        </intent-filter>
    </receiver>

    <provider
        android:name="com.vungle.warren.utility.VungleProvider"
        android:authorities="${applicationId}.vungle-provider"
        android:exported="false" />
</application>

Incluya reglas de exclusión de Vungle para permitir fullBackupContent.

AAR

Download the Vungle SDK and unzip it. From the libs folder, copy SDK .aar and all .jar dependencies, and add them to your project libs folder:
- vungle-android-sdk-6.9.1.aar
- gson-2.8.6.jar
- okhttp-3.12.2.jar
- okio-1.15.0.jar

Abra el archivo build.gradle a nivel de la aplicación para su aplicación y agregue otras dependencias en la sección dependencies.

dependencies {
  // Vungle SDK
  implementation files('libs/vungle-android-sdk-6.9.1.aar')

  // Required Third-party Dependencies
  implementation files('libs/gson-2.8.6.jar')
  implementation files('libs/okhttp-3.12.12.jar')
  implementation files('libs/okio-1.15.0.jar')

  implementation 'androidx.core:core:1.3.2'
  implementation 'androidx.localbroadcastmanager:localbroadcastmanager:1.0.0'

  // When appcompat is being used, core and localbroadcastmanager are the dependencies
  // that is getting included
  // implementation 'androidx.appcompat:appcompat:1.2.0'

  // Recommended for SDK to be able to get Android Advertising ID
  implementation 'com.google.android.gms:play-services-basement:17.5.0'
  implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
}

Paso 2. Importe el SDK de Vungle

import com.vungle.warren.Vungle;
import com.vungle.warren.AdConfig;              // Custom ad configurations
import com.vungle.warren.InitCallback;          // Initialization callback
import com.vungle.warren.LoadAdCallback;        // Load ad callback
import com.vungle.warren.PlayAdCallback;        // Play ad callback
import com.vungle.warren.VungleNativeAd;        // MREC ad
import com.vungle.warren.Banners;               // Banner ad
import com.vungle.warren.VungleBanner;          // Banner ad
import com.vungle.warren.Vungle.Consent;        // GDPR consent
import com.vungle.warren.VungleSettings         // Minimum disk space
import com.vungle.warren.error.VungleException  // onError message

Paso 3. Agregue el código

Inicialice el SDK

public static void init(@NonNull final String appId,
                        @NonNull final Context context,
                        @NonNull final InitCallback callback)

public static void init(@NonNull final String appId,
                        @NonNull final Context context,
                        @NonNull final InitCallback callback,
                        @NonNull final VungleSettings settings)

El método de inicialización toma los siguientes parámetros:

Id. de la aplicación de Vungle
Contexto de la aplicación
InitCallback
- onSuccess: envía una notificación cuando el SDK se ha inicializado correctamente
- onError: envía una notificación cuando la inicialización ha fallado
  - Ejecuta IllegalArgumentException si InitCallback es nulo.
- onAutoCacheAdAvailable: envía una notificación cuando la ubicación de caché automático tiene un anuncio disponible para reproducir
VungleSettings (opcional)
- Espacio mínimo en disco: configure el espacio mínimo disponible en el dispositivo para la inicialización y operación del SDK
- Restringir Id. de Android: configure la restricción del uso de ID del dispositivo Android

Vungle.init(appId, getApplicationContext(), new InitCallback() {
  @Override
  public void onSuccess() {
    // SDK has successfully initialized
  }

  @Override
  public void onError(VungleException exception) {
    // SDK has failed to initialize
  }

  @Override
  public void onAutoCacheAdAvailable(String placementId) {
    // Ad has become available to play for a cache optimized placement
  }
};

// 6.4.x & below
Vungle.init(appId, getApplicationContext(), new InitCallback() {
  @Override
  public void onSuccess() {
    // SDK has successfully initialized
  }

  @Override
  public void onError(Throwable throwable) {
    // SDK has failed to initialize
  }

  @Override
  public void onAutoCacheAdAvailable(String placementId) {
    // Ad has become available to play for a cache optimized placement
  }
};

Métodos de anulación	Descripción
`onSuccess()`	Se ejecuta cuando el SDK se ha ejecutado correctamente y está listo para cargar un anuncio o reproducir alguno disponible
`onError(VungleException exception)`	Se ejecuta cuando se produce un error al intentar inicializar el SDK. Podrá consultar el mensaje de error desde `getLocalizedMessage` de `VungleException` y utilizar `getExceptionCode` para la depuración.
`onAutoCacheAdAvailable(String placementId)`	Se ejecuta cuando un anuncio está disponible para reproducirse en ubicaciones optimizadas de caché. Se espera que el editor emita explícitamente `loadAd` para ubicaciones optimizadas de caché como se describe en Cargar un anuncio para una ubicación.

Puede verificar si el SDK de Vungle se ha ejecutado en cualquier momento a través del método isInitialized:

public static boolean isInitialized()

Integrar formatos de anuncios

Complete la integración de su SDK 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 del artículo Configuración avanzada para ajustar la integración de la aplicación con opciones de configuración adicionales, como GDPR e implementación de CCPA, entre muchas otras.