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 avec médiation, couvrant à la fois l'intégration des enchères et de la cascade d'annonces. Vous verrez comment ajouter Liftoff Monétiser jusqu'à la configuration de médiation d'un bloc d'annonces et intégrer la SDK Vungle et adaptateur dans une Android application.

Intégrations et formats d'annonces compatibles

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

Intégration
Enchères 1.
Cascade
Formats
Ouverture de l'application
Bannière
Interstitiel
Avec récompense
Interstitiel avec récompense 3.
Natif 2.

1 Intégration des enchères est en bêta ouverte.

2 Enchères l'intégration de ce format est en bêta fermée.

3 Avec récompense de votre annonce interstitielle. Contacter votre compte chez Liftoff Monetize ou monetize@liftoff.io.

Conditions requises

  • Niveau d'API Android 21 ou supérieur

Étape 1: Définissez des configurations dans l'UI Liftoff Monetize

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

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

Suivez les étapes indiquées dans Paramètres RGPD et Paramètres des réglementations des États américains pour ajouter Liftoff à la liste des partenaires publicitaires sur le RGPD et les réglementations des États américains dans l' Ad Manager UI.

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

Dans le fichier build.gradle.kts au niveau de l'application, ajoutez l'implémentation suivante : les dépendances et les configurations. Utiliser la dernière version du SDK Vungle et l'adaptateur:

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

Intégration manuelle

  • Téléchargez la dernière version du SDK Vungle pour Android. Extrayez les fichiers .jar du dossier libs et ajoutez-les à votre projet.

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

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

Conformément à l'accord de l'utilisateur dans l'UE de Google de confidentialité, vous devez vous assurer que certaines divulgations sont divulguées à et le consentement obtenu auprès des utilisateurs de l'Espace économique européen (EEE) concernant l'utilisation d'identifiants d'appareil et de données à caractère personnel. Ces règles tiennent compte exigences de la directive vie privée et communications électroniques de l'UE, et de la protection générale des données 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 qui peut collecter, recevoir ou utiliser des données à caractère personnel et fournissent des informations sur l'utilisation de chaque réseau. Google n'est actuellement pas en mesure de transmettre automatiquement le choix de consentement 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 de consentement 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.

Java

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

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

Kotlin

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

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

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

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

États-Unis lois sur la confidentialité dans les États n'ont pas besoin de donner aux utilisateurs pour désactiver la "promotion" de leurs « informations personnelles » (selon la définition de la loi ces conditions d'utilisation), avec la possibilité de désactiver cette fonctionnalité via la page "Do Not Sell My Personal Informations" sur le lien "vente" la page d'accueil du tiers. La États-Unis confidentialité des états de conformité avec la législation en vigueur vous permet d'activer traitement restreint des données pour la diffusion d'annonces Google, mais Google ne peut pas appliquer ce paramètre à chaque annonce dans votre chaîne de médiation. Vous devez donc identifier chaque réseau publicitaire de votre chaîne de médiation susceptibles de participer à la vente de les informations et de suivre les directives de chacun de ces réseaux pour vous assurer de 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 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.

Java

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

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

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

VunglePrivacySettings.setCCPAStatus(true)

Voir Mise en œuvre de la loi CCPA pour en savoir plus et connaître les valeurs pouvant être fournies dans la méthode.

Étape 5: Ajoutez le code requis

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

Étape 6: Testez votre implémentation

Activer les annonces tests

Veillez à enregistrer votre appareil de test pour Ad Manager et à activer le mode test dans l' Liftoff Monetize UI.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests deLiftoff Monetize, activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) sources d'annonces.

Étapes facultatives

Paramètres propres au réseau

L'adaptateur Liftoff Monetize accepte la demande supplémentaire suivante. paramètres pouvant être transmis à l'adaptateur:

userId
Chaîne représentant l'ID utilisateur incitatif de Liftoff Monetize.
adOrientation
Entier spécifiant l'orientation de la 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:

