Intégrer Maio à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces depuis Maio à l'aide de la médiation AdMob, de la et de l'intégration de cascades d'annonces. 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 applicationAndroid .

L'interface du tableau de bord pour 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 les instructions de ce guide, les libellés et les boutons sont référencés avec leur équivalent en langue anglaise. Par exemple, "URL ム " est "Schéma d'URL".

Intégrations et formats d'annonces compatibles

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

Conditions requises

• Niveau d'API Android 21 ou supérieur

• SDK maio 1.0.7 ou version ultérieure

• Dernière version du SDK Google Mobile Ads

• Suivez le guide de démarrage de la médiation.

Étape 1: Définissez des configurations 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.

Sur la page Gestion des applications, notez l'ID média. Vous en aurez besoin pour configurer votre bloc d'annonces AdMob dans la section suivante.

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

Étape 2 : Configurez la demande de mai dans l'interface utilisateur de AdMob

Configurer les paramètres de médiation pour votre bloc d'annonces

Vous devez ajouter maio à la configuration de la médiation pour votre bloc d'annonces.

Connectez-vous à votre compte AdMob. Accédez ensuite à l'onglet Médiation. Si vous souhaitez modifier un groupe de médiation existant, cliquez sur son nom pour le modifier, puis passez à l'étape Ajouter maio comme source d'annonces.

Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.

Saisissez le format de votre annonce et votre plate-forme, puis cliquez sur Continuer.

Attribuez un nom à votre groupe de médiation, puis sélectionnez les zones géographiques à cibler. Définissez ensuite l'état du groupe de médiation sur Activé, puis cliquez sur Ajouter des blocs d'annonces.

Associez ce groupe de médiation à un ou plusieurs de vos blocs d'annoncesAdMob existants. Cliquez ensuite sur Done (OK).

Vous devriez maintenant voir la fiche des blocs d'annonces que vous avez sélectionnés:

Ajouter maio comme source d'annonces

