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, ce qui inclut les intégrations en cascade. Vous verrez 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 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", et ainsi de suite.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation AdMob pour maio offre les fonctionnalités suivantes:
| Intégration | |
|---|---|
| Enchères | |
| Cascade | |
| Formats | |
| Bannière | |
| Interstitiel | |
| Accordé | |
| Il s'agit de ma langue maternelle | |
Conditions requises
- Cible de déploiement iOS 12.0 ou version ultérieure
- [Pour les enchères]: adaptateur maio 1.5.8.0 ou version ultérieure (dernière version recommandée)
Le dernier SDK Google Mobile Ads
Suivez la procédure de 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
Enchères
Dans la fiche Enchères de la section Sources d'annonces, sélectionnez Ajouter une source d'annonce. Sélectionnez ensuite maio.
Cliquez sur Signer un contrat partenaire et configurer un partenariat d'enchères avecmaio.
Cliquez sur Confirmer et accepter, puis 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 Publisher IDobtenus à la section précédente. Cliquez ensuite sur Done (OK).
Important: Media ID doit être associé à l'application ciblée, comme dans l'maio UI.
Cascade
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
Utiliser CocoaPods (recommandé)
Ajoutez la ligne suivante au Podfile de votre projet:
pod 'GoogleMobileAdsMediationMaio'Depuis la ligne de commande, exécutez la commande suivante:
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à votre projet.
Étape 4: Ajoutez le code requis
Intégration SKAdNetwork
Suivez la documentation de maio pour ajouter les identifiants SKAdNetwork au fichier Info.plist de votre projet.
Étape 5: Testez 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 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 (Bidding) and 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 à partir de la réponse d'annonce à l'aide de
GADResponseInfo.adNetworkInfoArray
dans les classes suivantes:
| Format | Nom de la classe |
|---|---|
| Interstitiel | GADMMaioInterstitialAdapter |
| Accordé | GADMMaioRewardedAdapter |
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. Pour en savoir plus, consultez le code et la documentation de Maio. |
| 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". |
| 0-10 | maio a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez le code de maio. |
| 101 | maio n'a pas encore d'annonce disponible. |
| 102 | Paramètres de 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 de réseau. |
Journal des modifications de l'adaptateur de médiation iOS maio
Version 2.1.4.0
- Vérification de la compatibilité avec la version 2.1.4 du SDK Maio.
Conçu et testé avec:
- SDK Google Mobile Ads version 11.2.0.
- SDK Maio version 2.1.4.
Version 2.1.3.0
- La compatibilité avec la version 2.1.3 du SDK Maio a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 11.1.0.
- SDK Maio version 2.1.3.
Version 2.1.2.1
- Nécessite la version 11.0 ou ultérieure du SDK Google Mobile Ads.
- Ajout de
Info.plistaux frameworks dansMaioAdapter.xcframework.
Conçu et testé avec:
- SDK Google Mobile Ads version 11.0.1
- SDK Maio version 2.1.2.
Version 2.1.2.0
- Vérification de la compatibilité avec la version 2.1.2 du SDK Maio.
Conçu et testé avec:
- SDK Google Mobile Ads version 10.14.0.
- SDK Maio version 2.1.2.
Version 2.1.1.0
- Vérification de la compatibilité avec la version 2.1.1 du SDK Maio.
Conçu et testé avec:
- SDK Google Mobile Ads version 10.12.0.
- SDK Maio version 2.1.1.
Version 2.0.0.0
- Vérification de la compatibilité avec la version 2.0.0 du SDK Maio.
- Suppression de la dépendance à
MaioOB SDK. - Suppression de la compatibilité avec l'architecture
armv7. - Nécessite la version minimale d'iOS 12.0.
- Nécessite la version 10.4.0 ou ultérieure du SDK Google Mobile Ads.
Conçu et testé avec:
- SDK Google Mobile Ads version 10.10.0.
- SDK Maio version 2.0.0.
Version 1.6.3.1
- Nécessite la version 10.0.0 ou ultérieure du SDK Google Mobile Ads.
Conçu et testé avec:
- SDK Google Mobile Ads version 10.0.0.
- SDK Maio version 1.6.3.
- SDK MaioOB version 2.0.0-alpha.
Version 1.6.3.0
- Mise à jour de l'adaptateur pour utiliser l'API
didRewardUser. - Nécessite la version 9.8.0 ou ultérieure du SDK Google Mobile Ads.
- La compatibilité avec la version 1.6.3 du SDK maio et la version 2.0.0-alpha du SDK maioOB a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 9.12.0.
- SDK Maio version 1.6.3.
- SDK MaioOB version 2.0.0-alpha.
Version 1.6.2.0
- La compatibilité avec la version 1.6.2 du SDK maio et la version 2.0.0-alpha du SDK maioOB a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 9.5.0
- SDK Maio version 1.6.2.
- SDK MaioOB version 2.0.0-alpha.
Version 1.6.1.0
- La compatibilité avec la version 1.6.1 du SDK maio et la version 2.0.0-alpha du SDK maioOB a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 9.2.0.
- SDK Maio version 1.6.1.
- SDK MaioOB version 2.0.0-alpha.
Version 1.6.0.1
- La compatibilité avec la version 9.0.0 du SDK Google Mobile Ads a été validée.
- Nécessite la version 9.0.0 ou ultérieure du SDK Google Mobile Ads.
Conçu et testé avec:
- SDK Google Mobile Ads version 9.0.0
- SDK Maio version 1.6.0.
- SDK MaioOB version 2.0.0-alpha.
Version 1.6.0.0
- La compatibilité avec la version 1.6.0 du SDK maio et la version 2.0.0-alpha du SDK maioOB a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 8.13.0
- Nécessite désormais la version iOS 10.0 ou ultérieure.
- SDK Maio version 1.6.0.
- SDK MaioOB version 2.0.0-alpha.
Version 1.5.8.0
- La compatibilité avec la version 1.5.8 du SDK maio et la version 2.0.0-alpha du SDK maioOB a été vérifiée.
- Ajout d'une fonctionnalité d'enchères à l'adaptateur pour les formats d'annonces interstitielles et avec récompense.
- Dépendance assouplie au SDK Google Mobile Ads version 8.0.0 ou ultérieure.
Conçu et testé avec:
- SDK Google Mobile Ads version 8.7.0
- SDK Maio version 1.5.8.
- SDK MaioOB version 2.0.0-alpha.
Version 1.5.6.1
- Ajout de codes et messages d'erreur standardisés pour les adaptateurs.
- L'adaptateur a été mis à jour pour utiliser le format
.xcframework. - Correction d'un bug qui empêchait parfois le transfert des événements d'annonces avec récompense.
- Nécessite la version 8.3.0 ou ultérieure du SDK Google Mobile Ads.
Conçu et testé avec:
- SDK Google Mobile Ads version 8.3.0
- SDK Maio version 1.5.6.
Version 1.5.6.0
- Vérification de la compatibilité avec la version 1.5.6 du SDK Maio
- Nécessite la version 7.68.0 ou ultérieure du SDK Google Mobile Ads.
Conçu et testé avec:
- SDK Google Mobile Ads version 7.68.0
- SDK Maio version 1.5.6.
Version 1.5.5.0
- Vérification de la compatibilité avec la version 1.5.5 du SDK Maio.
- Nécessite la version 7.64.0 ou ultérieure du SDK Google Mobile Ads.
Conçu et testé avec:
- SDK Google Mobile Ads version 7.64.0
- SDK Maio version 1.5.5.
Version 1.5.4.0
- Vérification de la compatibilité avec la version 1.5.4 du SDK Maio.
- Nécessite la version 7.60.0 ou ultérieure du SDK Google Mobile Ads.
Conçu et testé avec:
- SDK Google Mobile Ads version 7.60.0
- SDK Maio version 1.5.4.
Version 1.5.3.1
- Pour limiter les délais avant expiration, les demandes d'annonces échoueront immédiatement si maio ne dispose pas d'une annonce prête à être diffusée.
- Suppression de la compatibilité avec l'architecture i386.
Conçu et testé avec:
- SDK Google Mobile Ads version 7.58.0
- SDK Maio version 1.5.3.
Version 1.5.3.0
- Vérification de la compatibilité avec la version 1.5.3 du SDK Maio.
Conçu et testé avec:
- SDK Google Mobile Ads version 7.55.1
- SDK Maio version 1.5.3.
Version 1.5.2.1
- Correction d'un problème qui empêchait l'adaptateur d'appeler le rappel
-rewardedAdDidPresent:.
Conçu et testé avec:
- SDK Google Mobile Ads version 7.53.1
- SDK Maio version 1.5.2.
Version 1.5.2.0
- Vérification de la compatibilité avec la version 1.5.2 du SDK Maio.
Conçu et testé avec:
- SDK Google Mobile Ads version 7.53.1
- SDK Maio version 1.5.2.
Version 1.5.1.0
- La compatibilité avec la version 1.5.1 du SDK Maio a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 7.52.0
- SDK Maio version 1.5.1.
Version 1.5.0.0
- La compatibilité avec la version 1.5.0 du SDK Maio a été vérifiée.
Conçu et testé avec
- SDK Google Mobile Ads version 7.51.0
- SDK Maio Ads version 1.5.0
Version 1.4.8.0
- Vérification de la compatibilité avec la version 1.4.8 du SDK Maio
Version 1.4.6.0
- Vérification de la compatibilité avec la version 1.4.6 du SDK Maio
- L'adaptateur a été mis à jour pour utiliser la nouvelle API avec récompense.
- Nécessite la version 7.42.2 ou ultérieure du SDK Google Mobile Ads.
Version 1.4.2.0
- La compatibilité avec la version 1.4.2 du SDK Maio a été vérifiée.
Version 1.4.1.0
- La compatibilité avec la version 1.4.1 du SDK Maio a été vérifiée.
- Correction d'un problème qui empêchait l'adaptateur Maio si plusieurs MediaIds étaient fournis à partir d'AdMob.
Version 1.4.0.0
- La compatibilité avec la version 1.4.0 du SDK Maio a été vérifiée.
Version 1.3.2.0
- La compatibilité avec la version 1.3.2 du SDK Maio a été vérifiée.
Version 1.3.1.1
- Ajout du rappel
adapterDidCompletePlayingRewardBasedVideoAd:à l'adaptateur.
Version 1.3.1.0
- La compatibilité avec la version 1.3.1 du SDK Maio a été vérifiée.
Version 1.3.0.0
- La compatibilité avec la version 1.3.0 du SDK Maio a été vérifiée.
Version 1.2.19.0
- Vérification de la compatibilité avec la version 1.2.19 du SDK Maio.
Version 1.2.18.0
- Première version !
- Les interstitiels et les annonces vidéo avec récompense sont désormais acceptés.