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, 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 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, les libellés et les boutons sont désignés par leurs équivalents en anglais. "URL スキーム", par exemple, correspond à "URL Scheme", etc.

Intégrations et formats d'annonces compatibles

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

  • Unity 4 ou version ultérieure
  • Dernière version du SDK Google Mobile Ads
  • Pour déployer sur Android
    • Niveau d'API Android 21 ou supérieur
  • Pour déployer sur iOS :
    • iOS 12.0 ou version ultérieure comme cible de déploiement
  • Un projet Unity fonctionnel configuré avec le SDK Google Mobile Ads. Pour en savoir plus, consultez la section Premiers pas.
  • Finalisez la médiation. Guide de démarrage

Étape 1 : Configurer les configurations dans l'interface utilisateur 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 votre application. Sélectionnez Annonce interstitielle vidéo 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 votre application. Sélectionnez Récompenses vidéo comme Type d'annonce, puis cliquez sur Mettre à jour.

Android

iOS

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.

Android

iOS

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.

Android

iOS

(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

Android

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

iOS

Pour obtenir des instructions, reportez-vous à l'étape 2 du guide pour iOS.

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

OpenUPM-CLI

Si OpenUPM-CLI est installé, vous pouvez installer le plug-in de médiation Google Mobile Ads 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 votre éditeur de 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 Registres cloisonnés, ajoutez OpenUPM en tant que registre limité avec les informations suivantes:

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

Détails sur OpenUPM

Accédez ensuite à 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 Installer.

Installer depuis 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 votre éditeur de projet Unity, sélectionnez Assets > Import Package > Custom Package (Ressources > Importer un 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 (Composants > Gestionnaire de dépendances externes > Résolveur Android > Forcer la résolution). La bibliothèque External Dependency Manager effectue la résolution des dépendances à partir de zéro et copie 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

Aucune modification de code n'est requise 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

Veillez à enregistrer votre appareil de test pour AdMob.

Les éditeurs qui utilisent la version 7.26.0 ou ultérieure du SDK Google Mobile Ads reçoivent automatiquement des annonces tests de la part de maio sur les téléphones et les tablettes enregistrés en tant que appareils de test lorsqu'ils envoient des requêtes.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests de maio, activez le test d'une source d'annonces unique dans l'inspecteur d'annonces à l'aide des sources d'annonces maio (Waterfall).

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir une annonce de maio, les éditeurs peuvent vérifier l'erreur sous-jacente 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 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".

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 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 du plug-in de médiation Unity maio

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 l'adaptateur Android maio version 1.1.7.0
  • Compatible avec la version 1.4.6.0 de l'adaptateur iOS de maiô.

Version 1.2.2

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

Version 1.2.1

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

Version 1.2.0

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

Version 1.1.3

  • Compatible avec la version 1.1.3.1 de l'adaptateur Android maio.
  • Compatible avec l'adaptateur iOS Maio 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 iOS Maio version 1.3.2.0.

Version 1.1.1

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

Version 1.1.0

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

Version 1.0.2

  • Compatible avec la version 1.0.8 du SDK Android.
  • Compatible avec la version 1.2.19 du SDK iOS de maiô.

Version 1.0.1

  • Compatible avec la version 1.0.7 du SDK Android Maio.
  • Compatible avec la version 1.2.19 du SDK iOS de maiô.

Version 1.0.0

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