Intégrer Maio à la médiation

Sélectionnez une plate-forme : Android (bêta) Android iOS Unity Flutter

Ce guide explique comment utiliser GMA Next-Gen SDK pour charger et afficher des annonces de maio à l'aide de la médiation. Il aborde notamment les intégrations en cascade. Vous apprendrez à ajouter maio à la configuration de médiation d'un bloc d'annonces et à intégrer le SDK maio et son adaptateur dans une application Android.

L'interface du tableau de bord de maio utilise du texte en japonais pour les libellés, les boutons et les 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 pris en charge

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

• Niveau d'API Android 24 ou supérieur

• SDK maio 1.0.7 ou version ultérieure

• Dernière version GMA Next-Gen SDK.

• Avoir suivi le guide de démarrage sur la médiation

Étape 1 : Configurer les paramètres dans l'UI maio

Tout d'abord, inscrivez-vous ou connectez-vous à votre compte maio. Cliquez sur le bouton Application management (Gestion des applications) dans la barre latérale de gauche, puis sur New app (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 Video interstitial (Interstitiel vidéo) comme type d'annonce, puis cliquez sur Update (Mettre à jour).

Remarque : Les annonces interstitielles de maio sont désactivables par défaut.

Avec récompense

Saisissez le nom de votre application, sélectionnez la plate-forme et indiquez l'URL de l'application. Sélectionnez Video Rewards (Récompenses vidéo) comme type d'annonce, puis cliquez sur Update (Mettre à jour).

Remarque : Les annonces vidéo avec récompense de maio NE SONT PAS désactivables par défaut.

Sur la page Application Management (Gestion des applications), notez l'ID média. Il est nécessaire pour configurer votre bloc d'annonces Ad Manager dans la section suivante.

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

En plus de l'ID 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 Reporting API (API de création de rapports), notez l'ID d'API et la clé API.

Remarque : Si vous configurez votre compte maio pour la première fois, vous devrez peut-être contacter l'équipe d'assistance de maio pour obtenir votre ID d'API et clé API.

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

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.

Saisissez un nom unique pour votre groupe de rendement, définissez l'état sur Actif, sélectionnez votre format d'annonce et définissez le type d'inventaire sur Application mobile. Dans la section Ciblage > Inventaire, sélectionnez le bloc d'annonces sous Inventaire et Application mobile auquel vous souhaitez ajouter la médiation.

Cliquez ensuite sur le bouton Ajouter un partenaire de rendement.

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

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

Activez la collecte automatique des données, puis saisissez l' ID d'API et la clé API obtenus à la section précédente.

Une fois le partenaire de rendement sélectionné, choisissez Médiation SDK pour mobile comme le type d'intégration, Android comme la plate-forme, et Actif comme l'état. Saisissez l' ID média et l'ID de zone obtenus à la section précédente. Saisissez ensuite une valeur de CPM par défaut.

Important : L' ID média doit être associé à l'application cible, comme dans l' UI maio.

Cliquez sur Enregistrer en bas de la page lorsque vous avez terminé.

Remarque : Laissez quelques jours à la collecte des données automatisée pour que le CPM dynamique d'un réseau de médiation puisse être calculé avec précision. Une fois qu'il est possible de connaître l'eCPM, celui-ci s'actualise automatiquement.

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

Remarque : Si les versions des SDK maio et GMA Next-Gen SDK ne sont pas compatibles, vous risquez de rencontrer des problèmes de compilation.

Intégration à Android Studio (recommandée)

Dans le fichier settings.gradle.kts au niveau du projet, ajoutez les dépôts suivants :

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

Dans le fichier Gradle au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes :

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:maio:2.0.8.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:maio:2.0.8.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Intégration manuelle

• Téléchargez la dernière version du SDK Android maio et ajoutez la à votre projet.
• Accédez aux artefacts de l'adaptateur maio dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier `.aar` de l'adaptateur maio et ajoutez-le à votre projet.

Étape 4 : Ajouter le code requis

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

Étape 5 : Tester votre implémentation

Activer les annonces test

Assurez-vous d' enregistrer votre appareil de test pour Ad Manager.

Les éditeurs qui utilisent la version 11.6.0 ou une version ultérieure de GMA Next-Gen SDK recevront automatiquement des annonces test de maio sur les téléphones et tablettes enregistrés comme appareils de test lors de l'envoi de requêtes.

Important : Désactivez le mode test pour Ad Manager et maio avant de publier votre application.

Vérifier la réception des annonces test

Pour vérifier que vous recevez des annonces test de maio, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les sources d'annonces maio (cascade).

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 ResponseInfo.getAdSourceResponses() dans les classes suivantes :

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

Voici les codes et les messages associés que génère l'adaptateur maio lorsque le chargement d'une annonce échoue :

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	Aucune annonce n'est disponible dans maio.
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`.