Intégrer maio à la médiation

Ce guide explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces depuis maio à l'aide de la médiation, qui couvre 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 dans une applicationiOS .

L'interface du tableau de bord de maio utilise du texte en japonais pour ses libellés, 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 sont référencés avec leurs équivalents en langue anglaise. Par exemple, "URL ス溴ーム", par exemple, "schéma d'URL", et ainsi de suite.

Intégrations et formats d'annonces compatibles

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

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

Conditions requises

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

Étape 1: Définissez les configurations dans l'interface utilisateur 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

Connectez-vous à votre compte Ad Manager.

Ajouter maio "Entreprises"

Enchères

Cette étape n'est pas nécessaire pour les intégrations d'enchères.

Chute d'eau

Accédez à Admin > Sociétés, puis cliquez sur le bouton Nouvelle société dans l'onglet Toutes les sociétés. Sélectionnez Réseau publicitaire.

Sélectionnez maio en tant que réseau publicitaire, saisissez un nom unique et activez la médiation. Activez la collecte de données automatique et saisissez la valeur API ID and API KEY obtenue à la section précédente.

Vous n'avez pas besoin de saisir de nom d'utilisateur ni de mot de passe. Lorsque vous avez terminé, cliquez sur Save (Enregistrer).

Activer le partage des signaux sécurisés

Enchères

Accédez à Admin > Paramètres généraux. Accédez à l'onglet Paramètres de compte Ad Exchange, puis vérifiez et activez l'option Partage des signaux sécurisés. Cliquez sur Enregistrer.

Chute d'eau

Cette étape n'est pas nécessaire pour les intégrations en cascade.

Configurer maio les enchères

Enchères

Accédez à Diffusion > Enchérisseurs, puis cliquez sur Nouvel enchérisseur dans l'onglet Enchères de SDK.

Sélectionnez maio comme enchérisseur.

Activez les options Ajouter la bibliothèque de signaux de cet enchérisseur à la liste des signaux autorisés et Autoriser le partage des signaux avec cet enchérisseur. Cliquez ensuite sur Continuer.

Cliquez sur Continuer.

Cliquez sur OK.

Chute d'eau

Cette étape n'est pas nécessaire pour les intégrations en cascade.

Configurer la mise en correspondance des blocs d'annonces

Enchères

Accédez à Diffusion > Enchérisseurs, puis sélectionnez la société pourmaio dans l'onglet Enchères par SDK.

Accédez à l'onglet Mise en correspondance des blocs d'annonces et cliquez sur Nouvelle mise en correspondance des blocs d'annonces.

Sélectionnez Bloc d'annonces spécifique. Sélectionnez un bloc d'annonces et un format, Application mobile comme Type d'inventaire et votre Application mobile. Saisissez ensuitePublisher ID obtenu dans la section précédente. Enfin, cliquez sur Enregistrer.

Chute d'eau

Accédez à Diffusion > Groupes de rendement, puis cliquez sur le bouton Nouveau groupe de rendement. Sélectionnez votre application mobile.

Faites défiler la page vers le bas, puis cliquez sur Ajouter un partenaire de rendement.

Sélectionnez l'entreprise pour laquelle vous avez créé maio dans la section précédente. Sélectionnez Médiation SDK pour mobile comme Type d'intégration, iOS comme Plate-forme et Active comme État.

Saisissez le Media ID and Zone IDobtenu à la section précédente, puis la valeur du CPM par défaut. Cliquez sur Enregistrer.

Remarque: La collecte automatique de données prend quelques jours avant de pouvoir calculer avec précision une valeur de CPM dynamique pour un réseau de médiation. Une fois que l'eCPM peut être calculé, il est automatiquement mis à jour en votre nom.

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

  • Ajoutez la ligne suivante au Podfile de votre projet:

    pod 'GoogleMobileAdsMediationMaio'

  • Dans 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 du journal des modifications et associez maioAdapter.framework dans 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: 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 (Bidding) and 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
Accordé 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. Consultez le code et la documentation de maio pour plus d'informations.
101 Maio n'a aucune annonce disponible.
102 Paramètres 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. Consultez le code de Maio pour plus d'informations.
101 maio ne dispose pas encore d'annonce.
102 Paramètres 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 réseau.

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

