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 iOS 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
- Cible de déploiement iOS 12.0 ou version ultérieure
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 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
Utiliser CocoaPods (recommandé)
Ajoutez la ligne suivante au Podfile de votre projet:
pod 'GoogleMobileAdsMediationIMobile'
Dans la ligne de commande, exécutez la commande suivante:
pod install --repo-update
Intégration manuelle
- Téléchargez la dernière version du SDK i-mobile et associez
ImobileSdkAds.frameworkà votre projet. - Téléchargez la dernière version de l'adaptateur i-mobile en cliquant sur le lien de téléchargement dans le journal des modifications et associez
IMobileAdapter.frameworkà votre projet.
Étape 4: Ajoutez le code requis
Intégration de SKAdNetwork
Suivez la documentation d'i-mobile pour ajouter les identifiants SKAdNetwork au fichier Info.plist de votre projet.
É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
GADNativeAd.
| 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
GADResponseInfo.adNetworkInfoArray
dans les classes suivantes:
| Format | Nom de la classe |
|---|---|
| Bannière | IMobileAdapter |
| Interstitiel | IMobileAdapter |
| Natif | GADMediationAdapterIMobile |
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 iOS i-mobile
Version 2.3.3.0
- Compatibilité vérifiée avec le SDK i-mobile 2.3.3.
Conçu et testé avec:
- SDK Google Mobile Ads version 11.1.0.
- SDK i-mobile version 2.3.3.
Version 2.3.2.1
- Suppression de la méthode obsolète de délégué
willBackgroundApplicationdes intégrations de bannières, d'interstitiels et d'annonces natives. - Nécessite désormais la version minimale d'iOS 12.0.
- Nécessite désormais le SDK Google Mobile Ads 11.0 ou version ultérieure.
- Inclusion de
Info.plistdans les frameworks dansIMobileAdapter.xcframework
Conçu et testé avec:
- SDK Google Mobile Ads version 11.0.1.
- SDK i-mobile version 2.3.2.
Version 2.3.2.0
- Compatibilité vérifiée avec le SDK i-mobile 2.3.2.
- Suppression de la compatibilité avec l'architecture
armv7. - Nécessite désormais la version minimale d'iOS 11.0.
- Nécessite désormais le SDK Google Mobile Ads 10.4.0 ou version ultérieure.
Conçu et testé avec:
- SDK Google Mobile Ads version 10.4.0.
- SDK i-mobile version 2.3.2.
Version 2.3.1.0
- Compatibilité vérifiée avec le SDK i-mobile 2.3.1.
Conçu et testé avec:
- SDK Google Mobile Ads version 10.3.0.
- SDK i-mobile version 2.3.1.
Version 2.3.0.1
- Nécessite désormais le SDK Google Mobile Ads 10.0.0 ou version ultérieure.
Conçu et testé avec:
- SDK Google Mobile Ads version 10.0.0.
- Le SDK i-mobile version 2.3.0.
Version 2.3.0.0
- Compatibilité vérifiée avec le SDK i-mobile 2.3.0.
- Nécessite désormais le SDK Google Mobile Ads 9.8.0 ou version ultérieure.
Conçu et testé avec:
- SDK Google Mobile Ads version 9.13.0.
- Le SDK i-mobile version 2.3.0.
Version 2.2.0.1
- Nécessite désormais le SDK Google Mobile Ads 9.0.0 ou version ultérieure.
Conçu et testé avec:
- SDK Google Mobile Ads version 9.0.0.
- Le SDK i-mobile version 2.2.0.
Version 2.2.0.0
- Compatibilité vérifiée avec la version 2.2.0 du SDK i-mobile.
Conçu et testé avec
- SDK Google Mobile Ads version 8.13.0.
- Le SDK i-mobile version 2.2.0.
Version 2.1.0.1
- Dépendance flexible à la version 8.0.0 ou ultérieure du SDK Google Mobile Ads.
Conçu et testé avec
- SDK Google Mobile Ads version 8.4.0.
- Le SDK i-mobile version 2.1.0.
Version 2.1.0.0
- Compatibilité vérifiée avec la version 2.1.0 du SDK i-mobile.
- Nécessite désormais le SDK Google Mobile Ads 8.1.0 ou version ultérieure.
- Mise à jour de l'adaptateur pour utiliser le format
.xcframework.
Conçu et testé avec
- SDK Google Mobile Ads version 8.1.0.
- Le SDK i-mobile version 2.1.0.
Version 2.0.33.1
- Ajout de codes et de messages d'erreur standardisés pour les adaptateurs.
- Adapter limite désormais les demandes d'annonces interstitielles multiples à l'aide du même ID Spot i-mobile.
- L'adaptateur transfère désormais le rappel
-nativeAdWillLeaveApplication:lorsque l'utilisateur appuie sur des annonces natives. - Nécessite désormais le SDK Google Mobile Ads 7.68.0 ou version ultérieure.
Conçu et testé avec
- SDK Google Mobile Ads version 7.68.0.
- SDK i-mobile version 2.0.33.
Version 2.0.33.0
- Compatibilité vérifiée avec la version 2.0.33 du SDK i-mobile.
- Nécessite désormais le SDK Google Mobile Ads 7.65.0 ou version ultérieure.
- Nécessite désormais la version minimale d'iOS 9.0.
Conçu et testé avec
- SDK Google Mobile Ads version 7.65.0.
- SDK i-mobile version 2.0.33.
Version 2.0.32.0
- Compatibilité vérifiée avec la version 2.0.32 du SDK i-mobile.
- Nécessite désormais le SDK Google Mobile Ads 7.60.0 ou version ultérieure.
- Ajout de la prise en charge de la mise à l'échelle des annonces 320 x 50 et 320 x 100 pour mieux les adapter aux tailles des demandes de bannières adaptatives.
- Suppression de la compatibilité avec l'architecture i386.
Conçu et testé avec
- SDK Google Mobile Ads version 7.60.0.
- Le SDK i-mobile est version 2.0.32.
Version 2.0.31.0
- Compatibilité vérifiée avec la version 2.0.31 du SDK i-mobile.
Conçu et testé avec
- SDK Google Mobile Ads version 7.53.1.
- SDK i-mobile version 2.0.31.
Version 2.0.29.0
- Version initiale
- Ajout de la compatibilité avec les bannières, les interstitiels et les annonces natives.
Conçu et testé avec
- SDK Google Mobile Ads version 7.52.0.
- SDK i-mobile version 2.0.29.