Intégrer le SDK Vungle pour Unity

John Mai

12 novembre 2024 11:10

Avant de commencer

Configuration nécessaire

Le plugin Vungle Unity prend en charge l'éditeur Unity versions 2017 et ultérieures, et contient les versions suivantes du SDK Vungle.

SDK iOS v6.8.0

iOS 9 ou version ultérieure

SDK Android v6.8.0

Android 4.0 (Ice Cream Sandwich - API version 14 ou ultérieure)
Amazon OS 5.4 ou version ultérieure
Requiert Java 1.7 ou version ultérieure pour Android

Windows SDK v6.8.0

Windows 10 UWP et Universal 8.1

Télécharger le plugin

Téléchargez le plugin Vungle pour Unity ici : https://publisher.vungle.com/sdk/plugins/unity

Référence : exemple d'application

Reportez-vous à l'exemple d'application fourni en tant qu'intégration : https://github.com/Vungle/Unity-Plugin

Étape 1. Configurer votre projet Unity avec le plugin Vungle Unity

Ajouter le plugin Vungle Unity à votre projet Unity

Ouvrez votre projet dans Unity, cliquez deux fois sur le fichier téléchargé VunglePlugin.unitypackage pour ajouter le plugin Vungle Unity à votre application. Lorsque la fenêtre Importer le package Unity s'ouvre, cliquez sur Tout pour tout sélectionner avant l'importation.

Cibler la plateforme correcte dans vos paramètres de build

Pour éviter des erreurs de compilation à l'étape suivante, veillez à ce que les paramètres de build (cmd + Maj + B) de votre projet ciblent la plateforme iOS, Android ou Universal Windows.

Appstore Amazon

Le SDK Vungle Android prend en charge Amazon OS 5.4 et versions ultérieures. Vous pouvez soumettre l'APK Android à l'Appstore Amazon, avec l'installation supplémentaire de la configuration Unity Amazon Appstore. Reportez-vous aux instructions de Unity.

Services Google Play

L'intégration des services Google Play dans votre projet permet à Vungle d'offrir une expérience publicitaire personnalisée à l'utilisateur final, mais ce n'est pas obligatoire. Nous recommandons l'utilisation de la version 16.0.0 ou d'une version ultérieure.

Pour inclure les services Google Play, nous recommandons le guide d'installation Google dans le portail des développeurs. Dans votre application, assurez-vous que l'appareil dispose d'une version suffisamment mise à jour des services Google Play.

Dépendances Android

Le SDK Vungle pour Android exige que vous incluiez une des dépendances suivantes dans votre build. Vous pouvez les ajouter manuellement ou les inclure dans un modèle Gradle si vous utilisez 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"

Ajouter `hardwareAccelerated` pour Android (Unity 2018.1 et versions antérieures)

hardwareAccelerated est nécessaire pour que le SDK Vungle affiche correctement les publicités MREC. Unity force cette propriété à être false même si elle est définie sur true dans AndroidManifest.xml à l'intérieur de votre projet Unity. Le plugin Vungle la définira sur true en utilisant le script de post-processeur Gradle, qui est disponible pour 2018.2 et les versions ultérieures. Pour les éditeurs utilisant 2018.1 et les versions antérieures, y compris 2017, il faut exporter le projet vers Android Studio et ajouter la configuration hardwareAccelerated avec une valeur true.

Exemple de code :

<application android:hardwareAccelerated="true" ...>

Configuration de projet pour la plateforme Universal Windows

Suivez les instructions de notre article Préparer le plugin Vungle Unity pour le SDK Windows pour configurer un projet UWP.

Étape 2. Ajouter le code

Dans ce guide, nous initialisons tout notre code lié à Vungle dans un script lié au principal objet de jeu. Vous pouvez appeler le plugin Vungle Unity à partir de n'importe quel script que vous jugez approprié.

Initialiser le SDK

Initialisez le SDK dès que l'application démarre afin de lui donner suffisamment de temps pour mettre en cache une publicité. Pour initialiser le SDK, vous aurez besoin des ID d'application pour les plateformes que vous souhaitez prendre en charge. Vous trouverez les ID susmentionnés dans le tableau de bord de Vungle (reportez-vous à la section Définition et rapport sur les placements).

Un placement par défaut est créé automatiquement pour chaque application. Vous devez fournir l'ID du placement lors de l'étape d'initialisation que vous envisagiez ou non de profiter de ses fonctions. Si vous créez plusieurs placements, fournissez tous les ID de placement.

Exemple de code :

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);
}

Lorsque le SDK est initialisé avec succès, il appelle l'événement suivant :

public static event Action onInitializeEvent;

Reportez-vous à la section Gestion de l'événement d'un article du format publicitaire de votre choix.

Contactez le responsable de votre compte pour en savoir plus sur les placements optimisés en cache visant à maximiser les performances de la mise en cache.

Une fois la publicité mise en cache avec succès, l'événement adPlayableEvent est appelé avec l'ID de référence du placement correspondant à votre placement. Reportez-vous à l'article du format publicitaire de votre choix pour plus d'informations.

Intégrer les formats publicitaires

Complétez votre plugin d'intégration pour chaque format publicitaire que vous prévoyez d'afficher dans votre application. Consultez nos instructions pour chaque format publicitaire :

Personnalisez davantage vos publicités

Suivez les instructions de notre article sur les paramètres avancés pour affiner l'intégration de votre application avec des options de configuration supplémentaires, telles que le RGPD, la mise en œuvre du CCPA et de nombreux autres paramètres.