Intégrer la monétisation Liftoff à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces de Liftoff Monetize à l'aide de la médiation, en couvrant à la fois les enchères et les intégrations en cascade. Il explique comment ajouter Liftoff Monetize à la configuration de médiation d'un bloc d'annonces et comment intégrer le SDK et l'adaptateur Vungle dans une application Android.

Intégrations et formats d'annonces compatibles

L'adaptateur de médiation pour Liftoff Monetize offre les fonctionnalités suivantes:

¹ L'intégration des enchères est en version bêta ouverte.

L'intégration de la cascade de ² pour ce format est disponible en version bêta ouverte.

Conditions requises

• Niveau d'API Android 21 ou supérieur

• Dernière version du SDK Google Mobile Ads

• Suivez le guide de démarrage de la médiation.

Étape 1: Configurer les configurations dans l'interface utilisateur de Liftoff Monetize

Inscrivez-vous ou connectez-vous à votre compte Liftoff Monetize.

Ajoutez votre application au tableau de bord de monétisation Liftoff en cliquant sur le bouton Ajouter une application.

Remplissez le formulaire en indiquant toutes les informations nécessaires.

Une fois votre application créée, sélectionnez-la dans le tableau de bord des applications Liftoff Monetize.

Notez l'ID de l'application.

Ajouter des emplacements

Pour créer un emplacement à utiliser avec la médiation Ad Manager, accédez au tableau de bord "Placer des annonces sur Liftoff", cliquez sur le bouton Ajouter un emplacement, puis sélectionnez votre application dans le menu déroulant.

Vous trouverez ci-dessous des informations sur l'ajout d'emplacements:

Notez l'ID de référence, puis cliquez sur OK.

Trouver votre clé API Reporting

Activer le mode test

Pour activer les annonces tests, accédez au tableau de bord de monétisation Liftoff, puis accédez à Applications.

Sélectionnez l'application pour laquelle vous souhaitez activer les annonces tests dans la section ID de référence de l'emplacement. Pour activer les annonces tests, sélectionnez Mode Test et Afficher uniquement les annonces tests dans la section État.

Étape 2: Configurer la demande Liftoff Monetize dans l'interface utilisateur d'Ad Manager

Connectez-vous à votre compte Ad Manager.

Ajouter Liftoff Monetize dans les entreprises

Activer le partage des signaux sécurisés

Configurer les enchères Liftoff Monetize

Configurer la mise en correspondance des blocs d'annonces

Ajout de Liftoff à la liste des partenaires publicitaires conformes au RGPD et aux réglementations des États américains

Suivez la procédure décrite dans les sections Paramètres du RGPD et Paramètres des réglementations des États américains pour ajouter Liftoff à la liste des partenaires publicitaires conformes au RGPD et aux réglementations des États américains dans l'interface utilisateur d'Ad Manager.

Étape 3: Importer le SDK et l'adaptateur Vungle

Intégration d'Android Studio (recommandée)

Dans le fichier build.gradle.kts au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes. Utilisez les dernières versions du SDK et de l'adaptateur Vungle:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:vungle:7.4.2.0")
}

Intégration manuelle

• Téléchargez le dernier SDK Android Vungle, puis extrayez les fichiers .jar dans le dossier libs et ajoutez-les à votre projet.

• Accédez aux artefacts de l'adaptateur Liftoff Monetize dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier .aar de l'adaptateur Vungle et ajoutez-le à votre projet.

Étape 4: Implémenter les paramètres de confidentialité sur le SDK Liftoff Monetize

Consentement des utilisateurs de l'UE et RGPD

Conformément aux Règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez vous assurer que certaines informations sont communiquées aux utilisateurs de l'Espace économique européen (EEE) et que leur consentement est obtenu concernant l'utilisation des identifiants d'appareil et des données à caractère personnel. Ces règles reflètent les exigences de la directive vie privée et communications électroniques de l'UE, et celles du Règlement général sur la protection des données (RGPD). Lorsque vous demandez le consentement, vous devez identifier chaque réseau publicitaire de votre chaîne de médiation susceptible de collecter, de recevoir ou d'utiliser des données à caractère personnel, et fournir des informations sur l'utilisation de chaque réseau. Google ne peut actuellement pas transmettre automatiquement le choix de l'utilisateur à ces réseaux.

