Ce guide explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces maio à l'aide de la médiation. Il aborde notamment les intégrations en cascade. Vous apprendrez à ajouter maio à la configuration de médiation d'un bloc d'annonces et à intégrer le SDK maio et son adaptateur dans une application Flutter.
L'interface du tableau de bord de maio utilise du texte japonais pour ses libellés, ses boutons et ses descriptions. Les captures d'écran de ce guide n'ont pas été traduites. Toutefois, dans les descriptions et les instructions fournies ici, les libellés et les boutons sont désignés par leur équivalent en anglais. Par exemple, "URL スキーム" correspond à "URL Scheme".
Intégrations et formats d'annonces acceptés
L'adaptateur de médiation pour maio offre les fonctionnalités suivantes :
| Intégration | |
|---|---|
| Enchères | |
| Cascade | |
| Formats | |
| Bannière | |
| Annonces interstitielles | |
| Avec récompense | |
| Natif | |
Conditions requises
- Dernière version du SDK Google Mobile Ads
- Flutter 3.7.0 ou version ultérieure
- Pour le déploiement sur Android
- Niveau d'API Android 23 ou supérieur
- Pour le déploiement sur iOS
- Cible de déploiement iOS 12.0 ou version ultérieure
- Un projet Flutter fonctionnel configuré avec le SDK Google Mobile Ads. Pour en savoir plus, consultez Premiers pas.
- Avoir suivi le guide de démarrage sur la médiation
Étape 1 : Configurer les paramètres dans l'UI maio
Tout d'abord, inscrivez-vous ou connectez-vous à votre compte maio. Cliquez sur le bouton Gestion des applications dans la barre latérale de gauche, puis sur Nouvelle application.

Sélectionnez l'onglet correspondant au type d'annonce de votre choix.
Interstitiel
Saisissez le nom de votre application, sélectionnez la plate-forme et indiquez l'URL de l'application. Sélectionnez Vidéo interstitielle comme type d'annonce, puis cliquez sur Mettre à jour.
Android

iOS

Avec récompense
Saisissez le nom de votre application, sélectionnez la plate-forme et indiquez l'URL de l'application. Sélectionnez Vidéo avec récompense comme Type d'annonce, puis cliquez sur Mettre à jour.
Android

iOS

Sur la page Gestion des applications, notez l'ID du contenu multimédia. Il est nécessaire pour configurer votre bloc d'annonces AdMob dans la section suivante.
Android

iOS

Sur la page Gestion des zones, notez l'ID de la zone. Il sera également nécessaire pour configurer votre bloc d'annonces AdMob dans la section suivante.
Android

iOS


Étape 2 : Configurer la demande maio dans l'UI AdMob
Configurer les paramètres de médiation pour votre bloc d'annonces
Android
Suivez les instructions de l'étape 2 du guide pour Android.
iOS
Suivez les instructions de l'étape 2 du guide pour iOS.
Étape 3 : Importer le SDK et l'adaptateur maio
Intégration via pub.dev
Ajoutez la dépendance suivante avec les dernières versions du SDK et de l'adaptateur maio dans le fichier pubspec.yaml de votre package :
dependencies:
gma_mediation_maio: ^1.1.0
Intégration manuelle
Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour maio, 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 fichier pubspec.yaml en ajoutant la dépendance suivante :
dependencies:
gma_mediation_maio:
path: path/to/local/package
Étape 4 : Ajouter le code requis
Android
Aucun code supplémentaire n'est requis pour l'intégration de maio.
iOS
Intégration de SKAdNetwork
Suivez la documentation de maio pour ajouter les identifiants SKAdNetwork au fichier Info.plist de votre projet.
Étape 5 : Tester votre implémentation
Activer les annonces test
Enregistrez votre appareil de test pour AdMob.
Les éditeurs qui utilisent la version 7.26.0 ou ultérieure du SDK Google Mobile Ads recevront automatiquement des annonces tests de maio sur les téléphones et tablettes enregistrés comme appareils de test lors de l'envoi de demandes.
Vérifier la réception des annonces test
Pour vérifier que vous recevez des annonces test de maio, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les sources d'annonces maio (cascade).
Codes d'erreur
Si l'adaptateur ne reçoit pas d'annonce de maio, les éditeurs peuvent vérifier l'erreur sous-jacente dans la réponse d'annonce à l'aide de ResponseInfo dans les classes suivantes :
Android
| Format | Nom de la classe |
|---|---|
| Interstitiel | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
| Avec récompense | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
| Format | Nom de la classe |
|---|---|
| Interstitiel | GADMMaioInterstitialAdapter |
| Avec récompense | GADMMaioRewardedAdapter |
Voici les codes et les messages associés que génère l'adaptateur maio lorsque le chargement d'une annonce échoue :
Android
| Code d'erreur | Motif |
|---|---|
| 0-10 | maio a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez le code et la documentation de maio. |
| 101 | Maio ne dispose pas d'annonce. |
| 102 | Paramètres de serveur non valides (par exemple, ID d'emplacement manquant). |
| 103 | Le contexte utilisé pour charger une annonce n'était pas une instance "Activity". |
iOS
| Code d'erreur | Motif |
|---|---|
| 0-10 | maio a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez le code de maio. |
| 101 | maio ne dispose pas encore d'annonce. |
| 102 | Paramètres de serveur non valides (par exemple, ID d'emplacement manquant). |
| 103 | L'adaptateur maio n'est pas compatible avec le format d'annonce demandé. |
| 104 | Une annonce est déjà chargée pour cette configuration de réseau. |
Journal des modifications de l'adaptateur de médiation Flutter de maio
Version 1.1.0 (en cours)
Version 1.0.3
- Compatible avec l'adaptateur maio pour Android version 2.0.5.0
- Compatible avec l'adaptateur maio pour iOS version 2.1.6.1
- Conçu et testé avec le plug-in Google Mobile Ads Flutter version 6.0.0
Version 1.0.2
- Compatible avec l'adaptateur maio pour Android version 2.0.4.0
- Compatible avec l'adaptateur maio pour iOS version 2.1.6.1
- Conçu et testé avec le plug-in Google Mobile Ads Flutter version 6.0.0
Version 1.0.1
- Compatible avec l'adaptateur maio pour Android version 2.0.3.1
- Compatible avec l'adaptateur maio pour iOS version 2.1.6.1
- Conçu et testé avec le plug-in Google Mobile Ads Flutter version 6.0.0
Version 1.0.0
- Version initiale.
- Compatible avec l'adaptateur maio pour Android version 2.0.3.0
- Compatible avec l'adaptateur maio pour iOS version 2.1.6.0
- Conçu et testé avec le plug-in Google Mobile Ads Flutter version 5.3.1