Intégrer Liftoff Monetize à la médiation

Sélectionnez une plate-forme : Android (bêta) Android iOS Unity Flutter

Ce guide explique comment utiliser GMA Next-Gen SDK pour charger et afficher des annonces Liftoff Monetize à l'aide de la médiation. Il aborde notamment les intégrations par enchères et en cascade. Vous apprendrez à ajouter Liftoff Monetize à la configuration de médiation d'un bloc d'annonces et à intégrer le SDK et l'adaptateur Vungle dans une application Android.

Intégrations et formats d'annonces pris en charge

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

Conditions requises

• Dernière version : GMA Next-Gen SDK.

• Avoir suivi le guide de démarrage sur la médiation

Étape 1 : Configurer les paramètres 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 des applications Liftoff Monetize.

Notez l'ID de l'application.

Ajouter des emplacements

Pour créer un emplacement à utiliser avec la médiation, 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.

Localiser votre clé API Reporting

Mettre à jour votre fichier app-ads.txt

Le fichier Authorized Sellers for Apps (app-ads.txt) est une initiative de l'IAB Tech Lab visant à garantir que l'inventaire publicitaire de votre application est vendu uniquement par l'intermédiaire des canaux de distribution que vous avez 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 : Configurer 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 soumis au RGPD et aux réglementations des États américains

Suivez les étapes décrites dans Paramètres liés aux réglementations européennes et Paramètres liés aux réglementations des États américains pour ajouter Liftoff à la liste des partenaires publicitaires concernés 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 Gradle au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes :

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:vungle:7.7.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:vungle:7.7.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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 des utilisateurs de l'UE et RGPD

Pour respecter les Règles relatives au consentement de l'utilisateur dans l'UE de Google, vous devez fournir certaines informations à vos utilisateurs situés 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 à des fins de 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 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é des É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 du "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 propres à chacun 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, il est recommandé de le faire avant de demander des annonces via GMA Next-Gen SDK.

VunglePrivacySettings.setCCPAStatus(true);
LiftoffMonetizeMediationSnippets.java

VunglePrivacySettings.setCCPAStatus(true)
LiftoffMonetizeMediationSnippets.kt

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

Étape 5 : Ajouter 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 test

Enregistrez votre appareil de test pour Ad Manager et activez le mode test dans l'UI Liftoff Monetize.

Vérifier la réception des annonces test

Pour vérifier que vous recevez des annonces test de Liftoff Monetize, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les 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 la présentation pour les annonces plein écran.

setBackButtonImmediatelyEnabled

Booléen permettant d'activer ou de désactiver immédiatement le bouton Retour sur les annonces à l'ouverture d'application. Définissez sur true pour activer immédiatement le bouton "Retour", ou sur false dans le cas contraire. La valeur par défaut est false. Pour en savoir plus, consultez la documentation de Liftoff Monetize sur l'intégration des annonces interstitielles.

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);
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        // App Open ads use VungleMediationAdapter
        .addNetworkExtrasBundle(VungleMediationAdapter.class, extras)
        .build();
LiftoffMonetizeMediationSnippets.java

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    // App Open ads use VungleMediationAdapter
    .addNetworkExtrasBundle(VungleMediationAdapter::class.java, extras)
    .build()
LiftoffMonetizeMediationSnippets.kt

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 reçoit pas d'annonce de Liftoff Monetize, les éditeurs peuvent vérifier l'erreur sous-jacente à partir de la réponse d'annonce à l'aide de ResponseInfo.getAdSourceResponses() sous les classes suivantes :

Voici les codes et les messages associés que génère l'adaptateur Liftoff Monetize lorsque le chargement d'une annonce échoue :

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