Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces depuis i-mobile à l'aide de la médiation, 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 Android application.
L'interface du tableau de bord pour i-mobile utilise du texte en japonais pour les libellés, les boutons et les 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 et leur équivalent en anglais est indiqué 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é | |
| Il s'agit de ma langue maternelle | |
Conditions requises
- Niveau d'API Android 21 ou supérieur
Le dernier SDK Google Mobile Ads
Suivez la procédure de médiation. Guide de démarrage
É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'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'interface utilisateur
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: 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 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 configurations et dépendances 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.1.0")
implementation("com.google.ads.mediation:imobile:2.3.1.2")
}
Intégration manuelle
Téléchargez la dernière version du SDK i-mobile, extrayez
android-ad-sdk.aardans le dossiersdket 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, puis 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 pour i-mobile renseigne les
champs
pour un
NativeAd.
| Champ | Éléments toujours inclus avec l'adaptateur i-mobile |
|---|---|
| Titre principal | |
| Image | |
| Corps | |
| Icône de l'appli | 1 |
| Incitation à l'action | |
| Star rating [Note] | |
| Boutique | |
| 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 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 à partir de la réponse d'annonce à l'aide de
ResponseInfo.getAdapterResponse() dans les classes suivantes:
| Format | Nom de la classe |
|---|---|
| Bannière | com.google.ads.mediation.imobile.IMobileAdapter |
| Interstitiel | com.google.ads.mediation.imobile.IMobileAdapter |
| Il s'agit de ma langue maternelle | 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 du chargement d'une annonce:
| Code d'erreur | Motif |
|---|---|
| 0-99 | Le SDK i-mobile a renvoyé une erreur. Pour en savoir plus, reportez-vous au 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 Ad Manager 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. |
| 0-10 | Le SDK i-mobile a renvoyé une erreur. Pour en savoir plus, reportez-vous au code. |
| 101 | Les paramètres du serveur i-mobile configurés dans l'interface utilisateur Ad Manager sont manquants ou non valides. |
| 102 | La taille d'annonce demandée ne correspond pas à une taille de bannière prise en charge par i-mobile. |
| 103 | i-mobile n'est pas parvenu à présenter une annonce. |
| 104 | i-mobile a renvoyé un tableau d'annonces natives vide. |
| 105 | Échec du téléchargement des éléments d'annonces natives sur i-mobile. |
| 106 | i-mobile ne prend pas en charge les demandes d'annonces interstitielles multiples utilisant le même identifiant Spot. |
Journal des modifications de l'adaptateur de médiation Android i-mobile
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
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 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
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.