Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher annonces de maio utilisant Médiation AdMob, sur les intégrations de cascades d'annonces. Vous verrez comment ajouter maio configuration de médiation, et comment intégrer le SDK Maio et l'adaptateur dans un Android application.
L'interface du tableau de bord de maio utilise du texte en japonais pour ses étiquettes, ses 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 référencés par leurs équivalents en anglais. "URL ム ー ム", Exemple : est "Schéma d'URL".
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation pour maio offre les fonctionnalités suivantes:
Intégration | |
---|---|
Enchères | |
Cascade | |
Formats | |
Bannière | |
Interstitiel | |
Avec récompense | |
Natif |
Conditions requises
- Niveau d'API Android 21 ou supérieur
- SDK maio 1.0.7 ou version ultérieure
Le dernier SDK Google Mobile Ads
Finaliser la médiation Guide de démarrage
É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 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.
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.
Sur la page Gestion des applications, notez l'ID média. Vous devrez configurer votre AdMob 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 AdMob bloc d'annonces dans la section suivante.
Étape 2: Configurez la demande Maio dans AdMob l'UI
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.
Sélectionnez maio et activez le bouton Optimiser. Saisissez l' API ID and API KEY obtenue à la section précédente pour configurer l'optimisation de la source d'annonces pour maio. Ensuite, saisissez une valeur d'eCPM pour maio et cliquez sur Continuer.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: Importez le SDK Maio et l'adaptateur
Intégration d'Android Studio (recommandé)
Dans le fichier settings.gradle.kts
au niveau du projet, ajoutez ce qui suit :
des dépôts:
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 ce qui suit :
les dépendances et configurations d'implémentation. Utilisez les dernières versions de la
SDK Maio et adaptateur:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Intégration manuelle
- Téléchargez la dernière version de SDK maio Android et ajoutez à votre projet.
- Accédez aux artefacts d'adaptateur maio dans le dépôt Maven de Google. Sélectionnez la dernière version et téléchargez le fichier ".aar" de l'adaptateur Maio. et l'ajouter à votre projet.
Étape 4: Ajoutez le code requis
Aucun code supplémentaire n'est requis pour l'intégration à Android maio.
Étape 5: Testez 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 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 |
Avec récompense | 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. Voir le code et la documentation de Maio pour en savoir plus. |
101 | Maio n'a aucune annonce disponible. |
102 | Paramètres de serveur non valides (ID d'emplacement manquant, par exemple). |
103 | Le contexte utilisé pour charger une annonce n'était pas une instance "Activity". |
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 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
ettargetSdkVersion
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 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 plus d'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.
Conçu et testé avec:
- SDK Google Mobile Ads version 20.4.0.
- SDK Maio version 1.1.16.
Version 1.1.15.0
- La compatibilité avec la version 1.1.15 du SDK Maio a été vérifiée.
- 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 messages d'erreur standardisés pour les adaptateurs.
- La compatibilité avec la version 1.1.14 du SDK Maio a été vérifiée.
- 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
- La compatibilité avec la version 1.1.13 du SDK Maio a été vérifiée.
- 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
- Pour limiter ces délais, les demandes d'annonces échouent immédiatement si maio ne dispose pas d'une 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
- La compatibilité avec la version 1.1.11 du SDK Maio a été vérifiée.
- 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
- La compatibilité avec la version 1.1.10 du SDK Maio a été vérifiée.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.2.0.
Version 1.1.8.0
- La compatibilité avec la version 1.1.8 du SDK Maio a été vérifiée.
- 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.
- Vérification de la compatibilité 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 vers la version 17.2.0.
Version 1.1.6.0
- Vérification de la compatibilité avec la version 1.1.6 du SDK Maio.
Version 1.1.5.0
- Vérification de la compatibilité avec la version 1.1.5 du SDK Maio.
Version 1.1.4.0
- La compatibilité avec la version 1.1.4 du SDK Maio a été vérifiée.
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 les fonctions d'initialisation mises à jour.
Version 1.1.2.0
- La compatibilité avec la version 1.1.2 du SDK Maio a été vérifiée.
Version 1.1.1.1
- L'adaptateur a été mis à jour pour appeler l'événement d'annonce
onRewardedVideoComplete()
.
Version 1.1.1.0
- La compatibilité avec la version 1.1.1 du SDK Maio a été vérifiée.
Version 1.1.0.0
- La compatibilité avec la version 1.1.0 du SDK Maio a été vérifiée.
Version 1.0.8.0
- Vérification de la compatibilité avec la version 1.0.8 du SDK Maio.
Version 1.0.7.1
- Correction d'un problème qui pouvait entraîner l'apparition de NullPointerExceptions en cas d'échec des annonces à charger.
Version 1.0.7.0
- Ajout de la possibilité d'activer le mode test en ajoutant l'ID de l'appareil de test à
AdRequest
. - Vérification de la compatibilité avec la version 1.0.7 du SDK Maio.
Version 1.0.6.0
- Première version !
- Les interstitiels et les annonces vidéo avec récompense sont désormais acceptés.