Java 

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

Kotlin 

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 NativeAd d'objets. Elle renseigne les éléments suivants : champs pendant NativeAd

Champ Assets toujours inclus par l'adaptateur Liftoff Monetize
Titre
Image 1
Vue multimédia
Corps
Icône de l'application
Incitation à l'action
Note
Boutique
Prix

1 The Liftoff Monetize l'adaptateur ne fournit pas un accès direct à l'élément image principal pour son annonces. Au lieu de cela, l'adaptateur renseigne MediaView avec une vidéo ou une image.

Codes d'erreur

Si l'adaptateur ne reçoit pas d'annonce de Liftoff Monetize, les éditeurs peuvent vérifiez l'erreur sous-jacente dans la réponse d'annonce ResponseInfo.getAdapterResponses() dans les classes suivantes:

Format Nom de la classe
Annonce à l'ouverture (enchères) com.google.ads.mediation.vungle.VungleMediationAdapter
Ouverture de l'application (cascade) com.google.ads.mediation.vungle.VungleMediationAdapter
Bannière (enchères) com.google.ads.mediation.vungle.VungleMediationAdapter
Bannière (cascade) com.vungle.mediation.VungleInterstitialAdapter
Interstitiel (enchères) com.google.ads.mediation.vungle.VungleMediationAdapter
Interstitiel (Waterfall) com.vungle.mediation.VungleInterstitialAdapter
Avec récompense (enchères) com.google.ads.mediation.vungle.VungleMediationAdapter
Avec récompense (Waterfall) com.vungle.mediation.VungleAdapter
Interstitiel avec récompense (enchères) com.google.ads.mediation.vungle.VungleMediationAdapter
Interstitiel avec récompense (cascade d'annonces) com.google.ads.mediation.vungle.VungleMediationAdapter
Native (enchères) com.google.ads.mediation.vungle.VungleMediationAdapter
Natif (cascade) com.google.ads.mediation.vungle.VungleMediationAdapter

Voici les codes et les messages associés générés par Liftoff Monetize en cas d'échec du chargement d'une annonce:

Code d'erreur Domaine Motif
101 com.google.ads.mediation.vungle Paramètres de serveur non valides (ID de l'application ou de l'emplacement, par exemple).
102 com.google.ads.mediation.vungle La taille de bannière demandée ne correspond pas à une annonce Liftoff Monetize valide la taille de l'image.
103 com.google.ads.mediation.vungle Liftoff Monetize a besoin d'un Activitycontexte pour demander annonces.
104 com.google.ads.mediation.vungle Le SDK Vungle ne peut pas charger plusieurs annonces pour le même emplacement ID.
105 com.google.ads.mediation.vungle Échec de l'initialisation du SDK Vungle.
106 com.google.ads.mediation.vungle Le SDK Vungle a renvoyé un rappel de chargement réussi, mais Banners.getBanner() ou Vungle.getNativeAd() a renvoyé la valeur "null".
107 com.google.ads.mediation.vungle Le SDK Vungle n'est pas prêt à lire l'annonce.
108 com.google.ads.mediation.vungle Le SDK Vungle a renvoyé un jeton d'enchère non valide.

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.0.1

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

Conçu et testé avec:

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

Version 7.4.0.0

  • Extension de la classe VungleInterstitialAdapter à partir de VungleMediationAdapter afin d'ajouter la compatibilité avec la cascade d'annonces au format d'annonce à l'ouverture d'une application dans 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.
  • SDK Vungle 7.4.0.

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.
  • SDK Vungle 7.3.2.

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.
  • SDK Vungle 7.3.1.

Version 7.3.0.0

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

Conçu et testé avec:

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

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
  • 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 des impressions pour les annonces natives associées à des enchères.
  • L'adaptateur a été rétabli pour qu'il dépende de la version 22.3.0 du SDK Google Mobile Ads.

Conçu et testé avec:

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

Version 7.0.0.0

  • Il est désormais possible de charger plusieurs annonces avec le même ID d'emplacement pour tous les formats d'annonces participant à la cascade d'annonces.
  • Changement de nom de l'adaptateur : Vungle devient 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.
  • SDK Vungle 7.0.0.

Version 6.12.1.1

  • Adaptateur mis à jour pour utiliser la nouvelle classe VersionInfo.
  • Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.0.0.

Conçu et testé avec:

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

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
  • SDK Vungle 6.12.1.

Version 6.12.0.1

  • Ajout de la prise en charge des enchères pour le format de 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 vers la version 21.4.0.

Conçu et testé avec:

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

Version 6.12.0.0

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 21.1.0
  • 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 vers la version 21.1.0.

Conçu et testé avec:

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

Version 6.11.0.2

  • Il est désormais possible de charger plusieurs annonces pour le même ID d'emplacement dans les annonces associées à des enchères avec récompense.

Conçu et testé avec:

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

Version 6.11.0.1

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

Conçu et testé avec:

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

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
  • 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 vers la version 20.6.0.

Conçu et testé avec:

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

Version 6.10.4.0

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 20.5.0
  • SDK Vungle 6.10.4.

Version 6.10.3.0

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 20.5.0
  • SDK Vungle 6.10.3.

Version 6.10.2.1

  • Compatibilité vérifiée avec le SDK Vungle 6.10.2.
  • 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 vers la version 20.5.0.

Conçu et testé avec:

  • SDK Google Mobile Ads version 20.5.0
  • SDK Vungle 6.10.2.

Version 6.10.2.0

  • Compatibilité vérifiée avec le SDK Vungle 6.10.2.
  • Lors des demandes de bannières et d'annonces interstitielles, le paramètre serverParameters a été remplacé par mediationExtras pour obtenir les paramètres spécifiques au réseau Vungle. Ce problème a été résolu.

Conçu et testé avec:

  • SDK Google Mobile Ads version 20.3.0
  • 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 vers la version 20.3.0.
  • Les annonces MREC sont désormais compatibles avec l'API de bannière 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
  • SDK Vungle 6.10.1.

Version 6.9.1.1

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 20.0.0.
  • 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é des annonces avec récompense pour le rappel Vungle onAdViewed.
  • Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.7.0.

Conçu et testé avec:

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

Version 6.8.1.1

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 19.6.0.
  • 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 vers la version 19.5.0.

Conçu et testé avec:

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

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 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 vers la version 19.4.0.

Conçu et testé avec:

  • SDK Google Mobile Ads version 19.4.0.
  • 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 vers la version 19.3.0.

Conçu et testé avec:

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

Version 6.7.0.0

  • Compatibilité vérifiée avec le SDK Vungle 6.7.0.
  • L'adaptateur a été mis à jour 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 réactivé par défaut.
  • Les annonces interstitielles transfèrent désormais le rappel onAdLeftApplication() lorsque l'utilisateur clique dessus.
  • Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.2.0.

Conçu et testé avec:

  • SDK Google Mobile Ads version 19.2.0.
  • 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 vers la version 19.0.1.

Conçu et testé avec:

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

Version 6.4.11.1

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

Version 6.4.11.0

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

Version 6.3.24.1

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

  • La compatibilité avec le SDK Vungle 6.3.12 a été vérifiée.

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

  • L'adaptateur a été 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 Adpater pour Android Studio 3.0.
  • Ajout des méthodes suivantes à la classe de compilateur de Bundle.
    • 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 créer des annonces Flex View. se ferment automatiquement 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.
  • Remplacement du système de dénomination des versions par [Version du SDK Vungle].[version du correctif de l'adaptateur].

Versions précédentes

  • Les formats d'annonces vidéo interstitielles et avec récompense ont été ajoutés.