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 Liftoff Monetize à l'aide de la médiation, en couvrant les intégrations d'enchères et 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 à une application Android.

Intégrations et formats d'annonces acceptés

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

Conditions requises

• Niveau d'API Android 23 ou supérieur

• [Pour les enchères]: Pour intégrer tous les formats d'annonces compatibles dans les enchères, utilisez l'adaptateur Liftoff Monetize 7.3.0.0 ou version ultérieure (dernière version recommandée).

• Dernière version du SDK Google Mobile Ads.

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

Étape 1 : Configurez les configurations dans l'UI Liftoff Monetize

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

Ajoutez votre application au tableau de bord Liftoff Monetize en cliquant sur le bouton Add Application (Ajouter une application).

Remplissez le formulaire en fournissant 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 des emplacements Liftoff Monetize, cliquez sur le bouton Ajouter un emplacement, puis sélectionnez votre application dans la liste déroulante.

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

Mettre à jour votre fichier app-ads.txt

Authorized Sellers for Apps (app-ads.txt) est une initiative de l'IAB Tech Lab qui vous permet de vendre l'inventaire publicitaire de votre application uniquement par l'intermédiaire de canaux de distribution que vous avez identifiés comme étant autorisés. Pour éviter une perte importante de revenus publicitaires, vous devez implémenter un fichier app-ads.txt. Si vous ne l'avez pas encore fait, créez un fichier app-ads.txt pour Ad Manager.

Pour implémenter app-ads.txt pour Liftoff Monetize, téléchargez et ajoutez les entrées app-ads.txt de Liftoff Monetize à votre fichier app-ads.txt existant. Pour en savoir plus, consultez app-ads.txt.

Activer le mode test

Pour activer les annonces tests, accédez à votre tableau de bord Liftoff Monetize, 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 de votre application. Pour activer les annonces tests, sélectionnez Mode Test, puis Afficher uniquement les annonces tests dans la section État.

Étape 2 : Configurez la demande Liftoff Monetize dans l'UI Ad Manager

Connectez-vous à votre compte Ad Manager.

Ajouter Liftoff Monetize dans "Sociétés"

Activer le partage des signaux sécurisés

Partager des signaux sécurisés dans les demandes d'enchères

Autoriser le partage de signaux sécurisés pour les enchères par SDK

Configurer les enchères Liftoff Monetize

Configurer la mise en correspondance des blocs d'annonces

Ajouter Liftoff à la liste des partenaires publicitaires pour le RGPD et les réglementations des États américains

Suivez les étapes décrites dans les sections Paramètres des réglementations européennes et Paramètres des réglementations des États américains pour ajouter Liftoff à la liste des partenaires publicitaires liés aux réglementations européennes et des États américains dans l'UI Ad Manager.

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

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:24.5.0")
    implementation("com.google.ads.mediation:vungle:7.5.1.0")
}

Intégration manuelle

• Téléchargez le dernier SDK Vungle pour Android, puis extrayez les fichiers .aar et JAR du 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 Vungle

Consentement dans l'UE et RGPD

Pour respecter les règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez fournir certaines informations à vos utilisateurs dans l'Espace économique européen (EEE), au Royaume-Uni et en Suisse, et obtenir leur consentement pour l'utilisation de cookies ou d'autres méthodes de stockage local lorsque la loi l'exige, ainsi que pour la collecte, le partage et l'utilisation de données à caractère personnel pour la personnalisation des annonces. 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). Il vous incombe de vérifier que le consentement est transmis à chaque source d'annonces de votre chaîne de médiation. Google ne peut pas transmettre automatiquement le choix de consentement de l'utilisateur à ces réseaux.

À partir de la version 7.4.1 du SDK Vungle, Liftoff Monetize lit automatiquement le consentement RGPD défini par les plates-formes de gestion du consentement compatibles avec la spécification de consentement supplémentaire de Google, y compris le SDK UMP. Pour en savoir plus, consultez les instructions de mise en œuvre recommandées pour le RGPD.

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

Les lois sur la confidentialité des É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 l'entreprise (le "vendeur"). Le guide de conformité aux lois sur la confidentialité des États américains vous 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. Vous devez donc 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 assurer 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 de consentement 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 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 Liftoff Monetize.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests 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 plein écran.

Voici un exemple de code montrant comment créer une demande 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 sous la forme d'objets NativeAd. Il renseigne les champs suivants pour un NativeAd.

¹ L'adaptateur Liftoff Monetize ne fournit pas d'accès direct au composant image principal de ses annonces natives. L'adaptateur remplit plutôt MediaView avec une vidéo ou une image.

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir d'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.5.1.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 24.5.0.
• Version 7.5.1 du SDK Vungle.

Version 7.5.0.1

• Définit overrideImpressionRecording sur "true" pour les annonces natives en cascade et RTB.

Conçu et testé avec :

• SDK Google Mobile Ads version 24.4.0.
• Version 7.5.0 du SDK Vungle.

Version 7.5.0.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 24.2.0.
• Version 7.5.0 du SDK Vungle.

Version 7.4.3.1

• Le niveau d'API Android minimal requis est désormais 23.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 24.0.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 24.0.0.
• Version 7.4.3 du SDK Vungle.

Version 7.4.3.0

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

Conçu et testé avec :

