Intégrer i-mobile à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces provenant d'i-mobile à l'aide de la médiation AdMob, en couvrant les intégrations en cascade. Il explique comment ajouter i-mobile à la configuration de médiation d'un bloc d'annonces et comment intégrer le SDK et l'adaptateur i-mobile dans une application Android.

L'interface du tableau de bord d'i-mobile utilise du texte 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 de ce guide, les libellés et les boutons sont traduits avec leurs équivalents en anglais entre parenthèses.

Intégrations et formats d'annonces compatibles

L'adaptateur de médiation pour i-mobile propose les fonctionnalités suivantes:

Conditions requises

• Niveau d'API Android 21 ou supérieur

• Dernière version du SDK Google Mobile Ads

• Suivez le guide de démarrage de la médiation.

Étape 1: Configurez les configurations dans l'interface utilisateur d'i-mobile

Inscrivez-vous ou connectez-vous à votre compte i-mobile.

Ajoutez votre application au tableau de bord i-mobile en cliquant sur l'onglet サイト／アプリ管理 (Site/Application Management) (Gestion de site/application) et sur le bouton correspondant à la plate-forme de votre application.

Remplissez le formulaire, puis cliquez sur le bouton 新規登録 (S'inscrire).

Pour créer un emplacement publicitaire, sélectionnez votre application dans l'onglet サイト／アプリ管理 (Site/Application Management) (Site/Gestion des applications).

Accédez à l'onglet 広告スポット管理 (Gestion des emplacements publicitaires), puis cliquez sur le bouton 新規広告スポット (Nouvel emplacement publicitaire).

Ensuite, remplissez le formulaire en indiquant le 広告スポット名 (nom de l'espace publicitaire), le 広告スポットサイズ (taille de l'espace publicitaire) et d'autres informations. Cliquez ensuite sur le bouton 新規登録 (S'inscrire).

Votre nouveau emplacement publicitaire est prêt. Pour afficher les détails de l'intégration, cliquez sur le bouton アプリ設定取得 (Obtenir les paramètres de l'application).

Notez les valeurs パブリッシャーID (ID de l'éditeur), メディアID (ID du média) et スポットID (ID de l'emplacement). Vous aurez besoin de ces paramètres plus tard lorsque vous configurerez i-mobile pour la médiation dans l'interface utilisateur AdMob.

Étape 2: Configurer la demande i-mobile dans l'interface utilisateur AdMob

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

Vous devez ajouter i-mobile à la configuration de médiation de votre bloc d'annonces.

Commencez par vous connecter à votre compte AdMob. Accédez ensuite à l'onglet Médiation. Si vous souhaitez modifier un groupe de médiation existant, cliquez sur son nom pour le modifier, puis passez à la section Ajouter i-mobile en tant que source d'annonces.

Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.

Saisissez le format et la plate-forme de votre annonce, puis cliquez sur Continuer.

Attribuez un nom à votre groupe de médiation, puis sélectionnez les zones géographiques à cibler. Définissez ensuite l'état du groupe de médiation sur Activé, puis cliquez sur Ajouter des blocs d'annonces.

Associez ce groupe de médiation à un ou plusieurs de vos blocs d'annonces AdMob existants. Cliquez ensuite sur OK.

La fiche "Blocs d'annonces" doit maintenant afficher les blocs d'annonces que vous avez sélectionnés:

Ajouter i-mobile comme source d'annonces

Étape 3: Importer le SDK et l'adaptateur i-mobile

Intégration d'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.github.io/adnw-sdk-android")
    }
  }
}

Ensuite, dans le fichier build.gradle.kts au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes. Utilisez les dernières versions du SDK et de l'adaptateur i-mobile:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

Intégration manuelle

1. Téléchargez la dernière version du SDK i-mobile, puis extrayez le fichier android-ad-sdk.aar dans le dossier sdk et ajoutez-le à votre projet.

2. Accédez aux artefacts de l'adaptateur i-mobile dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier .aar de l'adaptateur i-mobile, puis ajoutez-le à votre projet.

Étape 4: Ajoutez le code requis

Aucune modification de code n'est nécessaire pour l'intégration d'i-mobile.

Étape 5: Tester votre implémentation

Activer les annonces tests

Veillez à enregistrer votre appareil de test pour AdMob. i-mobile fournit des ID de spot, des ID d'élément multimédia et des ID d'éditeur de test. Vous les trouverez sur cette page.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests d'i-mobile, activez le test d'une source d'annonces spécifique dans l'inspecteur d'annonces à l'aide de la ou des sources d'annonces i-mobile (cascade).

