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, sont traduits et leur équivalent en anglais est indiqué 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
Le dernier SDK Google Mobile Ads
Finaliser la médiation Guide de démarrage
Étape 1: Définir les configurations dans l'interface utilisateur 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.
![](https://developers.google.cn/admob/images/mediation/imobile/select_platform_Android.png?authuser=19&hl=fr)
Remplissez le formulaire, puis cliquez sur le bouton 모規登録 (S'inscrire).
![](https://developers.google.cn/admob/images/mediation/imobile/add_app_name_Android.png?authuser=19&hl=fr)
Pour créer un espace publicitaire, sélectionnez votre application dans l'onglet サイト/アプア管理 (gestion des sites/applications).
![](https://developers.google.cn/admob/images/mediation/imobile/app_list_Android.png?authuser=19&hl=fr)
Accédez à l'onglet 広告スクット管理 (gestion des emplacements publicitaires) et cliquez sur le bouton Λ規広告ストット (Nouveau spot publicitaire).
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).
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).
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 .
![](https://developers.google.cn/admob/images/mediation/imobile/ad_spot_details_Android.png?authuser=19&hl=fr)
Étape 2: Configurer la demande i-mobile dans AdMob l'interface utilisateur
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 i-mobile et l'adaptateur
Intégration d'Android Studio (recommandé)
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.3.0")
implementation("com.google.ads.mediation:imobile:2.3.2.0")
}
Intégration manuelle
Téléchargez la dernière version de SDK i-mobile, puis extrayez le fichier
android-ad-sdk.aar
dans le dossiersdk
, puis ajoutez-le à votre projet.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
Descriptions 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'élément d'icône d'application. À la place, l'adaptateur i-mobile insère une image transparente dans l'icône de l'application.
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. Voir le code pour en savoir plus. |
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 chargement réussi des 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
- Adaptateur mis à jour 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
ettargetSdkVersion
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 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 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.
- L'adaptateur a été mis à jour pour prendre en charge les demandes 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
- Ajout de la prise en charge des tailles de bannières flexibles.
- 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.