Intégrer Maio à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces de maio à l'aide de la médiation AdMob, en couvrant 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 à une application iOS.

L'interface du tableau de bord de maio utilise du texte japonais pour ses libellés, ses boutons et ses 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. Par exemple, "URL スキーム" devient "URL Scheme".

Intégrations et formats d'annonces acceptés

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

Étape 1 : Configurez les configurations dans l'UI de maio

Tout d'abord, inscrivez-vous ou connectez-vous à 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 l'application. Sélectionnez Vidéo interstitielle 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 l'application. Sélectionnez Vidéo avec récompense comme type d'annonce, puis cliquez sur Mettre à jour.

Sur la page Gestion des applications, notez l'ID du contenu multimédia. Il est nécessaire pour configurer votre bloc d'annonces AdMob dans la section suivante.

Sur la page Gestion des zones, notez l'ID de la zone. Il sera également nécessaire pour configurer votre bloc d'annonces AdMob dans la section suivante.

(Cascade uniquement) En plus de l'ID du média et de l'ID de la zone, vous aurez besoin de l'ID de l'API et de la clé API pour configurer l'ID de votre bloc d'annonces pour la médiation. Sur la page Reporting API, notez l'ID de l'API et la clé API.

Étape 2 : Configurer la demande maio dans l'UI AdMob

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.

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 l'éditer, puis passez à la section 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 et la plate-forme de votre annonce, puis cliquez sur Continuer.

Attribuez un nom à votre groupe de médiation et sélectionnez les zones géographiques à cibler. Ensuite, définissez 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 être remplie avec les blocs d'annonces que vous avez sélectionnés :

Ajouter maio comme source d'annonces


Dans la fiche Cascade de la section Sources d'annonces, sélectionnez Ajouter une source d'annonce.

Sélectionnez maio et activez l'option Optimize (Optimiser). Saisissez l'ID d'API et la clé API obtenus dans la section précédente pour configurer l'optimisation de la source d'annonces pour maio. Saisissez ensuite une valeur d'eCPM pour maio, puis cliquez sur Continuer.



Si vous avez déjà un mappage pour maio, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.

Ensuite, saisissez l'ID du média et l'ID de la zone obtenus dans la section précédente. Cliquez ensuite sur OK.


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

  • Ajoutez la ligne suivante au fichier 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 à 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

Assurez-vous d'enregistrer votre appareil de test pour AdMob.

Les éditeurs qui utilisent la version 7.26.0 ou ultérieure du SDK Google Mobile Ads recevront automatiquement des annonces tests de maio sur les téléphones et tablettes enregistrés comme appareils de test lorsqu'ils effectueront des demandes.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests de maio, activez le test d'une source d'annonces spécifique dans l'inspecteur d'annonces à l'aide de la ou des sources d'annonces maio (cascade).

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir d'annonce de maio, les éditeurs peuvent vérifier l'erreur sous-jacente à partir 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 maio ne dispose pas encore d'annonce.
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 maio iOS

Version suivante

  • Activez -fobjc-arc et -fstack-protector-all.

Version 2.1.6.1

  • Nécessite désormais le SDK Google Mobile Ads version 12.0.0 ou ultérieure.

Conçu et testé avec :

  • SDK Google Mobile Ads version 12.0.0.
  • Version 2.1.6 du SDK Maio.

Version 2.1.6.0

  • Compatibilité vérifiée avec la version 2.1.6 du SDK maio.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.13.0.
  • Version 2.1.6 du SDK Maio.

Version 2.1.5.1

  • Mise à jour de CFBundleShortVersionString pour qu'il comporte trois composants au lieu de quatre.

Conçu 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.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.6.0.
  • Version 2.1.5 du SDK Maio.

Version 2.1.4.0

  • Compatibilité vérifiée avec la version 2.1.4 du SDK maio.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.2.0.
  • 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.

Conçu 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 version 11.0 ou ultérieure.
  • Incluez Info.plist dans les frameworks de MaioAdapter.xcframework.

Conçu 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.

Conçu et testé avec :

  • SDK Google Mobile Ads version 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.

Conçu et testé avec :

  • SDK Google Mobile Ads version 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 vis-à-vis de MaioOB SDK.
  • Suppression de la compatibilité avec l'architecture armv7.
  • La version minimale d'iOS requise est désormais la version 12.0.
  • Nécessite désormais le SDK Google Mobile Ads version 10.4.0 ou ultérieure.

Conçu et testé avec :

  • SDK Google Mobile Ads version 10.10.0.
  • Version 2.0.0 du SDK Maio.

Version 1.6.3.1

  • Nécessite désormais le SDK Google Mobile Ads version 10.0.0 ou ultérieure.

Conçu et testé avec :

  • SDK Google Mobile Ads version 10.0.0.
  • Version 1.6.3 du SDK Maio.
  • Version 2.0.0-alpha du SDK MaioOB.

Version 1.6.3.0

  • L'adaptateur a été mis à jour pour utiliser l'API didRewardUser.
  • Nécessite désormais le SDK Google Mobile Ads version 9.8.0 ou ultérieure.
  • Compatibilité vérifiée avec la version 1.6.3 du SDK maio et la version 2.0.0-alpha du SDK maioOB.

Conçu 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 la version 1.6.2 du SDK maio et la version 2.0.0-alpha du SDK maioOB.

Conçu 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 la version 1.6.1 du SDK maio et la version 2.0.0-alpha du SDK maioOB.

Conçu et testé avec :

  • SDK Google Mobile Ads version 9.2.0.
  • 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 le SDK Google Mobile Ads version 9.0.0.
  • Nécessite désormais le SDK Google Mobile Ads version 9.0.0 ou ultérieure.

Conçu 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 la version 1.6.0 du SDK maio et la version 2.0.0-alpha du SDK maioOB.

Conçu et testé avec :

  • SDK Google Mobile Ads version 8.13.0.
  • Nécessite désormais la version 10.0 d'iOS au minimum.
  • 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 la version 1.5.8 du SDK maio et la version 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 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.
  • 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 l'adaptateur.
  • 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 désormais le SDK Google Mobile Ads version 8.3.0 ou ultérieure.

Conçu et testé avec :

  • SDK Google Mobile Ads version 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 version 7.68.0 ou ultérieure.

Conçu et testé avec :

  • SDK Google Mobile Ads version 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 version 7.64.0 ou ultérieure.

Conçu et testé avec :

  • SDK Google Mobile Ads version 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 version 7.60.0 ou ultérieure.

Conçu et testé avec :

  • SDK Google Mobile Ads version 7.60.0.
  • Version 1.5.4 du SDK Maio.

Version 1.5.3.1

  • Pour limiter les délais d'expiration, les demandes d'annonces échoueront désormais immédiatement si maio n'a pas d'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.
  • 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.

Conçu 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:.

Conçu 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.

Conçu 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.

Conçu 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.

Conçu et testé avec

  • SDK Google Mobile Ads version 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.
  • L'adaptateur a été mis à jour pour utiliser la nouvelle API de récompense.
  • Nécessite désormais le SDK Google Mobile Ads version 7.42.2 ou ultérieure.

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 MediaId étaient fournis par 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 !
  • Ajout de la compatibilité avec les annonces interstitielles et vidéo avec récompense.