Liftoff Monetize inclut une API qui vous permet de transmettre le consentement au SDK Vungle. L'exemple de code suivant montre comment transmettre ces informations d'autorisation au SDK Vungle. Si vous choisissez d'appeler cette méthode, nous vous recommandons de le faire avant de demander des annonces via le SDK Google Mobile Ads.

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

Pour en savoir plus et connaître les valeurs pouvant être fournies dans la méthode, consultez les instructions d'implémentation recommandées pour le RGPD.

Lois sur la confidentialité dans les États américains

Les lois sur la confidentialité dans les États américains exigent d'offrir aux utilisateurs le droit de s'opposer à la "vente" de leurs "informations personnelles" (selon la définition de ces termes par la loi). Cette possibilité doit être proposée via un lien bien visible indiquant "Do Not Sell My Personal Information" (Ne pas vendre mes informations personnelles) et figurant sur la page d'accueil de la partie "vendeuse". Le guide de conformité aux lois sur la confidentialité dans les États américains permet d'activer le traitement restreint des données pour la diffusion d'annonces Google, mais Google ne peut pas appliquer ce paramètre à chaque réseau publicitaire de votre chaîne de médiation. Par conséquent, vous devez identifier chaque réseau publicitaire de votre chaîne de médiation susceptible de participer à la vente d'informations personnelles et suivre les conseils de chacun de ces réseaux pour vous assurer de la conformité.

Liftoff Monetize inclut une API qui vous permet de transmettre le consentement au SDK Vungle. L'exemple de code suivant montre comment transmettre ces informations d'autorisation au SDK Vungle. Si vous choisissez d'appeler cette méthode, nous vous recommandons de le faire avant de demander des annonces via le SDK Google Mobile Ads.

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

Pour en savoir plus et connaître les valeurs pouvant être fournies dans la méthode, consultez la section Implémentation du CCPA.

Étape 5: Ajoutez le code requis

Aucun code supplémentaire n'est requis pour l'intégration de Liftoff Monetize.

Étape 6: Tester votre implémentation

Activer les annonces tests

Assurez-vous d'enregistrer votre appareil de test pour Ad Manager et d'activer le mode test dans l'interface utilisateur de Liftoff Monetize.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests de la part de Liftoff Monetize, activez le test d'une source d'annonces spécifique dans l'inspecteur d'annonces à l'aide des sources d'annonces Liftoff Monetize (enchères) et Liftoff Monetize (cascade).

Étapes facultatives

Paramètres spécifiques au réseau

L'adaptateur Liftoff Monetize accepte les paramètres de requête supplémentaires suivants, qui peuvent être transmis à l'adaptateur:

userId

Chaîne représentant l'ID utilisateur incité de Liftoff Monetize.

adOrientation

Entier spécifiant l'orientation de présentation des annonces en plein écran.

Voici un exemple de code montrant comment créer une requête d'annonce qui définit ces paramètres:

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

Affichage des annonces natives

L'adaptateur Liftoff Monetize renvoie ses annonces natives en tant qu'objets NativeAd. Il renseigne les champs suivants pour un NativeAd.

¹ L'adaptateur Liftoff Monetize ne fournit pas d'accès direct à l'élément image principal pour ses annonces natives. À la place, l'adaptateur renseigne MediaView avec une vidéo ou une image.

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir une annonce de Liftoff Monetize, les éditeurs peuvent vérifier l'erreur sous-jacente de la réponse de l'annonce à l'aide de ResponseInfo.getAdapterResponses() dans les classes suivantes:

Voici les codes et les messages associés générés par l'adaptateur Liftoff Monetize lorsqu'une annonce ne parvient pas à se charger:

Pour les erreurs provenant du SDK Vungle, consultez Codes d'erreur: SDK Vungle pour iOS et Android.

Journal des modifications de l'adaptateur de médiation Android Liftoff Monetize

Version 7.4.2.0

