Intégrer Liftoff Monetize à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces de Liftoff Monetize à l'aide de médiation, qui couvre à la fois les enchères les intégrations de cascades d'annonces. 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 applicationFlutter .

Intégrations et formats d'annonces compatibles

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

1 L'intégration des enchères est en version bêta ouverte.

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

Conditions requises

  • Le dernier SDK Google Mobile Ads
  • Flutter 3.7.0 ou version ultérieure
  • Pour déployer sur Android
    • Niveau d'API Android 21 ou supérieur
  • À déployer sur iOS
    • Cible de déploiement iOS 12.0 ou version ultérieure
  • Un projet Flutter fonctionnel, configuré avec SDK Google Mobile Ads. Voir Commencer pour en savoir plus.
  • Suivez le guide de démarrage pour la médiation.

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

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

Configurer les paramètres de médiation pour votre bloc d'annonces

Android

Pour obtenir des instructions, consultez l'étape 2 du guide pour Android

iOS

Pour obtenir des instructions, reportez-vous à l'étape 2 du guide pour iOS.

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 Vungle et l'adaptateur Liftoff Monetize

Intégration via pub.dev

Ajoutez la dépendance suivante aux dernières versions de Liftoff Monetize Le SDK et l'adaptateur dans le Fichier pubspec.yaml:

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

Intégration manuelle

Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour Liftoff Monetize extraire le fichier téléchargé et ajouter le dossier du plug-in extrait (et son contenu) à votre projet Flutter. Ensuite, référencez le plug-in dans votre pubspec.yaml en ajoutant la dépendance suivante:

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

É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 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 l'utilisateur concernant ces réseaux.

Le plug-in de médiation Google Mobile Ads pour Liftoff Monetize comprend GmaMediationLiftoffmonetize.setGDPRStatus(). L'exemple de code suivant montre comment transmettre les informations de consentement au SDK Vungle. Si vous choisissez cette méthode, il est recommandé de l'appeler avant de demander des annonces via le SDK Google Mobile Ads.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

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

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

Le plug-in de médiation Google Mobile Ads pour Liftoff Monetize comprend GmaMediationLiftoffmonetize.setCCPAStatus(). L'exemple de code suivant montre comment transmettre les informations de consentement au SDK Vungle. Si vous choisissez d'appeler cette méthode, nous vous recommandons de l'appeler avant de demander des annonces via le SDK Google Mobile Ads.

import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...

GmaMediationLiftoffmonetize.setCCPAStatus(true);

Consultez les instructions d'implémentation recommandées concernant la loi CCPA pour Android et iOS. les valeurs pouvant être fournies dans la méthode.

Étape 5: Ajoutez le code requis

Android

L'intégration de Liftoff Monetize ne nécessite aucun code supplémentaire.

iOS

Intégration de SKAdNetwork

Suivez les règles de Liftoff Monetize documentation pour ajouter les identifiants SKAdNetwork au fichier Info.plist de votre projet.

Étape 6 : Tester 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.

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 dans les classes suivantes:

Android

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

iOS

Format Nom de la classe
Annonce à l'ouverture (enchères) GADMediationAdapterVungle
Ouverture de l'application (cascade) GADMediationAdapterVungle
Bannière (enchères) GADMediationAdapterVungle
Bannière (cascade) GADMAdapterVungleInterstitial
Interstitiel (enchères) GADMediationAdapterVungle
Interstitiel (Waterfall) GADMAdapterVungleInterstitial
Avec récompense (enchères) GADMediationAdapterVungle
Avec récompense (Waterfall) GADMAdapterVungleRewardBasedVideoAd
Interstitiel avec récompense (enchères) GADMediationAdapterVungle
Interstitiel avec récompense (cascade d'annonces) GADMediationAdapterVungle

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 :

Android

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

iOS

Code d'erreur Motif
101 Paramètres de serveur non valides (ID de l'application ou de l'emplacement, par exemple).
102 Une annonce est déjà chargée pour cette configuration de réseau. Le SDK Vungle ne peut pas charger une deuxième annonce pour le même ID d'emplacement.
103 La taille d'annonce demandée ne correspond pas à une fonctionnalité Liftoff Monetize acceptée. la taille de la bannière.
104 Le SDK Vungle n'a pas pu afficher la bannière.
105 Le SDK Vungle ne permet de charger qu'une seule bannière à la fois, quelle que soit l'ID de l'emplacement.
106 Le SDK Vungle a envoyé un rappel indiquant que l'annonce ne peut pas être lue.
107 Le SDK Vungle n'est pas prêt à lire l'annonce.

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 Flutteroff Monetize

Version 1.0.0

  • Version initiale.
  • Compatibilité vérifiée avec l'adaptateur Android 7.3.1.0 de Liftoff Monetize.
  • Compatibilité validée avec l'adaptateur iOS LiftoffMonetize version 7.3.2.0
  • Il est conçu et testé avec le plug-in Flutter Google Mobile Ads version 5.1.0.