Intégrer Maio à la médiation

Ce guide explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces depuis maio à l'aide de la médiation, qui couvre 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 applicationAndroid .

L'interface du tableau de bord de maio utilise du texte en japonais pour ses libellés, boutons et descriptions, et 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 leurs équivalents en langue anglaise. Par exemple, "URL ス溴ーム", par exemple, "schéma d'URL", et ainsi de suite.

Intégrations et formats d'annonces compatibles

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

Intégration
Enchères
Cascade
Formats
Bannière
Interstitiel
Accordé
Natif

Conditions requises

• Niveau d'API Android 19 ou supérieur

• SDK maio 1.0.7 ou version ultérieure

• Dernier SDK Google Mobile Ads

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

Étape 1: Définissez les configurations dans l'interface utilisateur maio

Tout d'abord, inscrivez-vous ou connectez-vous à votre compte Maio. Cliquez sur le bouton Gestion des applications dans la barre latérale 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 votre application. Sélectionnez Interstitiel vidéo comme Type d'annonce, puis cliquez sur Mettre à jour.

Remarque:Les annonces interstitielles de maio sont désactivables par défaut.

Accordé

Saisissez le nom de votre application, sélectionnez la plate-forme et indiquez l'URL de votre application. Sélectionnez Récompenses vidéo comme Type d'annonce, puis cliquez sur Mettre à jour.

Remarque:Par défaut, les annonces vidéo avec récompense de maio ne sont PAS désactivables.

Sur la page Gestion des applications, notez l'ID média. Vous devrez configurer votre Ad Manager bloc d'annonces dans la section suivante.

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

En plus de l'ID de l'élément multimédia et de l'ID de la zone, vous aurez besoin de l'ID d'API et d'une clé API afin de configurer l'ID de votre bloc d'annonces pour la médiation. Sur la page API Reporting, notez l'ID d'API et la clé API.

Remarque: Si vous configurez votre compte maio pour la première fois, vous devrez peut-être contacter l'équipe d'assistance maio pour obtenir votre ID d'API et votre clé API.

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

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

Connectez-vous à votre compte Ad Manager.

Accédez à Diffusion > Groupes de rendement, puis cliquez sur le bouton Nouveau groupe de rendement.

Attribuez un nom unique à votre groupe de rendement, définissez l'état sur Actif, puis le format d'annonce et le type d'inventaire sur Application mobile. Dans la section Ciblage > Inventaire, sélectionnez le bloc d'annonces auquel vous souhaitez ajouter une médiation sous Inventaire et Application mobile.

Cliquez ensuite sur le bouton Ajouter un partenaire de rendement.

Si vous disposez déjà d'un partenaire de rendement pourmaio, vous pouvez le sélectionner. Sinon, sélectionnez Créer un partenaire de rendement.

Sélectionnez maio en tant que réseau publicitaire, saisissez un nom unique et activez la médiation.

Activez la collecte des données automatique et saisissez leAPI ID and API KEYobtenu à la section précédente.

Une fois que vous avez sélectionné Partenaire de rendement, sélectionnez Médiation SDK pour mobile comme type d'intégration, Android comme Plate-forme et Actif comme État. Saisissez leMedia ID and Zone ID obtenu dans la section précédente. Saisissez ensuite une valeur dans le champ CPM par défaut.

Important :Le Media ID doit être associé à l'application ciblée, comme dans l'UImaio .

Lorsque vous avez terminé, cliquez sur Enregistrer en bas de la page.

Remarque :La collecte automatique des données prend quelques jours avant de pouvoir calculer avec précision une valeur de CPM dynamique pour un réseau de médiation. Une fois l'eCPM calculé, il sera automatiquement mis à jour en votre nom.

Étape 3: Importez le SDK maio et l'adaptateur

