Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces provenant de maio à l'aide de la médiation et de laintégration de la 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 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 leurs équivalents en anglais. "URL スキーム", par exemple, correspond à "URL Scheme".
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation pour maio présente 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
Dernière version du SDK Google Mobile Ads
Suivez le guide de démarrage de la médiation.
Étape 1: Configurer les configurations dans l'interface utilisateur de maio
Commencez par vous inscrire ou vous connecter à 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 votre application. Sélectionnez Annonce interstitielle vidéo comme Type d'annonce, puis cliquez sur Mettre à jour.
Avec récompense
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 multimédia. Vous en aurez besoin pour configurer votre bloc d'annonces Ad Manager dans la section suivante.
Sur la page Gestion des zones, notez l'ID de zone. Vous en aurez également besoin pour configurer votre bloc d'annonces Ad Manager dans la section suivante.
En plus de l'ID multimé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 API Reporting, notez l'ID de l'API et la clé API.Étape 2: Configurez la demande de mai dans l'interface utilisateur de Ad Manager
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, sélectionnez votre format d'annonce et définissez le type d'inventaire sur Application mobile. Dans la section Ciblage > Inventaire, sélectionnez le bloc d'annonces sous Inventaire et Application mobile auxquels vous souhaitez ajouter la médiation.
Cliquez ensuite sur le bouton Ajouter un partenaire de rendement.
Si vous avez déjà un partenaire de rendement pour maiô, vous pouvez le sélectionner. Sinon, sélectionnez Créer un partenaire de rendement.
Sélectionnez maio comme réseau publicitaire, saisissez un nom unique et activez la médiation.
Activez l'option Collecte automatique des données, puis saisissez l'ID de l'API et la clé API obtenus à la section précédente.
Une fois le Partenaire de rendement sélectionné, choisissez Médiation SDK pour mobile comme Type d'intégration, Android comme Plate-forme et Actif comme État. Saisissez l'ID de contenu et l'ID de zone obtenus à la section précédente. Saisissez ensuite une valeur pour le CPM par défaut.
Lorsque vous avez terminé, cliquez sur Enregistrer en bas de la page.
Étape 3: Importez le SDK et l'adaptateur de maiO
Intégration d'Android Studio (recommandée)
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 et de l'adaptateur maio:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
Intégration manuelle
- Téléchargez la dernière version du SDK Android maio et ajoutez-le à votre projet.
- Accédez aux artefacts de l'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, puis ajoutez-le à votre projet.
Étape 4: Ajoutez le code requis
Aucune modification de code n'est requise pour l'intégration de Maio sur Android.
Étape 5: Tester votre implémentation
Activer les annonces tests
Assurez-vous d'enregistrer votre appareil de test pour Ad Manager.
Les éditeurs qui utilisent la version 11.6.0 ou ultérieure du SDK Google Mobile Ads recevront automatiquement des annonces tests de la part de maio sur les téléphones et les tablettes enregistrés en tant que appareils de test lorsqu'ils effectueront des requêtes.
Valider les annonces tests
Pour vérifier que vous recevez des annonces de test provenant de maio, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces à l'aide de la ou des sources d'annonces maio (cascade 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:
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 lorsqu'une annonce ne parvient pas à se charger:
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 pour 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 d'activité. |
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 : 23.0.0.
- Compatibilité validée avec la version 1.1.16 du SDK maio.
Compilé et testé avec:
- SDK Google Mobile Ads version 23.0.0
- Version 1.1.16 du SDK Maio.
Version 1.1.16.2
- Mise à jour de l'adaptateur pour qu'il utilise la nouvelle classe
VersionInfo
. - Mise à jour de la version minimale requise du SDK Google Mobile Ads : 22.0.0.
Compilé 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
ettargetSdkVersion
vers l'API 31. - La version minimale requise du SDK Google Mobile Ads est désormais la 21.0.0.
- Mise à jour du niveau d'API Android minimal requis vers la version 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.
- Compatibilité validée avec la version 1.1.16 du SDK maio.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.4.0.
Compilé et testé avec:
- SDK Google Mobile Ads 20.4.0
- Version 1.1.16 du SDK Maio.
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.
Compilé et testé avec:
- Version 20.0.0 du SDK Google Mobile Ads
- Version du SDK Maio 1.1.15.
Version 1.1.14.0
- Ajout de codes et de 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 : 19.8.0.
Compilé 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.
Compilé et testé avec:
- SDK Google Mobile Ads 19.5.0
- Version 1.1.13 du SDK Maio
Version 1.1.12.0
- Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.4.0.
Compilé et testé avec:
- SDK Google Mobile Ads 19.4.0
- Version 1.1.12 du SDK Maio
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 : 19.1.0.
Compilé et testé avec:
- SDK Google Mobile Ads 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 : 18.3.0.
Compilé 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.
- La version minimale requise du SDK Google Mobile Ads est désormais 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 Rewarded
- 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
- Compatibilité validée 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
- Compatibilité vérifiée avec la version 1.1.3 du SDK maio.
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
- Mise à jour de l'adaptateur pour appeler l'événement d'annonce
onRewardedVideoComplete()
.
Version 1.1.1.0
- Compatibilité vérifié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
- Possibilité d'activer le mode test en ajoutant l'ID de l'appareil de test à
AdRequest
. - Compatibilité vérifiée avec la version 1.0.7 du SDK maio.
Version 1.0.6.0
- Première version !
- Prise en charge des interstitiels et des annonces vidéo avec récompense.