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 AdMob, 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 applicationiOS .
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
- Cible de déploiement iOS 12.0 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 AdMob 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 AdMob dans la section suivante.
(Cascade uniquement) En plus de l'ID de 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 API Reporting, notez l'ID de l'API et la clé API.É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 médiation de votre bloc d'annonces.
Commencez par vous connecter à 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 à la section Ajouter maio en tant que source d'annonces.
Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.
Saisissez le format et la plate-forme de votre annonce, 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'annonces AdMob existants. Cliquez ensuite sur OK.
La fiche "Blocs d'annonces" doit maintenant afficher les blocs d'annonces que vous avez sélectionnés:
Ajouter maio comme source d'annonces
Sous la fiche Cascade d'annonces, dans la section Sources d'annonces, sélectionnez Ajouter une source d'annonces. Sélectionnez ensuite maio.
Sélectionnez maio et activez l'option Optimiser. Saisissez l'ID d'API et la clé API obtenus dans la section précédente pour configurer l'optimisation des sources d'annonces pour maiô. Saisissez ensuite une valeur d'eCPM pour maiô, puis cliquez sur Continuer.
Si vous avez déjà un mappage pour maiô, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.
Saisissez ensuite les ID de contenu et ID de zone obtenus dans la section précédente. Cliquez ensuite sur OK.
Étape 3: Importez le SDK et l'adaptateur de maiO
Utiliser CocoaPods (recommandé)
Ajoutez la ligne suivante au Podfile de votre projet:
pod 'GoogleMobileAdsMediationMaio'
Depuis la ligne de commande, exécutez:
pod install --repo-update
Intégration manuelle
- Téléchargez la dernière version du SDK maio.
- Téléchargez la dernière version de l'adaptateur maio à partir du lien de téléchargement dans le journal des modifications, puis associez
maioAdapter.framework
dans votre projet.
Étape 4: Ajoutez le code requis
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 tests
Veillez à enregistrer votre appareil de test pour AdMob.
Les éditeurs qui utilisent la version 7.26.0 ou ultérieure du SDK Google Mobile Ads reçoivent 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 envoient 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
GADResponseInfo.adNetworkInfoArray
sous les classes suivantes:
Format | Nom de la classe |
---|---|
Interstitiel | GADMMaioInterstitialAdapter |
Avec récompense | GADMMaioRewardedAdapter |
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 de maio. |
101 | Aucune annonce n'est encore disponible pour 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 de réseau. |
Journal des modifications de l'adaptateur de médiation iOS maio
Version 2.1.5.1
- Modification de
CFBundleShortVersionString
pour qu'il comporte trois composants au lieu de quatre.
Compilé et testé avec:
- SDK Google Mobile Ads version 11.10.0
- Version 2.1.5 du SDK Maio
Version 2.1.5.0
- Compatibilité vérifiée avec la version 2.1.5 du SDK maio.
Compilé et testé avec:
- SDK Google Mobile Ads 11.6.0
- Version 2.1.5 du SDK Maio
Version 2.1.4.0
- Compatibilité validée avec la version 2.1.4 du SDK maio.
Compilé et testé avec:
- Version 11.2.0 du SDK Google Mobile Ads
- Version 2.1.4 du SDK Maio.
Version 2.1.3.0
- Compatibilité vérifiée avec la version 2.1.3 du SDK maio.
Compilé et testé avec:
- SDK Google Mobile Ads version 11.1.0
- Version 2.1.3 du SDK Maio
Version 2.1.2.1
- Nécessite désormais le SDK Google Mobile Ads 11.0 ou version ultérieure.
Info.plist
inclus dans les frameworks deMaioAdapter.xcframework
.
Compilé et testé avec:
- SDK Google Mobile Ads version 11.0.1
- Version 2.1.2 du SDK Maio
Version 2.1.2.0
- Compatibilité vérifiée avec la version 2.1.2 du SDK maio.
Compilé et testé avec:
- SDK Google Mobile Ads 10.14.0
- Version 2.1.2 du SDK Maio
Version 2.1.1.0
- Compatibilité vérifiée avec la version 2.1.1 du SDK maio.
Compilé et testé avec:
- SDK Google Mobile Ads 10.12.0
- Version 2.1.1 du SDK Maio
Version 2.0.0.0
- Compatibilité vérifiée avec la version 2.0.0 du SDK maio.
- Suppression de la dépendance envers
MaioOB SDK
. - Suppression de la compatibilité avec l'architecture
armv7
. - La version minimale d'iOS requise est désormais la 12.0.
- Nécessite désormais le SDK Google Mobile Ads 10.4.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads 10.10.0
- Version 2.0.0 du SDK Maio
Version 1.6.3.1
- Nécessite désormais le SDK Google Mobile Ads 10.0.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads 10.0.0
- Version 1.6.3 du SDK Maio
- Version 2.0.0-alpha du SDK MaioOB.
Version 1.6.3.0
- Mise à jour de l'adaptateur pour qu'il utilise l'API
didRewardUser
. - Nécessite désormais le SDK Google Mobile Ads 9.8.0 ou version ultérieure.
- Compatibilité vérifiée avec les versions 1.6.3 et 2.0.0-alpha du SDK maio et du SDK maioOB.
Compilé et testé avec:
- SDK Google Mobile Ads version 9.12.0
- Version 1.6.3 du SDK Maio
- Version 2.0.0-alpha du SDK MaioOB.
Version 1.6.2.0
- Compatibilité vérifiée avec les versions 1.6.2 et 2.0.0-alpha du SDK maio et du SDK maioOB.
Compilé et testé avec:
- SDK Google Mobile Ads version 9.5.0
- Version 1.6.2 du SDK Maio
- Version 2.0.0-alpha du SDK MaioOB.
Version 1.6.1.0
- Compatibilité vérifiée avec les versions 1.6.1 et 2.0.0-alpha du SDK maio et du SDK maioOB.
Compilé et testé avec:
- Version 9.2.0 du SDK Google Mobile Ads
- Version 1.6.1 du SDK Maio
- Version 2.0.0-alpha du SDK MaioOB.
Version 1.6.0.1
- Compatibilité vérifiée avec la version 9.0.0 du SDK Google Mobile Ads.
- Nécessite désormais le SDK Google Mobile Ads 9.0.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads version 9.0.0
- Version 1.6.0 du SDK Maio
- Version 2.0.0-alpha du SDK MaioOB.
Version 1.6.0.0
- Compatibilité vérifiée avec les versions 1.6.0 et 2.0.0-alpha du SDK maio et du SDK maioOB.
Compilé et testé avec:
- SDK Google Mobile Ads 8.13.0
- La version minimale d'iOS est désormais la 10.0.
- Version 1.6.0 du SDK Maio
- Version 2.0.0-alpha du SDK MaioOB.
Version 1.5.8.0
- Compatibilité vérifiée avec les versions 1.5.8 du SDK maio et 2.0.0-alpha du SDK maioOB.
- Ajout de la fonctionnalité d'enchères à l'adaptateur pour les formats d'annonces interstitielles et avec récompense.
- Dépendance allégée vers la version 8.0.0 ou ultérieure du SDK Google Mobile Ads.
Compilé et testé avec:
- SDK Google Mobile Ads 8.7.0
- Version 1.5.8 du SDK Maio
- Version 2.0.0-alpha du SDK MaioOB.
Version 1.5.6.1
- Ajout de codes et de messages d'erreur standardisés pour les adaptateurs.
- Mise à jour de l'adaptateur pour utiliser le format
.xcframework
. - Correction d'un bug qui empêchait parfois la transmission des événements d'annonces avec récompense.
- Nécessite désormais le SDK Google Mobile Ads 8.3.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads 8.3.0
- Version 1.5.6 du SDK Maio.
Version 1.5.6.0
- Compatibilité vérifiée avec la version 1.5.6 du SDK maio.
- Nécessite désormais le SDK Google Mobile Ads 7.68.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads 7.68.0
- Version 1.5.6 du SDK Maio.
Version 1.5.5.0
- Compatibilité vérifiée avec la version 1.5.5 du SDK maio.
- Nécessite désormais le SDK Google Mobile Ads 7.64.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads 7.64.0
- Version 1.5.5 du SDK Maio
Version 1.5.4.0
- Compatibilité vérifiée avec la version 1.5.4 du SDK maio.
- Nécessite désormais le SDK Google Mobile Ads 7.60.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads 7.60.0
- Version 1.5.4 du SDK Maio
Version 1.5.3.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.
- Suppression de la compatibilité avec l'architecture i386.
Compilé et testé avec:
- SDK Google Mobile Ads 7.58.0
- Version 1.5.3 du SDK Maio.
Version 1.5.3.0
- Compatibilité vérifiée avec la version 1.5.3 du SDK maio.
Compilé et testé avec:
- SDK Google Mobile Ads version 7.55.1
- Version 1.5.3 du SDK Maio.
Version 1.5.2.1
- Correction d'un problème qui empêchait l'adaptateur d'appeler le rappel
-rewardedAdDidPresent:
.
Compilé et testé avec:
- Version 7.53.1 du SDK Google Mobile Ads
- Version 1.5.2 du SDK Maio
Version 1.5.2.0
- Compatibilité vérifiée avec la version 1.5.2 du SDK maio.
Compilé et testé avec:
- Version 7.53.1 du SDK Google Mobile Ads
- Version 1.5.2 du SDK Maio
Version 1.5.1.0
- Compatibilité vérifiée avec la version 1.5.1 du SDK maio.
Compilé et testé avec:
- SDK Google Mobile Ads version 7.52.0.
- Version 1.5.1 du SDK Maio.
Version 1.5.0.0
- Compatibilité vérifiée avec la version 1.5.0 du SDK maio.
Compilé et testé avec
- SDK Google Mobile Ads 7.51.0
- Version 1.5.0 du SDK Maio Ads
Version 1.4.8.0
- Compatibilité vérifiée avec la version 1.4.8 du SDK maio.
Version 1.4.6.0
- Compatibilité vérifiée avec la version 1.4.6 du SDK maio.
- Mise à jour de l'adaptateur pour qu'il utilise la nouvelle API de récompenses.
- Nécessite désormais la version 7.42.2 ou ultérieure du SDK Google Mobile Ads.
Version 1.4.2.0
- Compatibilité vérifiée avec la version 1.4.2 du SDK maio.
Version 1.4.1.0
- Compatibilité vérifiée avec la version 1.4.1 du SDK maio.
- Correction d'un problème qui pouvait entraîner l'échec de l'adaptateur maio si plusieurs MediaIds étaient fournis à partir d'AdMob.
Version 1.4.0.0
- Compatibilité vérifiée avec la version 1.4.0 du SDK maio.
Version 1.3.2.0
- Compatibilité vérifiée avec la version 1.3.2 du SDK maio.
Version 1.3.1.1
- Ajout du rappel
adapterDidCompletePlayingRewardBasedVideoAd:
à l'adaptateur.
Version 1.3.1.0
- Compatibilité vérifiée avec la version 1.3.1 du SDK maio.
Version 1.3.0.0
- Compatibilité vérifiée avec la version 1.3.0 du SDK maio.
Version 1.2.19.0
- Compatibilité vérifiée avec la version 1.2.19 du SDK maio.
Version 1.2.18.0
- Première version !
- Prise en charge des interstitiels et des annonces vidéo avec récompense.