Étapes facultatives

Utiliser des annonces natives

Affichage des annonces

L'adaptateur i-mobile renseigne les descriptions avancées des champs des annonces natives suivantes pour un NativeAd.

¹ Pour les annonces natives, le SDK i-mobile ne fournit pas d'asset d'icône d'application. À la place, l'adaptateur i-mobile renseigne l'icône de l'application avec une image transparente.

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir une annonce d'i-mobile, les éditeurs peuvent vérifier l'erreur sous-jacente de la réponse de l'annonce à l'aide de ResponseInfo.getAdapterResponses() dans les classes suivantes:

Voici les codes et les messages associés générés par l'adaptateur i-mobile lorsqu'une annonce ne parvient pas à se charger:

Journal des modifications de l'adaptateur de médiation Android i-mobile

Version 2.3.2.0

• Compatibilité vérifiée avec le SDK i-mobile v2.3.2.

Compilé et testé avec:

• SDK Google Mobile Ads version 23.1.0
• Version 2.3.2 du SDK IMobile

Version 2.3.1.2

• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 23.0.0.
• Compatibilité vérifiée avec le SDK i-mobile v2.3.1.

Compilé et testé avec:

• SDK Google Mobile Ads version 23.0.0
• Version 2.3.1 du SDK IMobile

Version 2.3.1.1

• Mise à jour de l'adaptateur pour qu'il utilise la nouvelle classe VersionInfo.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 22.0.0.

Compilé et testé avec:

• SDK Google Mobile Ads version 22.0.0
• Version 2.3.1 du SDK IMobile

Version 2.3.1.0

• Compatibilité vérifiée avec le SDK i-mobile v2.3.1.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 21.5.0.

Compilé et testé avec:

• SDK Google Mobile Ads version 21.5.0
• Version 2.3.1 du SDK IMobile

Version 2.3.0.0

• Compatibilité vérifiée avec le SDK i-mobile v2.3.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 21.3.0.

Compilé et testé avec:

• SDK Google Mobile Ads version 21.3.0
• Version 2.3.0 du SDK IMobile

Version 2.0.23.1

• Mise à jour de compileSdkVersion et targetSdkVersion vers l'API 31.
• La version minimale requise du SDK Google Mobile Ads est désormais la 21.0.0.
• Mise à jour du niveau d'API Android minimal requis vers la version 19.

Compilé et testé avec:

• SDK Google Mobile Ads version 21.0.0
• Version 2.0.23 du SDK IMobile

Version 2.0.23.0

• Compatibilité vérifiée avec le SDK i-mobile v2.0.23.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.5.0.

Compilé et testé avec

• Version 20.5.0 du SDK Google Mobile Ads
• Version 2.0.23 du SDK IMobile

Version 2.0.22.2

• Ajout de codes et de messages d'erreur standardisés pour les adaptateurs.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.1.0.

Compilé et testé avec

• SDK Google Mobile Ads version 20.1.0
• Version du SDK IMobile 2.0.22.

Version 2.0.22.1

• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.0.0.

Compilé et testé avec

• Version 20.0.0 du SDK Google Mobile Ads
• Version du SDK IMobile 2.0.22.

Version 2.0.22.0

• Compatibilité vérifiée avec le SDK i-mobile v2.0.22.
• Mise à jour de l'adaptateur pour prendre en charge les requêtes de bannières adaptatives intégrées.

Compilé et testé avec

• SDK Google Mobile Ads 19.1.0
• Version du SDK IMobile 2.0.22.

Version 2.0.21.0

• Compatibilité vérifiée avec le SDK i-mobile v2.0.21.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.1.0.
• Ajout de la possibilité de redimensionner les bannières adaptatives.

Compilé et testé avec

• SDK Google Mobile Ads 19.1.0
• Version 2.0.21 du SDK IMobile

Version 2.0.20.2

• Prise en charge des tailles d'annonces en bannière flexibles.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 18.3.0.

Compilé et testé avec

• SDK Google Mobile Ads 18.3.0
• Version du SDK IMobile 2.0.20.

Version 2.0.20.1

• L'adaptateur renvoie désormais un format mediaContent différent de zéro.

Compilé et testé avec

• SDK Google Mobile Ads 18.2.0
• Version du SDK IMobile 2.0.20.

Version 2.0.20.0

• Version initiale
• Ajout de la compatibilité avec les bannières, les interstitiels et les annonces natives.