Intégrer Maio à la médiation

Sélectionnez une plate-forme : Android iOS Unity Flutter Android (ancien)

Ce guide explique comment utiliser Google Mobile Ads Flutter Plugin pour charger et afficher des annonces de 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 leurs équivalents en anglais. "schéma d'URL," par exemple, est "URL Scheme,".

Intégrations et formats d'annonces pris en charge

L'adaptateur de médiation pour maio offre les fonctionnalités suivantes :

Intégration
Enchères
Cascade
Formats
Ouverture de l'application
Bannière
Interstitiel
Accordé
Interstitiel avec récompense
Natif

Prérequis

Avant de continuer, vérifiez les points suivants :

  • Dernière version de Google Mobile Ads Flutter Plugin.
  • Framework Flutter version 3.7.0 ou ultérieure.
  • Pour le déploiement sur Android
    • Niveau d'API Android 24 ou version ultérieure.
  • Pour le déploiement sur iOS
    • Cible de déploiement iOS 15.0 ou version ultérieure
  • Un projet Flutter fonctionnel configuré avec Google Mobile Ads Flutter Plugin. Pour en savoir plus, consultez Configurer Google Mobile Ads Flutter Plugin.
  • Configurez 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 Interstitiel vidéo comme type d'annonce, puis cliquez sur Mettre à jour.

    Android

    iOS

    Accordé

    Saisissez le nom de votre application, sélectionnez la plate-forme et indiquez l'URL de l'application. Sélectionnez Annonces 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 d'élément multimédia. Vous en aurez besoin pour configurer votre bloc d'annonces Ad Manager dans la section suivante.

    Android

    iOS

    Sur la page Gestion des zones, notez l'ID de la zone. Vous en aurez également besoin pour configurer votre bloc d'annonces Ad Manager dans la section suivante.

    Android

    iOS

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

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

    Configurer les paramètres de médiation de 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

    (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://imobile-maio.github.io/maven")
      }
  }

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

    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 : Testez votre implémentation

    Activer les annonces test

    Enregistrez votre appareil de test pour Ad Manager.

    Les éditeurs qui utilisent la version 7.26.0 ou une version ultérieure de Google Mobile Ads Flutter Plugin recevront automatiquement des annonces tests de maio sur les téléphones et tablettes enregistrés en tant qu'appareils de test lorsqu'ils effectuent des 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 à partir de la réponse d'annonce à l'aide de ResponseInfo sous les classes suivantes :

    Android

    Format Nom de la classe
    Interstitiel jp.maio.sdk.android.mediation.admob.adapter.Interstitial
    Accordé jp.maio.sdk.android.mediation.admob.adapter.Rewarded

    iOS

    Format Nom de la classe
    Interstitiel GADMMaioInterstitialAdapter
    Accordé 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 d'aucune 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 propose 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 maio

    Version 1.1.8

    Version 1.1.7

    Version 1.1.6

    Version 1.1.5

    Version 1.1.4

    Version 1.1.3

    Version 1.1.2

    Version 1.1.1

    Version 1.1.0

    Version 1.0.3

    Version 1.0.2

    Version 1.0.1

    Version 1.0.0