Version 2.1.3.0

  • Compatibilité vérifiée avec le SDK maio version 2.1.3

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 désormais le SDK Google Mobile Ads 11.0 ou version ultérieure.
  • Inclusion de Info.plist dans les 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

  • Compatibilité vérifiée avec le SDK maio version 2.1.2

Conçu et testé avec:

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

Version 2.1.1.0

  • Compatibilité vérifiée avec le SDK maio version 2.1.1

Conçu et testé avec:

  • SDK Google Mobile Ads version 10.12.0.
  • SDK Maio version 2.1.1.

Version 2.0.0.0

  • Compatibilité vérifiée avec le SDK maio version 2.0.0.
  • Suppression de la dépendance à MaioOB SDK.
  • Suppression de la compatibilité avec l'architecture armv7.
  • Nécessite désormais la version minimale d'iOS 12.0.
  • Nécessite désormais le SDK Google Mobile Ads 10.4.0 ou version ultérieure.

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 désormais le SDK Google Mobile Ads 10.0.0 ou version ultérieure.

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 désormais le SDK Google Mobile Ads 9.8.0 ou version ultérieure.
  • Compatibilité vérifiée avec le SDK maio version 1.6.3 et la version 2.0.0-alpha du SDK maioOB

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

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

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

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

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

  • Compatibilité validé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.
  • SDK MaioOB version 2.0.0-alpha.

Version 1.6.0.0

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 8.13.0.
  • Nécessite désormais la version minimale d'iOS 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 le SDK maio version 1.5.8 et la version 2.0.0-alpha du SDK maioOB
  • Ajout d'une fonctionnalité d'enchères à l'adaptateur pour les formats d'annonces interstitielles et avec récompense.
  • Dépendance flexible à la version 8.0.0 ou ultérieure du SDK Google Mobile Ads.

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 de 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 le transfert des événements d'annonces avec récompense.
  • Nécessite désormais le SDK Google Mobile Ads 8.3.0 ou version ultérieure.

Conçu et testé avec:

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

Version 1.5.6.0

  • Compatibilité vérifiée avec le SDK maio version 1.5.6.
  • Nécessite désormais le SDK Google Mobile Ads 7.68.0 ou version ultérieure.

Conçu et testé avec:

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

Version 1.5.5.0

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

Conçu et testé avec:

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

Version 1.5.4.0

  • Compatibilité vérifiée avec le SDK maio version 1.5.4.
  • Nécessite désormais le SDK Google Mobile Ads 7.60.0 ou version ultérieure.

Conçu et testé avec:

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

Version 1.5.3.1

  • Afin de limiter les délais avant expiration, les demandes d'annonces échouent immédiatement si maio ne dispose d'aucune 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

  • Compatibilité vérifiée avec le SDK maio version 1.5.3.

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

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

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 le SDK maio version 1.5.1.

Conçu et testé avec:

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

Version 1.5.0.0

  • Compatibilité vérifiée avec le SDK maio version 1.5.0.

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

  • Compatibilité vérifiée avec le SDK maio version 1.4.8.

Version 1.4.6.0

  • Compatibilité vérifiée avec le SDK maio version 1.4.6.
  • Mise à jour de l'adaptateur pour utiliser la nouvelle API avec récompense.
  • Nécessite désormais le SDK Google Mobile Ads 7.42.2 ou version ultérieure.

Version 1.4.2.0

  • Compatibilité vérifiée avec le SDK maio version 1.4.2.

Version 1.4.1.0

  • Compatibilité vérifiée avec le SDK maio version 1.4.1.
  • L'adaptateur Maio pouvait échouer si plusieurs MediaId étaient fournis par AdMob. Ce problème a été résolu.

Version 1.4.0.0

  • Compatibilité vérifiée avec le SDK maio version 1.4.0.

Version 1.3.2.0

  • Compatibilité vérifiée avec le SDK maio version 1.3.2.

Version 1.3.1.1

  • Ajout du rappel adapterDidCompletePlayingRewardBasedVideoAd: à l'adaptateur.

Version 1.3.1.0

  • Compatibilité vérifiée avec le SDK maio version 1.3.1.

Version 1.3.0.0

  • Compatibilité vérifiée avec le SDK maio version 1.3.0.

Version 1.2.19.0

  • Compatibilité vérifiée avec le SDK maio version 1.2.19.

Version 1.2.18.0

  • Première version !
  • Ajout de la compatibilité avec les interstitiels et les annonces vidéo avec récompense.