Intégrer Maio à la médiation

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 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 leurs équivalents en anglais. "URL スキーム", par exemple, correspond à "URL Scheme".

Intégrations et formats d'annonces compatibles

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

Intégration
Enchères
Cascade
Formats
Bannière
Interstitiel
Avec récompense
Natif

Conditions requises

  • iOS 12.0 ou version ultérieure comme cible de déploiement

  • Dernière version du SDK Google Mobile Ads

  • Suivez la procédure de médiation. Guide de démarrage

É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 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. Il vous sera également nécessaire de configurer votre bloc d'annonces AdMob à 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 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

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

  • 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 dans 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 (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 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 (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.5.1

  • Mise à jour de CFBundleShortVersionString pour inclure 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.

Compilé et testé avec :

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

Version 2.1.4.0

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

Compilé et testé avec :

  • SDK Google Mobile Ads version 11.2.0.
  • SDK Maio version 2.1.4.

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 la version 11.0 ou ultérieure du SDK Google Mobile Ads.
  • Ajout de Info.plist aux frameworks dans MaioAdapter.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.

Compilé 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.
  • 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 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 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.
  • Version 2.0.0 du SDK Maio

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 10.0.0
  • SDK Maio version 1.6.3.
  • 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.

Conçu et testé 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 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
  • SDK Maio version 1.6.2.
  • SDK MaioOB version 2.0.0-alpha.

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.

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 9.0.0.
  • SDK Maio version 1.6.0.
  • 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 requise 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.

Conçu et testé avec:

  • SDK Google Mobile Ads 8.7.0
  • SDK Maio version 1.5.8.
  • Version 2.0.0-alpha du SDK MaioOB.

Version 1.5.6.1

  • Ajout de codes et 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 la version 7.68.0 ou ultérieure du SDK Google Mobile Ads.

Conçu et testé avec:

  • SDK Google Mobile Ads 7.68.0
  • SDK Maio version 1.5.6.

Version 1.5.5.0

  • Compatibilité vérifiée avec la version 1.5.5 du SDK maio.
  • Nécessite la version 7.64.0 ou ultérieure du SDK Google Mobile Ads.

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

  • 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

  • La compatibilité avec la version 1.5.0 du SDK Maio a été vérifiée.

Compilé et testé avec

  • SDK Google Mobile Ads 7.51.0
  • SDK Maio Ads 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

  • Vérification de la compatibilité 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 empêchait 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

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