Intégrer Maio à la médiation

Ce guide explique comment utiliser Google Mobile Ads SDK pour charger et afficher des annonces maio à l'aide de la médiation AdMob. Il aborde notamment les intégrations en cascade. Vous apprendrez à ajouter maio à la configuration de médiation d'un bloc d'annonces et à intégrer le SDK maio et son adaptateur dans 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. "URL スキーム" par exemple, signifie "schéma d'URL".

Intégrations et formats d'annonces pris en charge

L'adaptateur de médiation pour maio offre les fonctionnalités suivantes :

Intégration
Enchères
Cascade
Formats
Bannière
Interstitiel
Accordé
Natif

Prérequis

Avant de continuer, vérifiez les points suivants :

• Cible de déploiement iOS 15.0 ou version ultérieure

• Dernière version de Google Mobile Ads SDK.

• Configurez la médiation AdMob.

Étape 1 : Configurer les paramètres dans l'UI maio

Tout d'abord, inscrivez-vous ou connectez-vous à votre compte maio. Cliquez sur le bouton Application management (Gestion des applications) dans la barre latérale de gauche, puis sur New app (Nouvelle application).

Sélectionnez l'onglet correspondant au type d'annonce de votre choix.

Sur la page Gestion des applications, notez l'ID d'élément multimédia. Vous en aurez besoin pour configurer votre bloc d'annonces AdMob dans la section suivante.

Sur la page Zone Management (Gestion des zones), notez l'ID de la zone. Vous en aurez également besoin pour configurer votre bloc d'annonces AdMob dans la section suivante.

