Intégrer Maio à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces de maio à l'aide de la médiation, en couvrant les intégrations en cascade. Il explique comment ajouter maio à la configuration de médiation d'un bloc d'annonces, et comment intégrer le SDK et l'adaptateur maio 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 présente 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
  • Déployer sur Android
    • Niveau d'API Android 23 ou supérieur
  • Déployer 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.
  • Suivez le guide de démarrage sur la médiation.

Étape 1 : Configurez les configurations dans l'UI de 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

(Cascade uniquement) En plus de l'ID du média et de l'ID de la zone, vous aurez besoin de l'ID de l'API et de la clé API pour configurer l'ID de votre bloc d'annonces pour la médiation. Sur la page de l'API Reporting, notez l'ID de l'API et la clé API.

Étape 2 : Configurer la demande maio dans l'UI AdMob

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 savoir comment procéder, consultez 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: ^

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 : Ajoutez 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 tests

Assurez-vous d'enregistrer 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 lorsqu'ils effectueront des demandes.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests de maio, activez le test d'une source d'annonces spécifique dans l'inspecteur d'annonces à l'aide de la ou des sources d'annonces maio (cascade).

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir d'annonce de la part de maio, les éditeurs peuvent vérifier l'erreur sous-jacente à partir de la réponse de l'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 générés par l'adaptateur maio lorsqu'une annonce ne parvient pas à se charger :

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 n'a pas encore d'annonce disponible.
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.0.3

Version 1.0.2

Version 1.0.1

Version 1.0.0