• Compatibilité vérifiée avec le SDK Vungle 7.4.2.

Compilé et testé avec:

• SDK Google Mobile Ads 23.5.0
• Version du SDK Vungle 7.4.2.

Version 7.4.1.0

• Compatibilité vérifiée avec le SDK Vungle 7.4.1.

Compilé et testé avec:

• SDK Google Mobile Ads 23.3.0
• Version du SDK Vungle 7.4.1.

Version 7.4.0.1

• Ajout de la compatibilité avec les tailles d'annonces personnalisées pour les enchères et les bannières en cascade.

Compilé et testé avec:

• SDK Google Mobile Ads 23.2.0
• Version du SDK Vungle 7.4.0.

Version 7.4.0.0

• Extension de la classe VungleInterstitialAdapter à partir de VungleMediationAdapter pour ajouter la prise en charge de la cascade d'annonces pour le format d'annonce à l'ouverture de l'application dans Google Ad Manager.
• Compatibilité vérifiée avec le SDK Vungle 7.4.0.

Compilé et testé avec:

• SDK Google Mobile Ads 23.2.0
• Version du SDK Vungle 7.4.0.

Version 7.3.2.0

• Compatibilité vérifiée avec le SDK Vungle 7.3.2.

Compilé et testé avec:

• SDK Google Mobile Ads version 23.0.0
• Version du SDK Vungle 7.3.2.

Version 7.3.1.0

• Compatibilité vérifiée avec le SDK Vungle 7.3.1.

Compilé et testé avec:

• SDK Google Mobile Ads version 23.0.0
• Version du SDK Vungle 7.3.1.

Version 7.3.0.0

• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 23.0.0.
• Compatibilité vérifiée avec le SDK Vungle 7.3.0.
• Ajout de la prise en charge des cascades d'annonces et des enchères pour le format d'annonce à l'ouverture de l'application.

Compilé et testé avec:

• SDK Google Mobile Ads version 23.0.0
• Version du SDK Vungle 7.3.0.

Version 7.1.0.0

• Compatibilité vérifiée avec le SDK Vungle 7.1.0.

Compilé et testé avec:

• SDK Google Mobile Ads 22.3.0
• Version du SDK Vungle 7.1.0.

Version 7.0.0.1

• Correction d'un problème qui empêchait le SDK Google Mobile Ads d'enregistrer les impressions pour les enchères sur les annonces natives.
• L'adaptateur a été rétabli pour dépendre de la version 22.3.0 du SDK Google Mobile Ads.

Compilé et testé avec:

• SDK Google Mobile Ads 22.3.0
• Version du SDK Vungle 7.0.0.

Version 7.0.0.0

• Ajout de la possibilité de charger plusieurs annonces avec le même ID d'emplacement pour tous les formats d'annonces en cascade.
• Modification du nom de l'adaptateur Vungle en Liftoff Monetize.
• Compatibilité vérifiée avec le SDK Vungle 7.0.0.

Compilé et testé avec:

• SDK Google Mobile Ads 22.4.0
• Version du SDK Vungle 7.0.0.

Version 6.12.1.1

• Mise à jour de l'adaptateur pour qu'il utilise la nouvelle classe VersionInfo.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 22.0.0.

Compilé et testé avec:

• SDK Google Mobile Ads version 22.0.0
• Version du SDK Vungle : 6.12.1.

Version 6.12.1.0

• Compatibilité vérifiée avec le SDK Vungle 6.12.1.

Compilé et testé avec:

• SDK Google Mobile Ads 21.4.0
• Version du SDK Vungle : 6.12.1.

Version 6.12.0.1

• Ajout de la prise en charge des enchères pour le format d'annonce bannière.
• Compatibilité vérifiée avec le SDK Vungle 6.12.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 21.4.0.

Compilé et testé avec:

• SDK Google Mobile Ads 21.4.0
• Version du SDK Vungle 6.12.0.

Version 6.12.0.0

• Ajout de la prise en charge de la médiation et des enchères en cascade pour le format d'annonce interstitielle avec récompense.
• Ajout de la prise en charge des enchères pour le format d'annonce native.

Compilé et testé avec:

