Intégrer Maio à la médiation

Sélectionnez une plate-forme : Android (bêta) Dernière sélection 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).

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

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.

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

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

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

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.

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