Intégrer i-mobile à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher annonces diffusées sur i-mobile à l'aide de Médiation AdMob, sur les intégrations de cascades d'annonces. Il explique comment ajouter i-mobile à l'inventaire configuration de médiation, et comment intégrer le SDK i-mobile et l'adaptateur dans une Android application.

L'interface du tableau de bord pour i-mobile utilise du texte en japonais pour ses libellés, des boutons et des descriptions. Les captures d'écran de ce guide n'ont pas été traduit. 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 offre les fonctionnalités suivantes:

Intégration
Enchères
Cascade
Formats
Bannière
Interstitiel
Avec récompense
Natif

Conditions requises

  • Niveau d'API Android 21 ou supérieur

Étape 1: Définir 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'icône l'onglet サイト/アにク管型 (Gestion des sites/applications) et du bouton de votre la plate-forme de votre application.

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

Prenez note du パブアッアャーID (référence éditeur), ジデアアID (ID média), et 設jobットID (ID de spot). Vous aurez besoin de ces paramètres ultérieurement pour configurer i-mobile pour la médiation dans l'interface utilisateur AdMob.

Android

iOS

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

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 : Importer le SDK et l'adaptateur i-mobile

Dans le fichier settings.gradle.kts au niveau du projet, ajoutez ce qui suit : des dépôts:

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 ce qui suit : les dépendances et configurations d'implémentation. Utilisez les dernières versions de la SDK et adaptateur i-mobile:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.4.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 et téléchargez l'i-mobile. le fichier .aar de l'adaptateur 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 éléments suivants Description des champs (avancés) des annonces natives pendant NativeAd

Champ Éléments toujours inclus avec l'adaptateur i-mobile
Titre
Image
Corps
Icône de l'application 1
Incitation à l'action
Note
Boutique
Prix

1 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 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.getAdapterResponses() dans 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. en cas d'échec de chargement d'une annonce:

Code d'erreur Motif
0-99 Le SDK i-mobile a renvoyé une erreur. Pour en savoir plus, consultez le code.
101 i-mobile nécessite un contexte Activity pour charger les annonces.
102 Les paramètres du serveur i-mobile configurés dans l'interface utilisateur AdMob sont manquants ou non valides.
103 La taille d'annonce demandée ne correspond pas à une taille de bannière prise en charge par i-mobile.
104 Le rappel de succès du chargement d'annonces natives d'i-mobile a renvoyé une liste d'annonces natives vide.

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.

Conçu et testé avec:

  • SDK Google Mobile Ads version 23.1.0
  • SDK IMobile version 2.3.2.

Version 2.3.1.2

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

Conçu et testé avec:

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

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

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.

Conçu 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.

Conçu et testé avec

  • SDK Google Mobile Ads 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.
  • 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.

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.