Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces provenant d'i-mobile à l'aide de la médiation AdMob, 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 application iOS.
L'interface du tableau de bord d'i-mobile utilise du texte japonais pour ses libellés, boutons et 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 avec leurs équivalents en anglais entre parenthèses.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation pour i-mobile propose les fonctionnalités suivantes:
| Intégration | |
|---|---|
| Enchères | |
| Cascade | |
| Formats | |
| Bannière | |
| Interstitiel | |
| Avec récompense | |
| Natif | |
Conditions requises
- iOS 12.0 ou version ultérieure comme cible de déploiement
Dernière version du SDK Google Mobile Ads
Suivez le guide de démarrage de la médiation.
Étape 1: Configurez 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 サイト／アプリ管理 (Site/Application Management) (Gestion de site/application) et sur le bouton correspondant à la plate-forme de votre application.
Remplissez le formulaire, puis cliquez sur le bouton 新規登録 (S'inscrire).
Pour créer un emplacement publicitaire, sélectionnez votre application dans l'onglet サイト／アプリ管理 (Site/Application Management) (Site/Gestion des applications).
Accédez à l'onglet 広告スポット管理 (Gestion des emplacements publicitaires), puis cliquez sur le bouton 新規広告スポット (Nouvel emplacement publicitaire).
Ensuite, remplissez le formulaire en indiquant le 広告スポット名 (nom de l'espace publicitaire), le 広告スポットサイズ (taille de l'espace publicitaire) et d'autres informations. Cliquez ensuite sur le bouton 新規登録 (S'inscrire).
Votre nouveau 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).
Notez les valeurs パブリッシャーID (ID de l'éditeur), メディアID (ID du média) et スポットID (ID de l'emplacement). Vous aurez besoin de ces paramètres plus tard lorsque vous configurerez i-mobile pour la médiation dans l'interface utilisateur AdMob.
Étape 2: Configurer la demande i-mobile dans l'interface utilisateur AdMob
Configurer les paramètres de médiation pour votre bloc d'annonces
Vous devez ajouter i-mobile à la configuration de médiation de votre bloc d'annonces.
Commencez par vous connecter à 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 à la section Ajouter i-mobile en tant que source d'annonces.
Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.
Saisissez le format et la plate-forme de votre annonce, 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'annonces AdMob existants. Cliquez ensuite sur OK.
La fiche "Blocs d'annonces" doit maintenant afficher les blocs d'annonces que vous avez sélectionnés:
Ajouter i-mobile comme source d'annonces
Sous la fiche Cascade d'annonces, dans la section Sources d'annonces, sélectionnez Ajouter une source d'annonces. Sélectionnez ensuite i-mobile.
Sélectionnez i-mobile et activez l'option Optimiser. Saisissez le nom d'utilisateur et le mot de passe de l'API obtenus dans la section précédente pour configurer l'optimisation des sources d'annonces pour i-mobile. Saisissez ensuite une valeur d'eCPM pour i-mobile, puis cliquez sur Continuer.
Si vous avez déjà une mise en correspondance pour i-mobile, vous pouvez la sélectionner. Sinon, cliquez sur Ajouter un mappage.
Saisissez ensuite les ID de l'éditeur, de l'élément multimédia et de la campagne obtenus dans la section précédente. Cliquez ensuite sur OK.
Étape 3: Importer le SDK et l'adaptateur i-mobile
Utiliser CocoaPods (recommandé)
Ajoutez la ligne suivante au Podfile de votre projet:
pod 'GoogleMobileAdsMediationIMobile'
Depuis la ligne de commande, exécutez:
pod install --repo-updateIntégration manuelle
- Téléchargez la dernière version du SDK i-mobile et associez
ImobileSdkAds.frameworkdans votre projet. - Téléchargez la dernière version de l'adaptateur i-mobile à l'aide du lien de téléchargement dans le journal des modifications et du lien
IMobileAdapter.frameworkdans 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: Tester votre implémentation
Activer les annonces tests
Veillez à enregistrer votre appareil de test pour AdMob. i-mobile fournit des ID de spot, des ID d'élément multimédia et des ID d'éditeur de test. Vous les trouverez sur cette page.
Valider les annonces tests
Pour vérifier que vous recevez des annonces tests d'i-mobile, activez le test d'une source d'annonces spécifique dans l'inspecteur d'annonces à l'aide de la ou des sources d'annonces i-mobile (cascade).
Étapes facultatives
Utiliser des annonces natives
Affichage des annonces
L'adaptateur i-mobile renseigne les descriptions avancées des champs des annonces natives suivantes pour un GADNativeAd.
| Champ | Éléments toujours inclus par 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 parvient pas à recevoir une annonce d'i-mobile, les éditeurs peuvent vérifier l'erreur sous-jacente de la réponse de l'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 parvient pas à se charger:
| Code d'erreur | Motif |
|---|---|
| 0-10 | Le SDK i-mobile a renvoyé une erreur. Pour en savoir plus, consultez le code. |
| 101 | Les paramètres du serveur i-mobile configurés dans l'interface utilisateur d'AdMob sont manquants ou non valides. |
| 102 | La taille d'annonce demandée ne correspond pas à une taille de bannière compatible avec i-mobile. |
| 103 | i-mobile n'a pas réussi à présenter une annonce. |
| 104 | i-mobile a renvoyé un tableau d'annonces natives vide. |
| 105 | i-mobile n'a pas réussi à télécharger les composants d'annonces natives. |
| 106 | i-mobile n'accepte pas les demandes de plusieurs annonces interstitielles utilisant le même ID de spot. |
Journal des modifications de l'adaptateur de médiation iOS i-mobile
Version 2.3.4.1
- Modification de
CFBundleShortVersionStringpour qu'il comporte trois composants au lieu de quatre.
Compilé et testé avec:
- SDK Google Mobile Ads version 11.10.0
- Version 2.3.4 du SDK i-mobile.
Version 2.3.4.0
- Compatibilité vérifiée avec le SDK i-mobile 2.3.4.
- Ajout de la possibilité de renvoyer la version du SDK i-mobile dans
adSDKVersion.
Compilé et testé avec:
- Version 11.2.0 du SDK Google Mobile Ads
- Version 2.3.4 du SDK i-mobile.
Version 2.3.3.0
- Compatibilité vérifiée avec le SDK i-mobile 2.3.3.
Compilé et testé avec:
- SDK Google Mobile Ads version 11.1.0
- Version 2.3.3 du SDK i-mobile.
Version 2.3.2.1
- Suppression de la méthode de délégué
willBackgroundApplicationobsolète des implémentations d'annonces natives, interstitielles et bannières. - La version minimale d'iOS est désormais la 12.0.
- Nécessite désormais le SDK Google Mobile Ads 11.0 ou version ultérieure.
Info.plistinclus dans les frameworks deIMobileAdapter.xcframework.
Compilé et testé avec:
- SDK Google Mobile Ads version 11.0.1
- Version 2.3.2 du SDK i-mobile.
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 iOS 11.0.
- Nécessite désormais le SDK Google Mobile Ads 10.4.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads 10.4.0
- Version 2.3.2 du SDK i-mobile.
Version 2.3.1.0
- Compatibilité vérifiée avec le SDK i-mobile 2.3.1.
Compilé et testé avec:
- SDK Google Mobile Ads 10.3.0
- Version 2.3.1 du SDK i-mobile.
Version 2.3.0.1
- Nécessite désormais le SDK Google Mobile Ads 10.0.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads 10.0.0
- Version 2.3.0 du SDK i-mobile.
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.
Compilé et testé avec:
- SDK Google Mobile Ads version 9.13.0
- Version 2.3.0 du SDK i-mobile.
Version 2.2.0.1
- Nécessite désormais le SDK Google Mobile Ads 9.0.0 ou version ultérieure.
Compilé et testé avec:
- SDK Google Mobile Ads version 9.0.0
- Version du SDK i-mobile 2.2.0.
Version 2.2.0.0
- Compatibilité vérifiée avec le SDK i-mobile version 2.2.0.
Compilé et testé avec
- SDK Google Mobile Ads 8.13.0
- Version du SDK i-mobile 2.2.0.
Version 2.1.0.1
- Dépendance allégée vers la version 8.0.0 ou ultérieure du SDK Google Mobile Ads.
Compilé et testé avec
- SDK Google Mobile Ads 8.4.0
- Version du SDK i-mobile 2.1.0.
Version 2.1.0.0
- Compatibilité vérifiée avec le SDK i-mobile version 2.1.0.
- 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.
Compilé et testé avec
- SDK Google Mobile Ads version 8.1.0
- Version du SDK i-mobile 2.1.0.
Version 2.0.33.1
- Ajout de codes et de messages d'erreur standardisés pour les adaptateurs.
- L'adaptateur limite désormais la demande de plusieurs annonces interstitielles utilisant le même ID de spot i-mobile.
- L'adaptateur transfère désormais le rappel
-nativeAdWillLeaveApplication:lorsque les annonces natives sont enfoncées. - Nécessite désormais le SDK Google Mobile Ads 7.68.0 ou version ultérieure.
Compilé et testé avec
- SDK Google Mobile Ads 7.68.0
- Version 2.0.33 du SDK i-mobile.
Version 2.0.33.0
- Compatibilité vérifiée avec le SDK i-mobile version 2.0.33.
- Nécessite désormais le SDK Google Mobile Ads 7.65.0 ou version ultérieure.
- La version minimale d'iOS est désormais la 9.0.
Compilé et testé avec
- SDK Google Mobile Ads 7.65.0
- Version 2.0.33 du SDK i-mobile.
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 compatibilité avec la mise à l'échelle des annonces 320 x 50 et 320 x 100 pour mieux s'adapter aux tailles de demande de bannières adaptatives.
- Suppression de la compatibilité avec l'architecture i386.
Compilé et testé avec
- SDK Google Mobile Ads 7.60.0
- Version du SDK i-mobile 2.0.32.
Version 2.0.31.0
- Compatibilité vérifiée avec le SDK i-mobile version 2.0.31.
Compilé et testé avec
- Version 7.53.1 du SDK Google Mobile Ads
- Version 2.0.31 du SDK i-mobile.
Version 2.0.29.0
- Version initiale
- Ajout de la compatibilité avec les bannières, les interstitiels et les annonces natives.
Compilé et testé avec
- SDK Google Mobile Ads version 7.52.0.
- Version 2.0.29 du SDK i-mobile.