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
Le dernier SDK Google Mobile Ads
Finaliser la médiation Guide de démarrage
É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
Étape 3: Importez le SDK et l'adaptateur Vungle
Intégration d'Android Studio (recommandé)
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 dossierlibs
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
Consentement de l'UE et RGPD
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 Activity contexte 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 deVungleMediationAdapter
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
ettargetSdkVersion
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é parmediationExtras
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
etFlexView
(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.