(Cascade d'annonces uniquement) En plus de l'ID d'élément 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 Reporting API (API Reporting), notez l'API ID (ID de l'API) et l'API KEY (clé API).

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

Configurer les paramètres de médiation de votre bloc d'annonces

Vous devez ajouter maio à la configuration de la médiation pour votre bloc d'annonces.

Tout d'abord, 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, puis passez à l'étape Ajouter maio en tant que source d'annonce.

Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.

Saisissez le format d'annonce et la plate-forme, puis cliquez sur Continuer.

Attribuez un nom à votre groupe de médiation, puis 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 contenir les blocs d'annonces que vous avez sélectionnés :

Ajouter maio en tant que source d'annonce

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

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 de la source d'annonce pour maio. Saisissez ensuite une valeur d'eCPM pour maio, puis cliquez sur Continuer.




Si vous avez déjà une mise en correspondance pour maio, vous pouvez la sélectionner. Sinon, cliquez sur Ajouter une mise en correspondance.



Ensuite, saisissez l'ID de l'élément multimé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

Recommandé : Utiliser Swift Package Manager

Avant de continuer, vous devez disposer de la version minimale compatible de l'adaptateur, à savoir la version 2.2.0.0.

Pour ajouter une dépendance de package à votre projet, procédez comme suit :

1. Dans Xcode, accédez à File > Add Package Dependencies... (Fichier > Ajouter des dépendances de package...).

2. Dans l'invite qui s'affiche, recherchez l'URL de package suivante :

   https://github.com/googleads/googleads-mobile-ios-mediation-maio.git
   

3. Dans Règle de dépendance, sélectionnez Branche.

4. Dans le champ de texte, saisissez main.

Intégration manuelle

• Téléchargez la dernière version du SDK maio.
• Téléchargez la dernière version de l'adaptateur maio (lien de téléchargement disponible dans le journal des modifications), puis associez maioAdapter.framework à votre projet.

Utiliser CocoaPods

• Ajoutez la ligne suivante au fichier Podfile de votre projet :

  pod 'GoogleMobileAdsMediationMaio'
  

• Depuis la ligne de commande, exécutez la commande suivante :

  pod install --repo-update

Étape 4 : Ajouter le code requis

Implémenter 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 test

Enregistrez votre appareil de test pour AdMob.

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

Vérifier la réception des annonces test

Pour vérifier que vous recevez des annonces test de maio, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les sources d'annonces maio (cascade).

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 sous les classes suivantes :

Format	Nom de la classe
Interstitiel	GADMMaioInterstitialAdapter
Accordé	GADMMaioRewardedAdapter

Voici les codes et les messages associés que génère l'adaptateur maio lorsque le chargement d'une annonce échoue :

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 propose 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.
105	Filtrer les demandes soumises à une limite d'âge pour le SDK maio, car il ne peut pas recevoir de signaux soumis à une limite d'âge.

Journal des modifications de l'adaptateur de médiation iOS maio

Version 2.2.3.0

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

Conçue et testée avec :

• SDK Google Mobile Ads version 13.9.0.
• Version 2.2.3 du SDK Maio.

Version 2.2.2.0

• Compatibilité vérifiée avec la version 2.2.2 du SDK maio.
• La version minimale d'iOS requise est désormais 15.0.
• Mise à jour de la version minimale d'iOS pour assouplir la dépendance au SDK Google Mobile Ads afin d'autoriser les versions mineures.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.7.0.
• Version 2.2.2 du SDK Maio.

Version 2.2.1.2

• Filtrer les demandes soumises à une limite d'âge pour le SDK maio lorsque le nouveau paramètre ageRestrictedTreatment est défini sur GADAgeRestrictedTreatmentChild.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.3.0.
• Version 2.2.1 du SDK Maio.

Version 2.2.1.1

• Filtrer les demandes soumises à une limite d'âge pour le SDK maio, car il ne peut pas recevoir de signaux soumis à une limite d'âge.

Conçue et testée avec :

• SDK Google Mobile Ads 13.2.0.
• Version 2.2.1 du SDK Maio.

Version 2.2.1.0

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

Conçue et testée avec :

• SDK Google Mobile Ads version 13.1.0.
• Version 2.2.1 du SDK Maio.

Version 2.2.0.3

• Ajout de la prise en charge des bannières en cascade.
• Mise à jour de la dépendance du SDK Google Mobile Ads vers la version 13.0.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.0.0.
• Version 2.2.0 du SDK Maio.

Version 2.2.0.2

• Mise à jour de la version minimale d'iOS pour CocoaPods vers la version 13.0.

Conçue et testée avec :

• SDK Google Mobile Ads version 13.0.0.
• Version 2.2.0 du SDK Maio.

Version 2.2.0.1

• Suppression de l'implémentation des enchères, car Maio ne les accepte plus.
• Mettez à jour l'adaptateur pour qu'il utilise le protocole GADMediationAdapter.

Conçue et testée avec :

• SDK Google Mobile Ads version 12.11.0.
• Version 2.2.0 du SDK Maio.

Version 2.2.0.0

• Compatibilité validée avec la version 2.2.0 du SDK maio.

Conçue et testée avec :

• SDK Google Mobile Ads version 12.11.0.
• Version 2.2.0 du SDK Maio.

Version 2.1.6.1

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

Conçue et testée avec :

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

Version 2.1.6.0

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

Conçue et testée avec :

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

Version 2.1.5.1

• Mise à jour de CFBundleShortVersionString pour avoir trois composants au lieu de quatre.

Conçue et testée 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çue et testée 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çue et testée 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çue et testée 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.
• Ajout de Info.plist aux frameworks dans MaioAdapter.xcframework.

Conçue et testée avec :

• SDK Google Mobile Ads version 11.0.1.
• SDK Maio version 2.1.2.

Version 2.1.2.0

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

Conçue et testée avec :

• SDK Google Mobile Ads version 10.14.0.
• SDK Maio version 2.1.2.

Version 2.1.1.0

• Compatibilité validée avec la version 2.1.1 du SDK maio.

Conçue et testée 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 à MaioOB SDK.
• Suppression de la compatibilité avec l'architecture armv7.
• Nécessite désormais iOS 12.0 ou version ultérieure.
• Nécessite désormais le SDK Google Mobile Ads 10.4.0 ou version ultérieure.

Conçue et testée avec :

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

Version 1.6.3.1

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

Conçue et testée avec :

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

Version 1.6.3.0

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

Conçue et testée avec :

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

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çue et testée avec :

• SDK Google Mobile Ads version 9.5.0.
• Version 1.6.2 du SDK Maio.
• SDK MaioOB version 2.0.0-alpha.

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çue et testée avec :

• SDK Google Mobile Ads version 9.2.0.
• Version 1.6.1 du SDK Maio.
• SDK MaioOB version 2.0.0-alpha.

Version 1.6.0.1

• Compatibilité validée avec la version 9.0.0 du SDK Google Mobile Ads.
• Nécessite désormais le SDK Google Mobile Ads version 9.0.0 ou ultérieure.

Conçue et testée 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

• Compatibilité vérifiée avec la version 1.6.0 du SDK maio et la version 2.0.0-alpha du SDK maioOB.

Conçue et testée avec :

• SDK Google Mobile Ads version 8.13.0.
• La version minimale d'iOS requise est désormais la version 10.0.
• SDK Maio version 1.6.0.
• SDK MaioOB version 2.0.0-alpha.

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 à la version 8.0.0 ou ultérieure du SDK Google Mobile Ads.

Conçue et testée 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 de messages d'erreur d'adaptateur standardisés.
• Mise à jour de l'adaptateur 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çue et testée 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 7.68.0 ou version ultérieure.

Conçue et testée 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 version 7.64.0 ou ultérieure.

Conçue et testée avec :

• SDK Google Mobile Ads 7.64.0.
• SDK Maio version 1.5.5.

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çue et testée avec :

• SDK Google Mobile Ads 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 désormais immédiatement si maio ne dispose pas d'une annonce prête à être diffusée.
• Suppression de la compatibilité avec l'architecture i386.

Conçue et testée avec :

• SDK Google Mobile Ads 7.58.0.
• SDK Maio version 1.5.3.

Version 1.5.3.0

• Compatibilité validée avec la version 1.5.3 du SDK maio.

Conçue et testée 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çue et testée avec :

• SDK Google Mobile Ads version 7.53.1.
• SDK Maio version 1.5.2.

Version 1.5.2.0

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

Conçue et testée avec :

• SDK Google Mobile Ads version 7.53.1.
• SDK Maio version 1.5.2.

Version 1.5.1.0

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

Conçue et testée avec :

• SDK Google Mobile Ads version 7.52.0.
• SDK Maio version 1.5.1.

Version 1.5.0.0

• Compatibilité validée avec la version 1.5.0 du SDK maio.

Conçue et testée avec

• SDK Google Mobile Ads version 7.51.0.
• SDK publicitaire Maio version 1.5.0.

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 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é validé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é validé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 prise en charge des annonces interstitielles et vidéo avec récompense.