• SDK Google Mobile Ads version 21.1.0
• Version du SDK Vungle 6.12.0.

Version 6.11.0.3

• Ajout de la compatibilité avec la médiation en cascade pour le format d'annonce native.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 21.1.0.

Compilé et testé avec:

• SDK Google Mobile Ads version 21.1.0
• Version du SDK Vungle 6.11.0.

Version 6.11.0.2

• Ajout de la possibilité de charger plusieurs annonces pour le même ID d'emplacement dans les annonces avec enchères avec récompense.

Compilé et testé avec:

• SDK Google Mobile Ads version 21.0.0
• Version du SDK Vungle 6.11.0.

Version 6.11.0.1

• Mise à jour de compileSdkVersion et targetSdkVersion vers l'API 31.
• La version minimale requise du SDK Google Mobile Ads est désormais la 21.0.0.
• Mise à jour du niveau d'API Android minimal requis vers la version 19.

Compilé et testé avec:

• SDK Google Mobile Ads version 21.0.0
• Version du SDK Vungle 6.11.0.

Version 6.11.0.0

• Compatibilité vérifiée avec le SDK Vungle 6.11.0.

Compilé et testé avec:

• SDK Google Mobile Ads 20.6.0
• Version du SDK Vungle 6.11.0.

Version 6.10.5.0

• Compatibilité vérifiée avec le SDK Vungle 6.10.5.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.6.0.

Compilé et testé avec:

• SDK Google Mobile Ads 20.6.0
• Version du SDK Vungle : 6.10.5.

Version 6.10.4.0

• Compatibilité vérifiée avec le SDK Vungle 6.10.4.

Compilé et testé avec:

• Version 20.5.0 du SDK Google Mobile Ads
• Version du SDK Vungle : 6.10.4.

Version 6.10.3.0

• Compatibilité vérifiée avec le SDK Vungle 6.10.3.

Compilé et testé avec:

• Version 20.5.0 du SDK Google Mobile Ads
• Version du SDK Vungle : 6.10.3.

Version 6.10.2.1

• Compatibilité vérifiée avec le SDK Vungle 6.10.2.
• Ajout de la prise en charge des enchères pour les formats d'annonces interstitielles et avec récompense.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.5.0.

Compilé et testé avec:

• Version 20.5.0 du SDK Google Mobile Ads
• Version du SDK Vungle : 6.10.2

Version 6.10.2.0

• Compatibilité vérifiée avec le SDK Vungle 6.10.2.
• Correction d'un problème d'adaptateur en remplaçant le paramètre serverParameters par mediationExtras pour obtenir des paramètres spécifiques au réseau Vungle lors de la demande d'annonces bannières et interstitielles.

Compilé et testé avec:

• SDK Google Mobile Ads 20.3.0
• Version du SDK Vungle : 6.10.2

Version 6.10.1.0

• Compatibilité vérifiée avec le SDK Vungle 6.10.1.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.3.0.
• Les annonces MREC sont désormais compatibles avec l'API des bannières de Vungle.
• Mise à jour des codes et des messages d'erreur standardisés.

Compilé et testé avec:

• SDK Google Mobile Ads 20.3.0
• Version du SDK Vungle 6.10.1.

Version 6.9.1.1

• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.0.0.

Compilé et testé avec:

• Version 20.0.0 du SDK Google Mobile Ads
• Version du SDK Vungle 6.9.1.

Version 6.9.1.0

• Compatibilité vérifiée avec le SDK Vungle 6.9.1.
• Ajout de la prise en charge d'OMSDK.
• Correction de plusieurs bugs.
• Compatibilité avec les annonces avec récompense pour le rappel onAdViewed de Vungle.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.7.0.

Compilé et testé avec:

• SDK Google Mobile Ads 19.7.0
• Version du SDK Vungle 6.9.1.

Version 6.8.1.1

• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.6.0.

Compilé et testé avec:

• SDK Google Mobile Ads 19.6.0
• Version du SDK Vungle 6.8.1

Version 6.8.1.0

• Compatibilité vérifiée avec le SDK Vungle 6.8.1.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.5.0.

