Intégrer maio à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher annonces de maio utilisant médiation sur les intégrations de cascades d'annonces. Vous verrez comment ajouter maio configuration de médiation, et comment intégrer le SDK Maio et l'adaptateur dans un iOS application.

L'interface du tableau de bord de maio utilise du texte en japonais pour ses étiquettes, ses boutons, et descriptions, et 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 référencés par leurs équivalents en anglais. "URL ム ー ム", Exemple : est "Schéma d'URL".

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

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

É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 Ad Manager 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 Ad Manager bloc d'annonces dans la section suivante.

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

Étape 2: Configurez la demande Maio dans Ad Manager l'UI

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, puis le format d'annonce et le type d'inventaire sur Application mobile. Dans la section Ciblage > Inventaire, sélectionnez le bloc d'annonces auquel vous souhaitez ajouter une médiation sous Inventaire et Application mobile.

Cliquez ensuite sur le bouton Ajouter un partenaire de rendement.

Si vous disposez déjà d'un partenaire de rendement pourmaio, vous pouvez le sélectionner. Sinon, sélectionnez Créer un partenaire de rendement.

Sélectionnez maio en tant que réseau publicitaire, saisissez un nom unique et activez la médiation.

Activez la collecte des données automatique et saisissez leAPI ID and API KEYobtenu à la section précédente.

Une fois que vous avez sélectionné Partenaire de rendement, sélectionnez Médiation SDK pour mobile comme type d'intégration, iOS comme Plate-forme et Actif comme État. Saisissez leMedia ID and Zone ID obtenu dans la section précédente. Saisissez ensuite une valeur dans le champ CPM par défaut.

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

É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 de SDK maio.
  • Téléchargez la dernière version de l'adaptateur Maio en cliquant sur le lien de téléchargement dans Journal des modifications, et 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 Ad Manager.

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 dans la réponse d'annonce à l'aide de GADResponseInfo.adNetworkInfoArray dans 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 en cas d'échec du chargement d'une annonce:

Code d'erreur Motif
0-10 maio a renvoyé une erreur spécifique au SDK. Voir le code et la documentation de Maio pour en savoir plus.
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. Voir code de maio pour en savoir plus.
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.5.0

  • Vérification de la compatibilité avec la version 2.1.5 du SDK Maio.

Conçu et testé avec:

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

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

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.