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 | |
Cascade | |
Formats | |
Ouverture de l'application | 1, 3. |
Bannière | 2. |
Interstitiel | |
Avec récompense | |
Interstitiel avec récompense | 2. |
1 Enchères l'intégration de ce format est en bêta fermée.
2 L'intégration des enchères pour ce format est disponible en version bêta ouverte.
3 Cascade l'intégration de ce format est en bêta fermée.
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 AdMob 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' AdMob 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
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 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 AdMob 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.