Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher provenant de ironSource Annonces utilisant Médiation, couvrant les cascades d'annonces de Google Cloud. Il explique comment ajouter des annonces ironSource configuration de la médiation, et comment intégrer le SDK ironSource Ads et l'adaptateur dans une Flutter application.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation AdMob pour les annonces ironSource les fonctionnalités suivantes:
Intégration | |
---|---|
Enchères | 1 |
Cascade | |
Formats | |
Bannière | 2. |
Interstitiel | |
Avec récompense | |
Interstitiel avec récompense | 2. |
1 L'intégration des enchères est en cours en version bêta fermée, contactez votre responsable de compte pour demander l'accès.
2 Ce format n'est compatibles avec l'intégration de cascades d'annonces.
Conditions requises
- Le dernier SDK Google Mobile Ads
- Flutter 3.7.0 ou version ultérieure
- Pour déployer sur Android
<ph type="x-smartling-placeholder">
- </ph>
- Niveau d'API Android 21 ou supérieur
- À déployer sur iOS
<ph type="x-smartling-placeholder">
- </ph>
- Cible de déploiement iOS 12.0 ou version ultérieure
- Un projet Flutter opérationnel configuré avec Google SDK Mobile Ads. Voir Commencer pour en savoir plus.
- Finaliser la médiation Guide de démarrage
Étape 1: Définissez des configurations dans l'interface utilisateur ironSource Ads
Étape 2: Configurez la demande ironSource Ads 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 ironSource Mobile à la liste des partenaires publicitaires concernant le RGPD et les réglementations des États américains
Étape 3: Importez le SDK ironSource Ads et l'adaptateur
Intégration via pub.dev
(Android uniquement) Ajoutez les dépôts suivants au fichier build.gradle
dans le répertoire android
de votre projet :
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
Ajoutez la dépendance suivante aux dernières versions de
IronSource
Le SDK et l'adaptateur dans le
Fichier pubspec.yaml
:
dependencies:
gma_mediation_ironsource: ^1.0.0
Intégration manuelle
Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour
IronSource
, extrayez le fichier téléchargé, puis ajoutez 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_ironsource:
path: path/to/local/package
Étape 4: Implémenter les paramètres de confidentialité sur le SDK ironSource Ads
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.
Plug-in de médiation Google Mobile Ads pour ironSource Ads
inclut les
GmaMediationIronsource().SetConsent()
. L'exemple de code suivant montre comment transmettre
les informations de consentement au SDK ironSource Ads. Si vous choisissez d'appeler
, il est recommandé de le faire avant de demander des annonces via la
SDK Google Mobile Ads.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
Consultez la documentation de ironSource Ads sur Réglementation Paramètres avancés pour en savoir plus.
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 locale, qui 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é.
Plug-in de médiation Google Mobile Ads pour ironSource Ads
inclut les
GmaMediationIronsource().setDoNotSell
. L'exemple de code suivant montre comment transmettre
les informations de consentement au SDK ironSource Ads. Ces options doivent être définies avant
vous initialisez les annonces Google pour mobile
SDK
pour vous assurer qu'elles sont transmises
correctement au SDK ironSource Ads.
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
Consultez la documentation d'ironSource Ads sur les paramètres avancés liés à la réglementation pour les deux Sur Android et iOS pour en savoir plus et connaître les valeurs pouvant être fournies dans la méthode.
Étape 5: Ajoutez le code requis
Android
Règles ProGuard
Si vous réduisez, obscurcissez et optimisez votre application, IronSource Ads nécessite des règles ProGuard supplémentaires pour votre projet.
Consulter
Guide d'intégration du SDK Android d'IronSource Ads
pour en savoir plus sur les règles ProGuard requises pour votre projet.
puis ajoutez ces règles à votre fichier proguard-user.txt
.
Cycle de vie de l'application
Remplacez les méthodes onPause()
et onResume()
dans chacune des méthodes suivantes :
vos activités pour appeler les méthodes ironSource Ads correspondantes, comme suit:
Java
@Override
public void onResume() {
super.onResume();
IronSource.onResume(this);
}
@Override
public void onPause() {
super.onPause();
IronSource.onPause(this);
}
Kotlin
public override fun onResume() {
super.onResume()
IronSource.onResume(this)
}
public override fun onPause() {
super.onPause()
IronSource.onPause(this)
}
iOS
Intégration SKAdNetwork
Suivez la documentation d'ironSource Ads pour ajouter les identifiants SKAdNetwork à votre
le fichier Info.plist
du projet.
Étape 6: Testez votre implémentation
Activer les annonces tests
Veillez à enregistrer votre appareil de test pour AdMob et à activer le mode test dans l' IronSource UI.
Valider les annonces tests
Pour vérifier que vous recevez des annonces tests de IronSource , activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de ironSource Ads (Waterfall) sources d'annonces.
Codes d'erreur
Si l'adaptateur ne reçoit pas d'annonce de ironSource Ads, les éditeurs peuvent vérifier
l'erreur sous-jacente de la réponse d'annonce
ResponseInfo
sous
classes suivantes:
Android
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
Voici les codes et les messages associés générés par les annonces ironSource Ads en cas d'échec du chargement d'une annonce:
Android
Code d'erreur | Motif |
---|---|
101 | Les paramètres du serveur ironSource Ads configurés dans l'interface AdMob sont manquants ou non valides. |
102 | ironSource Ads a besoin d'un contexte Activity pour initialiser son SDK. |
103 | ironSource Ads ne peut charger qu'une seule annonce par ID d'instance ironSource. |
105 | La taille de bannière demandée n'est pas prise en charge par ironSource Ads. |
106 | Le SDK ironSource Ads n'est pas initialisé. |
501-1056 | Erreurs du SDK Ads ironSource. Consultez la documentation. pour en savoir plus. |
iOS
Code d'erreur | Motif |
---|---|
101 | Les paramètres du serveur ironSource Ads configurés dans l'interface AdMob sont manquants ou non valides. |
102 | L'adaptateur d'annonces ironSource n'est pas compatible avec le format d'annonce demandé. |
103 | Une annonce ironSource est déjà chargée pour cette configuration réseau. |
104 | La taille de bannière demandée n'est pas prise en charge par ironSource Ads. |
508-1037 | Erreurs du SDK Ads ironSource. Consultez la documentation. pour en savoir plus. |
Journal des modifications de l'adaptateur de médiation Flutter ironSource
1.0.0
- Version initiale.
- Compatibilité vérifiée avec l'adaptateur Android ironSource version 8.0.0.0
- Compatibilité vérifiée avec l'adaptateur iOS ironSource version 8.0.0.0.0
- Il est conçu et testé avec le plug-in Flutter Google Mobile Ads version 5.1.0.