Intégrer i-mobile à la médiation

Ce guide explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces depuis i-mobile à l'aide de la médiation, qui couvre 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 Android application.

Les libellés, les boutons et les descriptions de l'interface du tableau de bord d'i-mobile sont en japonais. 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 AdMob pour i-mobile offre les fonctionnalités suivantes:

Intégration
Enchères
Cascade
Formats
Bannière
Interstitiel
Accordé
Natif

Conditions requises

  • Niveau d'API Android 19 ou supérieur

Étape 1: Définissez 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 サイト/アプifmobile管理 (Gestion des sites/applications) et sur le bouton de la plate-forme de votre application.

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

Pour créer un espace publicitaire, sélectionnez votre application dans l'onglet サイト/アプア管理 (gestion des sites/applications).

Accédez à l'onglet 広告スクット管理 (gestion des emplacements publicitaires) et cliquez sur le bouton Λ規広告ストット (Nouveau spot publicitaire).

create_ad_spot

Ensuite, remplissez le formulaire en indiquant 広告ステット名 (Nom du spot publicitaire), 広告ステットサイズ (taille du spot publicitaire) ainsi que d'autres informations. Ensuite, cliquez sur le bouton \r規登録 (S'inscrire).

new_ad_spot_form

Votre nouvel emplacement publicitaire est prêt. Pour afficher les détails de son intégration, cliquez sur le bouton アプifmobile設型取得 (Télécharger les paramètres de l'application).

ad_spot_list

Prenez note de l'パブットャーID (identifiant de l'éditeur), ジデ分アID (ID média) et スジットID (ID Spot). Vous aurez besoin de ces paramètres plus tard lors de la configuration d'i-mobile pour la médiation dans l'UI AdMob .

Étape 2: Configurez la demande i-mobile dans AdMob l'UI

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

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

Connectez-vous à 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 à l'étape Ajouter i-mobile comme source d'annonces.

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

Saisissez le format de votre annonce et votre plate-forme, 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'annoncesAdMob existants. Cliquez ensuite sur Done (OK).

Vous devriez maintenant voir la fiche des blocs d'annonces que vous avez sélectionnés:

Ajouter i-mobile comme source d'annonces

Sous la fiche Waterfall (Cascade d'annonces) de la section Ad Sources (Sources d'annonces), sélectionnez Add Ad Source (Ajouter une source d'annonces). Sélectionnez ensuite i-mobile.

Sélectionnez i-mobile et activez le bouton Optimiser. Saisissez l' Login name and API Password obtenue à la section précédente pour configurer l'optimisation de la source d'annonces pour i-mobile. Ensuite, saisissez une valeur d'eCPM pour i-mobile et cliquez sur Continuer.

Si vous disposez déjà d'un mappage pour i-mobile, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.

Saisissez ensuite les Publisher ID, Media ID and Spot IDobtenus à la section précédente. Cliquez ensuite sur Done (OK).

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

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.0.0")
    implementation("com.google.ads.mediation:imobile:2.3.1.1")
}

Intégration manuelle

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

  2. Accédez aux artefacts d'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 et ajoutez-le à votre projet.

Étape 4: Ajoutez le code requis

Aucun code supplémentaire n'est requis pour l'intégration i-mobile.

Étape 5: Testez votre implémentation

Activer les annonces tests

Veillez à enregistrer votre appareil de test pour AdMob. i-mobile fournit les ID Spot, Media ID et Publisher ID de test à des fins de test. Cliquez ici pour les trouver.

Valider les annonces tests

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

Étapes facultatives

Utiliser des annonces natives

Rendu des annonces

L'adaptateur i-mobile renseigne les champs de description avancés des annonces natives pour un NativeAd.

Champ Ressources toujours incluses par l'adaptateur i-mobile
Titre
Images
Corps
Icône de l'application 1
Incitation à l'action
Star rating [Note]
Stocker
Prix

1 Pour les annonces natives, le SDK i-mobile ne fournit pas d'élément d'icône d'application. Au lieu de cela, l'adaptateur i-mobile remplit l'icône d'application avec une image transparente.

Codes d'erreur

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

Format Nom de la classe
Bannière com.google.ads.mediation.imobile.IMobileAdapter
Interstitiel com.google.ads.mediation.imobile.IMobileAdapter
Natif com.google.ads.mediation.imobile.IMobileMediationAdapter

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

Code d'erreur Motif
0-99 Le SDK i-mobile a renvoyé une erreur. Pour plus d'informations, reportez-vous à la section sur le code.
101 i-mobile a besoin d'un contexte Activity pour charger les annonces.
102 Les paramètres du serveur i-mobile configurés dans AdMob l'interface utilisateur sont manquants/non valides.
103 La taille d'annonce demandée ne correspond pas à une taille de bannière prise en charge sur i-mobile.
104 Le rappel de réussite du chargement des annonces natives d'i-mobile a renvoyé une liste d'annonces natives vide.
0-10 Le SDK i-mobile a renvoyé une erreur. Pour plus d'informations, reportez-vous à la section sur le code.
101 Les paramètres du serveur i-mobile configurés dans AdMob l'interface utilisateur sont manquants/non valides.
102 La taille d'annonce demandée ne correspond pas à une taille de bannière prise en charge sur i-mobile.
103 i-mobile n'a pas pu présenter d'annonce.
104 i-mobile a renvoyé un tableau d'annonces natives vide.
105 i-mobile n'a pas réussi à télécharger les éléments de l'annonce native.
106 i-mobile ne prend pas en charge les demandes d'annonces interstitielles multiples avec le même identifiant Spot.

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

Version suivante

  • Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.4.0.

Version 2.3.1.1

  • Mise à jour de l'adaptateur pour utiliser la nouvelle classe VersionInfo.
  • Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.0.0.

Conçu et testé avec:

  • SDK Google Mobile Ads version 22.0.0.
  • SDK IMobile version 2.3.1

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 vers la version 21.5.0.

Conçu et testé avec:

  • SDK Google Mobile Ads version 21.5.0.
  • SDK IMobile version 2.3.1

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 vers la version 21.3.0.

Conçu et testé avec:

  • SDK Google Mobile Ads version 21.3.0.
  • SDK IMobile version 2.3.0.

Version 2.0.23.1

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 21.0.0.
  • SDK IMobile version 2.0.23.

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 vers la version 20.5.0.

Conçu et testé avec

  • SDK Google Mobile Ads version 20.5.0.
  • SDK IMobile version 2.0.23.

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 vers la version 20.1.0.

Conçu et testé avec

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

Version 2.0.22.1

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

Conçu et testé avec

  • SDK Google Mobile Ads version 20.0.0.
  • SDK IMobile version 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 accepter les requêtes de bannières adaptatives intégrées.

Conçu et testé avec

  • SDK Google Mobile Ads version 19.1.0.
  • SDK IMobile version 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 vers la version 19.1.0.
  • Ajout de la compatibilité avec le scaling des bannières adaptatives.

Conçu et testé avec

  • SDK Google Mobile Ads version 19.1.0.
  • SDK IMobile version 2.0.21.

Version 2.0.20.2

  • Les tailles de bannière flexibles sont désormais acceptées.
  • Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.3.0.

Conçu et testé avec

  • SDK Google Mobile Ads version 18.3.0.
  • SDK IMobile version 2.0.20.

Version 2.0.20.1

  • L'adaptateur renvoie désormais un format mediaContent non nul.

Conçu et testé avec

  • SDK Google Mobile Ads version 18.2.0.
  • SDK IMobile version 2.0.20.

Version 2.0.20.0

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