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, 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

• Dernière version du SDK Google Mobile Ads.

• Suivez le guide de démarrage sur la médiation.

É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.

Sur la page Gestion des applications, notez l'ID du contenu multimédia. Il est nécessaire pour configurer votre bloc d'annonces Ad Manager 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 Ad Manager 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 de l'API Reporting, notez l'ID de l'API et la clé API.

Étape 2 : Configurez la demande maio dans l'UI 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 auquel 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 maio, 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 Collecte des données automatisée, puis saisissez l'ID d'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, iOS comme plate-forme et Actif comme état. Saisissez l'ID du média et l'ID de la zone obtenus à la section précédente. Saisissez ensuite une valeur de CPM par défaut.

Lorsque vous avez terminé, cliquez sur Enregistrer en bas de la page.

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

Utiliser CocoaPods (recommandé)

• 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 Ad Manager.

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.