Sous la fiche Waterfall (Cascade d'annonces) de la section Ad Sources (Sources d'annonces), sélectionnez Add Ad Source (Ajouter une source d'annonces). Sélectionnez ensuite maio.

Si vous disposez déjà d'un mappage pour maio, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.

Saisissez ensuite les Media ID and Zone IDobtenus à la section précédente. Cliquez ensuite sur Done (OK).

Étape 3 : Importer le SDK et l'adaptateur de maiO

Intégration d'Android Studio (recommandé)

Dans le fichier settings.gradle.kts au niveau du projet, ajoutez les dépôts suivants :

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

Ensuite, dans le fichier build.gradle.kts au niveau de l'application, ajoutez les configurations et dépendances d'implémentation suivantes. Utilisez les dernières versions du SDK et de l'adaptateur maio :

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

Intégration manuelle

• Téléchargez la dernière version du SDK Android Maven et ajoutez-la à votre projet.
• Accédez aux artefacts d'adaptateur maio dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier ".aar" de l'adaptateur Maio et ajoutez-le à votre projet.

Étape 4: Ajoutez le code requis

Aucun code supplémentaire n'est requis pour l'intégration à Android maio.

Étape 5 : Tester votre implémentation

Activer les annonces tests

Veillez à enregistrer votre appareil de test pour AdMob.

Les éditeurs qui utilisent la version 11.6.0 ou une version ultérieure du SDK Google Mobile Ads recevront automatiquement, lors des demandes, des annonces tests de maio sur les téléphones et les tablettes enregistrés en tant qu'appareils de test.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests demaio, activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de maio (Waterfall) sources d'annonces.

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir une annonce de maio, les éditeurs peuvent vérifier l'erreur sous-jacente de la réponse de l'annonce à l'aide de,, ResponseInfo.getAdapterResponses() etdans les classes suivantes :

Voici les codes et les messages associés générés par l'adaptateur maio en cas d'échec du chargement d'une annonce:

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

Version 1.1.16.3

• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 23.0.0.
• Vérification de la compatibilité avec la version 1.1.16 du SDK Maio.

Conçu et testé avec:

• SDK Google Mobile Ads version 23.0.0
• SDK Maio version 1.1.16.

Version 1.1.16.2

• Adaptateur mis à jour pour utiliser la nouvelle classe VersionInfo.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 22.0.0.

Conçu et testé avec:

• SDK Google Mobile Ads version 22.0.0
• Version 1.1.16 du SDK Maio.

Version 1.1.16.1

• Mise à jour de compileSdkVersion et targetSdkVersion vers l'API 31.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 21.0.0.
• Mise à jour du niveau d'API Android minimal requis vers 19.

Compilé et testé avec :

• SDK Google Mobile Ads version 21.0.0
• Version 1.1.16 du SDK Maio.

Version 1.1.16.0

• Mise à jour des codes d'erreur pour capturer d'autres erreurs Maio.
• Vérification de la compatibilité avec la version 1.1.16 du SDK Maio.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.4.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 20.4.0.
• SDK Maio version 1.1.16.

Version 1.1.15.0

• Compatibilité vérifiée avec la version 1.1.15 du SDK maio.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.0.0.

Conçu et testé avec:

• Version 20.0.0 du SDK Google Mobile Ads
• SDK Maio version 1.1.15.

Version 1.1.14.0

• Ajout de codes et messages d'erreur standardisés pour les adaptateurs.
• Compatibilité validée avec la version 1.1.14 du SDK maio.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.8.0.

Conçu et testé avec:

• SDK Google Mobile Ads 19.8.0
• Version du SDK Maio 1.1.14.

Version 1.1.13.0

• Compatibilité vérifiée avec la version 1.1.13 du SDK maio.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.5.0.

Conçu et testé avec:

• SDK Google Mobile Ads version 19.5.0.
• SDK Maio version 1.1.13.

Version 1.1.12.0

• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.4.0.

Conçu et testé avec:

• SDK Google Mobile Ads version 19.4.0.
• SDK Maio version 1.1.12.

Version 1.1.11.1

• Pour limiter les délais avant expiration, les demandes d'annonces échouent désormais immédiatement si maio ne dispose pas d'annonce prête à être diffusée.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.1.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 19.1.0.
• Version du SDK Maio 1.1.11.

Version 1.1.11.0

• Compatibilité vérifiée avec la version 1.1.11 du SDK maio.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.3.0.

Conçu et testé avec:

• SDK Google Mobile Ads 18.3.0
• Version du SDK Maio 1.1.11.

Version 1.1.10.0

• Compatibilité vérifiée avec la version 1.1.10 du SDK maio.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 18.2.0.

Version 1.1.8.0

• Compatibilité validée avec la version 1.1.8 du SDK maio.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.1.0.

Version 1.1.7.0

• Corrections de bugs.
• Compatibilité vérifiée avec la version 1.1.7 du SDK maio.

Version 1.1.6.1

• Mise à jour de l'adaptateur pour prendre en charge la nouvelle API Récompense.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 17.2.0.

Version 1.1.6.0

• Compatibilité vérifiée avec la version 1.1.6 du SDK maio.

Version 1.1.5.0

• Compatibilité vérifiée avec la version 1.1.5 du SDK maio.

Version 1.1.4.0

• Vérification de la compatibilité avec la version 1.1.4 du SDK Maio.

Version 1.1.3.1

• Mise à jour de l'adaptateur pour qu'il fonctionne avec la classe d'instance au lieu du singleton.

Version 1.1.3.0

• La compatibilité avec la version 1.1.3 du SDK Maio a été vérifiée.

Version 1.1.2.1

• Mise à jour de l'adaptateur avec des fonctions d'initialisation mises à jour.

Version 1.1.2.0

• Compatibilité vérifiée avec la version 1.1.2 du SDK maio.

Version 1.1.1.1

• L'adaptateur a été mis à jour pour appeler l'événement d'annonce onRewardedVideoComplete().

Version 1.1.1.0

• Compatibilité validée avec la version 1.1.1 du SDK maio.

Version 1.1.0.0

• Compatibilité vérifiée avec la version 1.1.0 du SDK maio.

Version 1.0.8.0

• Compatibilité vérifiée avec la version 1.0.8 du SDK maio.

Version 1.0.7.1

• Correction d'un problème pouvant entraîner des erreurs NullPointerExceptions lorsque le chargement des annonces échoue.

Version 1.0.7.0

• Ajout de la possibilité d'activer le mode de test en ajoutant l'ID de l'appareil de test à AdRequest.
• La compatibilité avec la version 1.0.7 du SDK Maio a été vérifiée.

Version 1.0.6.0

• Première version !
• Ajout de la prise en charge des interstitiels et des annonces vidéo avec récompense.