Integrar el SDK de Vungle para Android o Amazon

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.8.0'
 
  implementation 'androidx.core:core:1.3.1'
  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.4.0'
  implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
}

JAR

  1. Descargue el SDK de Vungle v. 6.8.0 y descomprímalo. Desde la carpeta libs, copie todos los archivos .jar y agréguelos a la carpeta libs de su proyecto:
    • vungle-android-sdk-6.8.0.jar
    • gson-2.8.6.jar
    • okhttp-3.12.12.jar
    • okio-1.15.0.jar
    • androidx-vng-moat-mobile-app-kit-2.6.3.jar
  2. 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.8.0.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 files('libs/androidx-vng-moat-mobile-app-kit-2.6.3.jar')
    
      implementation 'androidx.core:core:1.3.1'
      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.4.0'
      implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
    }
  3. 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"
        tools:overrideLibrary="com.moat.analytics.mobile.vng" />
    
    <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>
  4. Incluya reglas de exclusión de Vungle para permitir fullBackupContent.

AAR

  1. Descargue el SDK de Vungle v. 6.8.0 y descomprímalo. Desde la carpeta libs, copie el SDK .aar y todas las dependencias .jar y agréguelos a la carpeta libs de su proyecto:
    • vungle-android-sdk-6.8.0.aar
    • gson-2.8.6.jar
    • okhttp-3.12.2.jar
    • okio-1.15.0.jar
  2. 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.8.0.aar')
    
      // Required Third-party Dependencies
      implementation files('libs/gson-2.86.jar')
      implementation files('libs/okhttp-3.12.12.jar')
      implementation files('libs/okio-1.15.0.jar')
    
      implementation 'androidx.core:core:1.31'
      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.3.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

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

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)
6.5.0 y superior Versiones heredadas
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
  }
};
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.

 

Powered by Creativity Driven by Performance Sign Up Here

Questions?

Need further assistance, feel free to reach out to us, we’re here to help!

¿Fue útil este artículo?