Intégrer Maio à la médiation

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

Ce guide explique comment utiliser Google Mobile Ads Flutter Plugin 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 en japonais pour ses libellés, boutons et descriptions. Les captures d'écran de ce guide n'ont pas été traduites. Toutefois, dans les descriptions et instructions, les libellés et les boutons sont désignés par leur équivalent en anglais. Par exemple, "URL スキーム" correspond à "schéma d'URL".

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 Google Mobile Ads Flutter Plugin.
  • Version 3.7.0 ou ultérieure du framework Flutter.
  • Pour le déploiement sur Android
    • Niveau d'API Android 24 ou ultérieur.
  • Pour le déploiement sur iOS
    • Cible de déploiement iOS 15.0 ou ultérieure.
  • Projet Flutter fonctionnel configuré avec Google Mobile Ads Flutter Plugin. Pour en savoir plus, consultez Configurer Google Mobile Ads Flutter Plugin.
  • Configurer 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 Application management (Gestion des applications) dans la barre latérale de gauche, puis sur New app (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 Video interstitial (Interstitiel vidéo) comme type d'annonce, puis cliquez sur Update (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 Video Rewards (Récompenses vidéo) comme type d'annonce, puis cliquez sur Update (Mettre à jour).

    Android

    iOS

    Sur la page Application Management (Gestion des applications), notez l'ID d'élément multimédia. Il est nécessaire pour configurer votre bloc d'annonces Ad Manager dans la section suivante.

    Android

    iOS

    Sur la page Zone Management (Gestion des zones), notez l'ID de zone. Il sera également nécessaire pour configurer votre bloc d'annonces Ad Manager dans la section suivante.

    Android

    iOS

    (Cascade uniquement) En plus de l'ID 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'ID d'API et la CLÉ API.

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

    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

    (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 de 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

    Assurez-vous d' enregistrer votre appareil de test pour Ad Manager.

    Les éditeurs qui utilisent la version 7.26.0 ou ultérieure de Google Mobile Ads Flutter Plugin recevront automatiquement des annonces test de maio sur les téléphones et tablettes enregistrés comme appareils de test lors de l'envoi de requêtes.

    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
    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 Aucune annonce n'est disponible dans maio.
    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 Aucune annonce n'est encore disponible dans maio.
    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 réseau.

    Journal des modifications de l'adaptateur de médiation maio Flutter

    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