Compilé et testé avec:

• SDK Google Mobile Ads 19.5.0
• Version du SDK Vungle 6.8.1

Version 6.8.0.0

• Compatibilité vérifiée avec le SDK Vungle 6.8.0.
• Modification de l'adaptateur pour qu'il ne transfère pas onAdClosed() lorsque les bannières publicitaires sont actualisées ou détruites.
• Suppression de FlexFeed et FlexView (obsolètes dans Vungle 6.8.0).
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.4.0.

Compilé et testé avec:

• SDK Google Mobile Ads 19.4.0
• Version du SDK Vungle 6.8.0.

Version 6.7.1.0

• Compatibilité vérifiée avec le SDK Vungle 6.7.1.
• Correction d'un bug qui empêchait le chargement des annonces si une annonce était chargée à l'aide d'un contexte d'application.
• Mise à jour de targetSdkVersion vers l'API 29.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.3.0.

Compilé et testé avec:

• SDK Google Mobile Ads 19.3.0
• Version du SDK Vungle 6.7.1.

Version 6.7.0.0

• Compatibilité vérifiée avec le SDK Vungle 6.7.0.
• Mise à jour de l'adaptateur pour prendre en charge les requêtes de bannières adaptatives intégrées.
• Les annonces interstitielles et avec récompense ne sont plus coupées par défaut.
• Les annonces interstitielles transfèrent désormais le rappel onAdLeftApplication() lorsqu'elles sont cliquées.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.2.0.

Compilé et testé avec:

• SDK Google Mobile Ads 19.2.0
• Version du SDK Vungle 6.7.0.

Version 6.5.3.0

• Compatibilité vérifiée avec le SDK Vungle 6.5.3.
• Prise en charge du nouveau format de bannière de Vungle.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.0.1.

Compilé et testé avec:

• SDK Google Mobile Ads 19.0.1
• Version du SDK Vungle : 6.5.3

Version 6.4.11.1

• Correction d'un problème qui empêchait l'actualisation des bannières publicitaires.

Version 6.4.11.0

• Compatibilité vérifiée avec le SDK Vungle 6.4.11.
• Ajout de la compatibilité avec les bannières publicitaires.
• Migration de l'adaptateur vers AndroidX.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 18.2.0.

Version 6.3.24.1

• Mise à jour de l'adaptateur pour prendre en charge la nouvelle API Rewarded en version bêta ouverte.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 17.2.0.

Version 6.3.24.0

• Compatibilité vérifiée avec le SDK Vungle 6.3.24.

Version 6.3.17.0

• Compatibilité vérifiée avec le SDK Vungle 6.3.17.

Version 6.3.12.0

• Compatibilité vérifiée avec le SDK Vungle 6.3.12.

Version 6.2.5.1

• Mise à jour de l'adaptateur pour appeler l'événement d'annonce onRewardedVideoComplete().

Version 6.2.5.0

• Compatibilité vérifiée avec le SDK Vungle 6.2.5.

Version 5.3.2.1

• Mise à jour de l'adaptateur pour qu'il signale correctement les clics au SDK Google Mobile Ads.

Version 5.3.2.0

• Compatibilité vérifiée avec le SDK Vungle 5.3.2.
• Mise à jour du projet Adpater pour Android Studio 3.0.
• Ajout des méthodes suivantes à la classe Bundle Builder.
  • setOrdinalViewCount : ce champ permet de transmettre l'ordinal de médiation chaque fois que l'éditeur reçoit les rapports de données ordinales de Vungle.
  • setFlexViewCloseTimeInSec : cette option permet de fermer automatiquement les annonces de la vue flexible après le nombre de secondes spécifié.

Version 5.3.0.0

• Compatibilité vérifiée avec le SDK Vungle 5.3.0.

Version 5.1.0.0

• Mise à jour de l'adaptateur pour le rendre compatible avec le SDK Vungle 5.1.0.
• Modification du système de dénomination des versions pour le remplacer par [Version du SDK Vungle].[Version du correctif de l'adaptateur].

Versions précédentes

• Prise en charge des formats d'annonces vidéo interstitielles et avec récompense.