Remarque :Si vous n'intégrez pas les versions compatibles du SDK Google Mobile Ads et du SDK Google Mobile Ads, vous risquez de rencontrer des problèmes de compilation.

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 dépendances et configurations d'implémentation suivantes. Utilisez les dernières versions du SDK majeur et de l'adaptateur:

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

Intégration manuelle

• Téléchargez la dernière version du SDK maio pour Android 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 dans maio avec Android.

Étape 5: Testez votre implémentation

Activer les annonces tests

Veillez à enregistrer votre appareil de test pour Ad Manager.

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.

Important :Désactivez le mode test pour Ad Manager etmaio avant de publier votre application.

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 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.getAdapterResponses() dans les classes suivantes:

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

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:

Code d'erreur	Motif
0-10	maio a renvoyé une erreur spécifique au SDK. Consultez le code et la documentation de maio pour plus d'informations.
101	Maio n'a aucune annonce disponible.
102	Paramètres serveur non valides (ID d'emplacement manquant, par exemple).
103	Le contexte utilisé pour charger une annonce n'était pas une instance "Activity".
0-10	maio a renvoyé une erreur spécifique au SDK. Consultez le code de Maio pour plus d'informations.
101	maio ne dispose pas encore d'annonce.
102	Paramètres serveur non valides (ID d'emplacement manquant, par exemple).
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 Android Maio

Version suivante

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

Version 1.1.16.2

• Mise à jour de l'adaptateur pour utiliser la nouvelle classe VersionInfo.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.0.0.

Conçu et testé avec:

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

Version 1.1.16.1

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

Conçu et testé avec:

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

Version 1.1.16.0

• Mise à jour des codes d'erreur pour capturer d'autres erreurs maio.
• Compatibilité vérifiée avec le SDK maio version 1.1.16.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.4.0.

Conçu 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 le SDK maio version 1.1.15.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.0.0.

Conçu et testé avec:

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

Version 1.1.14.0

• Ajout de codes et de messages d'erreur standardisés pour les adaptateurs.
• Compatibilité vérifiée avec le SDK maio version 1.1.14.
• 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 version 19.8.0.
• SDK Maio version 1.1.14.

Version 1.1.13.0

• Compatibilité vérifiée avec le SDK maio version 1.1.13.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 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

• Afin de limiter les délais d'attente, les demandes d'annonces échoueront immédiatement si maio ne dispose d'aucune annonce prête à être diffusée.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.1.0.

Conçu et testé avec:

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

Version 1.1.11.0

• Compatibilité vérifiée avec le SDK maio version 1.1.11.
• 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 version 18.3.0.
• SDK Maio version 1.1.11.

Version 1.1.10.0

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

Version 1.1.8.0

• Compatibilité vérifiée avec le SDK maio version 1.1.8.
• 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 le SDK maio version 1.1.7.

Version 1.1.6.1

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

Version 1.1.6.0

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

Version 1.1.5.0

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

Version 1.1.4.0

• Compatibilité vérifiée avec le SDK maio version 1.1.4

Version 1.1.3.1

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

Version 1.1.3.0

• Compatibilité vérifiée avec le SDK maio version 1.1.3

Version 1.1.2.1

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

Version 1.1.2.0

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

Version 1.1.1.1

• Mise à jour de l'adaptateur pour appeler l'événement d'annonce onRewardedVideoComplete().

Version 1.1.1.0

• Compatibilité vérifiée avec le SDK maio version 1.1.1.

Version 1.1.0.0

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

Version 1.0.8.0

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

Version 1.0.7.1

• Correction d'un problème qui pouvait entraîner l'apparition de NullPointerExceptions en cas d'échec du chargement des annonces.

Version 1.0.7.0

• Ajout de la possibilité d'activer le mode test en ajoutant l'ID de l'appareil de test à AdRequest.
• Compatibilité vérifiée avec le SDK maio version 1.0.7.

Version 1.0.6.0

• Première version !
• Ajout de la compatibilité avec les interstitiels et les annonces vidéo avec récompense.