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 dans une application Unity.

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 fournies ici, les libellés et les boutons sont désignés par leur équivalent en anglais. Par exemple, "URL スキーム" correspond à "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
Annonces interstitielles
Avec récompense

Conditions requises

  • Dernière version du SDK Google Mobile Ads
  • Unity 4 ou version ultérieure
  • Déployer sur Android
    • Niveau d'API Android 23 ou supérieur
  • Déployer sur iOS
    • Cible de déploiement iOS 12.0 ou version ultérieure
  • Un projet Unity fonctionnel configuré avec le SDK Google Mobile Ads. Pour en savoir plus, consultez Premiers pas.
  • 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.

Interstitiel

Saisissez le nom de votre application, sélectionnez la plate-forme et indiquez l'URL de l'application. Sélectionnez Vidéo interstitielle comme type d'annonce, puis cliquez sur Mettre à jour.

Android

iOS

Avec récompense

Saisissez le nom de votre application, sélectionnez la plate-forme et indiquez l'URL de l'application. Sélectionnez Vidéo avec récompense comme type d'annonce, puis cliquez sur Mettre à jour.

Android

iOS

Sur la page Gestion des applications, notez l'ID du contenu multimédia. Il est nécessaire pour configurer votre bloc d'annonces AdMob dans la section suivante.

Android

iOS

Sur la page Gestion des zones, notez l'ID de la zone. Il sera également nécessaire pour configurer votre bloc d'annonces AdMob dans la section suivante.

Android

iOS

(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 Reporting API, notez l'ID de l'API et la clé API.

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

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

Android

Pour obtenir des instructions, consultez l'étape 2 du guide pour Android.

iOS

Pour savoir comment procéder, consultez l'étape 2 du guide pour iOS.

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

OpenUPM-CLI

Si OpenUPM-CLI est installé, vous pouvez installer le plug-in de médiation Google Mobile Ads maio pour Unity dans votre projet en exécutant la commande suivante à partir du répertoire racine de votre projet :

openupm add com.google.ads.mobile.mediation.maio

OpenUPM

Dans l'éditeur de votre projet Unity, sélectionnez Edit > Project Settings > Package Manager (Modifier > Paramètres du projet > Gestionnaire de packages) pour ouvrir les paramètres du gestionnaire de packages Unity.

Dans l'onglet Registries étendus, ajoutez OpenUPM en tant que registre étendu avec les informations suivantes :

  • Nom : OpenUPM
  • URL : https://package.openupm.com
  • Champ(s) d'application : com.google

Détails OpenUPM

Ensuite, accédez à Window > Package Manager (Fenêtre > Gestionnaire de packages) pour ouvrir le Gestionnaire de packages Unity, puis sélectionnez My Registries (Mes registres) dans le menu déroulant.

Registres Unity

Sélectionnez le package Google Mobile Ads Maio Mediation, puis cliquez sur Install (Installer).

Installer à partir d'OpenUPM

Package Unity

Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour maio à partir du lien de téléchargement dans le journal des modifications, puis extrayez le GoogleMobileAdsMaioMediation.unitypackage du fichier zip.

Dans l'éditeur de votre projet Unity, sélectionnez Assets (Éléments) > Import Package (Importer un package) > Custom Package (Package personnalisé), puis recherchez le fichier GoogleMobileAdsMaioMediation.unitypackage que vous avez téléchargé. Vérifiez que tous les fichiers sont sélectionnés, puis cliquez sur Importer.

Importer depuis Unity

Sélectionnez ensuite Assets > External Dependency Manager > Android Resolver > Force Resolve. La bibliothèque External Dependency Manager effectuera la résolution des dépendances à partir de zéro et copiera les dépendances déclarées dans le répertoire Assets/Plugins/Android de votre application Unity.

Forcer la résolution

Étape 4 : Ajoutez le code requis

Android

Aucun code supplémentaire n'est requis pour l'intégration de maio.

iOS

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

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 la part de maio, les éditeurs peuvent vérifier l'erreur sous-jacente à partir de la réponse de l'annonce à l'aide de ResponseInfo dans les classes suivantes :

Android

Format Nom de la classe
Interstitiel jp.maio.sdk.android.mediation.admob.adapter.Interstitial
Avec récompense jp.maio.sdk.android.mediation.admob.adapter.Rewarded

iOS

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 :

Android

Code d'erreur Motif
0-10 maio a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez le code et la documentation de maio.
101 Maio ne dispose pas d'annonce.
102 Paramètres de serveur non valides (par exemple, ID d'emplacement manquant).
103 Le contexte utilisé pour charger une annonce n'était pas une instance "Activity".

iOS

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 n'a pas encore d'annonce disponible.
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 du plug-in de médiation Unity maio

Version 3.0.2

Version 3.0.1

Version 3.0.0

Version 2.0.4

Version 2.0.3

Version 2.0.2

Version 2.0.1

Version 2.0.0

Version 1.4.3

Version 1.4.2

Version 1.4.1

Version 1.4.0

Version 1.3.6

Version 1.3.5

Version 1.3.4

Version 1.3.3

Version 1.3.2

Version 1.3.1

Version 1.3.0

Version 1.2.3

  • Mise à jour du plug-in pour prendre en charge la nouvelle API Rewarded.
  • Compatible avec la version 1.1.7.0 de l'adaptateur Android maio.
  • Compatible avec la version 1.4.6.0 de l'adaptateur maio pour iOS.

Version 1.2.2

  • Compatible avec la version 1.1.6.0 de l'adaptateur Android maio.
  • Compatible avec la version 1.4.2.0 de l'adaptateur maio pour iOS.

Version 1.2.1

  • Compatible avec la version 1.1.6.0 de l'adaptateur Android maio.
  • Compatible avec la version 1.4.1.0 de l'adaptateur maio iOS.

Version 1.2.0

  • Compatible avec l'adaptateur Android maio version 1.1.4.1.
  • Compatible avec la version 1.4.0.0 de l'adaptateur maio pour iOS.

Version 1.1.3

  • Compatible avec la version 1.1.3.1 de l'adaptateur Android maio.
  • Compatible avec l'adaptateur maio iOS version 1.3.2.0.

Version 1.1.2

  • Compatible avec la version 1.1.3.0 de l'adaptateur Android maio.
  • Compatible avec l'adaptateur maio iOS version 1.3.2.0.

Version 1.1.1

  • Compatible avec la version 1.1.1.0 de l'adaptateur Android maio.
  • Compatible avec la version 1.3.1.1 de l'adaptateur maio pour iOS.

Version 1.1.0

  • Compatible avec la version 1.1.0.0 de l'adaptateur Android maio.
  • Compatible avec la version 1.3.0.0 de l'adaptateur maio pour iOS.

Version 1.0.2

  • Compatible avec la version 1.0.8 du SDK maio pour Android.
  • Compatible avec la version 1.2.19 du SDK maio pour iOS.

Version 1.0.1

  • Compatible avec la version 1.0.7 du SDK Android de maio.
  • Compatible avec la version 1.2.19 du SDK maio pour iOS.

Version 1.0.0

  • Première version !
  • Compatible avec la version 1.0.6 du SDK Android de maio.
  • Compatible avec la version 1.2.18 du SDK maio pour iOS.