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 Ad Manager 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
Dernier SDK Google Mobile Ads
Suivez le guide de démarrage sur la médiation.
É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).
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 Ad Manager .
Étape 2: Configurez la demande i-mobile dans Ad Manager l'UI
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.
Attribuez un nom unique à votre groupe de rendement, définissez l'état sur Actif, puis le format d'annonce et le type d'inventaire sur Application mobile. Dans la section Ciblage > Inventaire, sélectionnez le bloc d'annonces auquel vous souhaitez ajouter une médiation sous Inventaire et Application mobile.
Cliquez ensuite sur le bouton Ajouter un partenaire de rendement.
Si vous disposez déjà d'un partenaire de rendement pouri-mobile, vous pouvez le sélectionner. Sinon, sélectionnez Créer un partenaire de rendement.
Sélectionnez i-mobile en tant que réseau publicitaire, saisissez un nom unique et activez la médiation.
Activez la collecte des données automatique et saisissez le
Une fois que vous avez sélectionné Partenaire de rendement, sélectionnez Médiation SDK pour mobile comme type d'intégration, Android comme Plate-forme et Actif comme État. Saisissez lePublisher ID, Media ID and Spot ID obtenu dans la section précédente. Saisissez ensuite une valeur dans le champ CPM par défaut.
Lorsque vous avez terminé, cliquez sur Enregistrer en bas de la page.
Étape 3: Importez le SDK i-mobile et l'adaptateur
Intégration d'Android Studio (recommandé)
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
Téléchargez la dernière version du SDK i-mobile, extrayez
android-ad-sdk.aardans le dossiersdk, puis ajoutez-le à votre projet.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
.aarde 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 Ad Manager. 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
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 Ad Manager 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 Ad Manager 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
compileSdkVersionettargetSdkVersionvers 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
mediaContentnon 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.