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, pour couvrir 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 des enchères est en bêta ouverte.

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

³ 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

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 saisissant toutes les informations nécessaires.

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

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 "Liftoff Monetize Placements", cliquez sur le bouton Ajouter un emplacement et sélectionnez votre application dans la liste déroulante.

Vous trouverez ci-dessous des informations détaillées sur l'ajout de nouveaux emplacements:

Notez l'ID de référence, puis cliquez sur Sounds Good (Bonne idée).

Trouver votre clé API Reporting

Activer le mode test

Pour activer les annonces tests, accédez à votre tableau de bord Liftoff Monetize, puis à Applications.

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

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

Connectez-vous à votre compte Ad Manager.

Ajouter Liftoff Monetize "Entreprises"

Activer le partage des signaux sécurisés

Configurer Liftoff Monetize les enchères

Configurer la mise en correspondance des blocs d'annonces

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

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

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

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

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

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

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.

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

VunglePrivacySettings.setCCPAStatus(true);

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:

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

¹ 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:

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

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

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

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

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.