• SDK Google Mobile Ads version 23.6.0.
• Version 7.4.3 du SDK Vungle.

Version 7.4.2.0

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

Conçu et testé avec :

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

Version 7.4.1.0

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

Conçu et testé avec :

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

Version 7.4.0.1

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

Conçu et testé avec :

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

Version 7.4.0.0

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

Conçu et testé avec :

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

Version 7.3.2.0

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

Conçu et testé avec :

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

Version 7.3.1.0

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

Conçu et testé avec :

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

Version 7.3.0.0

• La version minimale requise du SDK Google Mobile Ads est désormais la version 23.0.0.
• Compatibilité vérifiée avec le SDK Vungle 7.3.0.
• Ajout de la compatibilité avec les cascades et les enchères pour le format d'annonce à l'ouverture.

Conçu et testé avec :

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

Version 7.1.0.0

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

Conçu et testé avec :

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

Version 7.0.0.1

• Correction d'un problème qui empêchait le SDK Google Mobile Ads d'enregistrer les impressions pour les annonces natives avec enchères.
• L'adaptateur est revenu à la version 22.3.0 du SDK Google Mobile Ads.

Conçu et testé avec :

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

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.
• Le nom de l'adaptateur Vungle a été remplacé par Liftoff Monetize.
• Compatibilité vérifiée avec le SDK Vungle 7.0.0.

Conçu et testé avec :

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

Version 6.12.1.1

• Adaptateur mis à jour pour utiliser la nouvelle classe VersionInfo.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 22.0.0.

Conçu et testé avec :

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

Version 6.12.1.0

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

Conçu et testé avec :

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

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.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 21.4.0.

Conçu et testé avec :

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

Version 6.12.0.0

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

Conçu et testé avec :

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

Version 6.11.0.3

• Ajout de la prise en charge de la médiation en cascade pour le format d'annonce native.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 21.1.0.

Conçu et testé avec :

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

Version 6.11.0.2

• Ajout de la prise en charge du chargement de plusieurs annonces pour le même ID d'emplacement dans les annonces avec enchères basées sur la récompense.

Conçu et testé avec :

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

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 version 21.0.0.
• Le niveau d'API Android minimal requis est désormais 19.

Conçu et testé avec :

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

Version 6.11.0.0

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

Conçu et testé avec :

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

Version 6.10.5.0

• Compatibilité vérifiée avec le SDK Vungle 6.10.5.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 20.6.0.

Conçu et testé avec :

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

Version 6.10.4.0

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

Conçu et testé avec :

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

Version 6.10.3.0

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

Conçu et testé avec :

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

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.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 20.5.0.

Conçu et testé avec :

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

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 les paramètres spécifiques au réseau Vungle lors de la demande d'annonces bannière et interstitielles.

Conçu et testé avec :

• SDK Google Mobile Ads version 20.3.0.
• Version 6.10.2 du SDK Vungle.

Version 6.10.1.0

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

Conçu et testé avec :

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

Version 6.9.1.1

• La version minimale requise du SDK Google Mobile Ads est désormais la version 20.0.0.

Conçu et testé avec :

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

Version 6.9.1.0

• Compatibilité vérifiée avec le SDK Vungle 6.9.1.
• Ajout de la compatibilité avec OMSDK.
• Correction de plusieurs bugs.
• Compatibilité avec les annonces avec récompense pour le rappel Vungle onAdViewed.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 19.7.0.

Conçu et testé avec :

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

Version 6.8.1.1

• La version minimale requise du SDK Google Mobile Ads est désormais la version 19.6.0.

Conçu et testé avec :

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

Version 6.8.1.0

• Compatibilité vérifiée avec le SDK Vungle 6.8.1.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 19.5.0.

Conçu et testé avec :

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

Version 6.8.0.0

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

Conçu et testé avec :

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

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 elles étaient chargées à l'aide d'un contexte d'application.
• Mise à jour de targetSdkVersion vers l'API 29.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 19.3.0.

Conçu et testé avec :

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

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 demandes de bannières adaptatives intégrées.
• Le son des annonces interstitielles et avec récompense est désormais activé par défaut.
• Les annonces interstitielles transmettent désormais le rappel onAdLeftApplication() lorsqu'un utilisateur clique dessus.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 19.2.0.

Conçu et testé avec :

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

Version 6.5.3.0

• Compatibilité vérifiée avec le SDK Vungle 6.5.3.
• Ajout de la compatibilité avec le nouveau format de bannière de Vungle.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 19.0.1.

Conçu et testé avec :

• SDK Google Mobile Ads version 19.0.1.
• Version 6.5.3 du SDK Vungle.

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.
• L'adaptateur a été migré vers AndroidX.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 18.2.0.

Version 6.3.24.1

• Mise à jour de l'adaptateur pour prendre en charge la nouvelle API Récompenses en version bêta ouverte.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 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

• L'adaptateur a été mis à jour 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

• Adaptateur mis à jour pour signaler 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 Adapter 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 faire disparaître automatiquement les annonces flex view 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

• L'adaptateur a été mis à jour pour être compatible avec le SDK Vungle 5.1.0.
• Le système de dénomination des versions a été modifié pour passer de [version du SDK Vungle].[version du correctif de l'adaptateur].

Versions précédentes

• Ajout de la prise en charge des formats d'annonces interstitielles et vidéo avec récompense.