Intégrer i-mobile à la médiation

Sélectionnez une plate-forme : Android iOS Unity Flutter Android (ancien)

Ce guide explique comment utiliser Google Mobile Ads SDK pour charger et afficher des annonces i-mobile à l'aide de la médiation. Il aborde notamment les intégrations en cascade. Vous apprendrez à ajouter i-mobile à la configuration de médiation d'un bloc d'annonces et à intégrer le SDK i-mobile et son adaptateur dans une application iOS.

L'interface du tableau de bord d'i-mobile utilise du texte en japonais pour ses libellés, ses boutons et ses 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 leurs équivalents en anglais sont indiqués entre parenthèses.

Intégrations et formats d'annonces pris en charge

L'adaptateur de médiation pour i-mobile offre les fonctionnalités suivantes :

Intégration
Enchères
Cascade
Formats
Bannière
Interstitiel
Accordé
Natif

Prérequis

Avant de continuer, vérifiez les points suivants :

  • Cible de déploiement iOS 13.0 ou version ultérieure

Étape 1 : Configurer les paramètres dans l'UI 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 サイト／アプリ管理 (Gestion des sites/applications) 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 sous l'onglet サイト／アプリ管理 (Gestion des sites/applications).

Accédez à l'onglet 広告スポット管理 (Gestion des emplacements publicitaires), puis cliquez sur le bouton 新規広告スポット (Nouvel emplacement publicitaire).

create_ad_spot

Ensuite, remplissez le formulaire en indiquant le 広告スポット名 (nom de l'emplacement publicitaire), la 広告スポットサイズ (taille de l'emplacement publicitaire) et d'autres informations. Cliquez ensuite sur le bouton 新規登録 (S'inscrire).

new_ad_spot_form

Votre nouvel emplacement publicitaire est prêt. Pour afficher les détails de son intégration, cliquez sur le bouton アプリ設定取得 (Obtenir les paramètres de l'application).

ad_spot_list

Notez les valeurs パブリッシャーID (référence éditeur), メディアID (ID élément multimédia) et スポットID (ID spot). Vous aurez besoin de ces paramètres ultérieurement pour configurer i-mobile pour la médiation dans l'interface utilisateur d'Ad Manager.

Mettre à jour votre fichier app-ads.txt

Le fichier Authorized Sellers for Apps (app-ads.txt) est une initiative de l'IAB Tech Lab visant à garantir que l'inventaire publicitaire de votre application est vendu uniquement par l'intermédiaire des canaux de distribution que vous avez autorisés. Pour éviter une perte importante de revenus publicitaires, vous devez implémenter un fichier app-ads.txt. Si vous ne l'avez pas encore fait, créez un fichier app-ads.txt pour Ad Manager.

Pour implémenter app-ads.txt pour i-mobile, consultez les questions fréquentes.

Étape 2 : Configurer la demande i-mobile dans l'UI Ad Manager

Configurer les paramètres de médiation de 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.

Saisissez un nom unique pour votre groupe de rendement, définissez l'état sur Actif, sélectionnez votre format d'annonce et définissez le type d'inventaire sur Application mobile. Dans la section Ciblage > Inventaire, sélectionnez le bloc d'annonces sous Inventaire et Application mobile auquel vous souhaitez ajouter la médiation.

Cliquez ensuite sur le bouton Ajouter un partenaire de rendement.

Si vous avez déjà un partenaire de rendement pour i-mobile, vous pouvez le sélectionner. Sinon, sélectionnez Créer un partenaire de rendement.

Sélectionnez i-mobile comme Réseau publicitaire, saisissez un Nom unique et activez la Médiation.

Activez l'option Collecte automatique des données, puis saisissez le nom de connexion et le mot de passe de l'API.

Une fois le partenaire de rendement sélectionné, choisissez Médiation SDK pour mobile comme type d'intégration, iOS comme plate-forme et Actif comme état. Saisissez la référence éditeur, l'ID d'élément multimédia et l'ID de l'emplacement obtenus dans la section précédente. Ensuite, saisissez une valeur pour le CPM par défaut.

Cliquez ensuite sur Enregistrer en bas de la page.

Étape 3 : Importer le SDK et l'adaptateur i-mobile

Utiliser Swift Package Manager

Avant de continuer, vous devez disposer de la version minimale compatible de l'adaptateur, à savoir la version 2.3.4.2.

Pour ajouter une dépendance de package à votre projet, procédez comme suit :

  1. Dans Xcode, accédez à File > Add Package Dependencies... (Fichier > Ajouter des dépendances de package...).

  2. Dans l'invite qui s'affiche, recherchez l'URL de package suivante :

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git

  3. Dans Règle de dépendance, sélectionnez Branche.

  4. Dans le champ de texte, saisissez main.

Utiliser CocoaPods

  • Ajoutez la ligne suivante au fichier Podfile de votre projet :

    pod 'GoogleMobileAdsMediationIMobile'

  • Depuis 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 (lien de téléchargement disponible dans le journal des modifications), puis associez IMobileAdapter.framework à votre projet.

Étape 4 : Ajouter le code requis

Implémenter 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 test

Enregistrez votre appareil de test pour Ad Manager. i-mobile fournit un ID d'emplacement, un ID de média et un ID d'éditeur pour les tests. Vous les trouverez ici.

Vérifier la réception des annonces test

Pour vérifier que vous recevez des annonces test d'i-mobile, activez le test d'une seule source d'annonces dans l'inspecteur d'annonces en utilisant la ou les sources d'annonces i-mobile (cascade).

Étapes facultatives

Utiliser des annonces natives

Rendu des annonces

L'adaptateur i-mobile renseigne les champs suivants pour un GADNativeAd.

Champ Composants toujours inclus par l'adaptateur i-mobile
Titre
Image
Body
Icône de l'application 1
Incitation à l'action
Note
Magasin
Prix

1 Pour les annonces natives, le SDK i-mobile ne fournit pas d'icône d'application. À la place, l'adaptateur i-mobile remplit l'icône de l'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 que génère l'adaptateur i-mobile lorsque le chargement d'une annonce échoue :

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'Ad Manager sont manquants ou non valides.
102 La taille d'annonce demandée ne correspond pas à une taille de bannière i-mobile acceptée.
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'annonce native.
106 i-mobile ne permet pas de demander plusieurs annonces interstitielles avec le même ID d'emplacement.
107 Filtrer les demandes soumises à une limite d'âge pour le SDK i-mobile, car il ne peut pas recevoir de signaux soumis à une limite d'âge.

Journal des modifications de l'adaptateur de médiation i-mobile pour iOS

Version 2.3.4.8

  • Mise à jour de la version minimale d'iOS pour assouplir la dépendance au SDK Google Mobile Ads afin d'autoriser les versions mineures.

Conçue et testée avec :

  • SDK Google Mobile Ads version 13.7.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.4.7

  • Filtrer les requêtes soumises à une limite d'âge pour le SDK i-mobile lorsque le nouveau ageRestrictedTreatment est défini sur GADAgeRestrictedTreatmentChild.

Conçue et testée avec :

  • SDK Google Mobile Ads version 13.4.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.4.6

  • Filtrer les demandes soumises à une limite d'âge pour le SDK i-mobile, car il ne peut pas recevoir de signaux soumis à une limite d'âge.

Conçue et testée avec :

  • SDK Google Mobile Ads version 13.2.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.4.5

  • Mise à jour de la dépendance du SDK Google Mobile Ads vers la version 13.0.0.

Conçue et testée avec :

  • SDK Google Mobile Ads version 13.0.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.4.4

  • La version minimale d'iOS pour CocoaPods est désormais 13.0.

Conçue et testée avec :

  • SDK Google Mobile Ads version 13.0.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.4.3

  • Correction des noms d'en-tête du framework et de l'en-tête umbrella dans le modulemap IMobileAdapter.

Conçue et testée avec :

  • SDK Google Mobile Ads version 12.12.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.4.2

  • Nécessite désormais le SDK Google Mobile Ads version 12.0.0 ou ultérieure.

Conçue et testée avec :

  • SDK Google Mobile Ads version 12.0.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.4.1

  • Mise à jour de CFBundleShortVersionString pour avoir trois composants au lieu de quatre.

Conçue et testée avec :

  • SDK Google Mobile Ads version 11.10.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.4.0

  • Compatibilité vérifiée avec le SDK i-mobile 2.3.4.
  • Ajout de la prise en charge du renvoi de la version du SDK i-mobile dans adSDKVersion.

Conçue et testée avec :

  • SDK Google Mobile Ads version 11.2.0.
  • SDK i-mobile version 2.3.4.

Version 2.3.3.0

  • Compatibilité vérifiée avec le SDK i-mobile 2.3.3.

Conçue et testée 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 déléguée willBackgroundApplication obsolète des implémentations de bannières, d'interstitiels et d'annonces natives.
  • Nécessite désormais iOS 12.0 ou version ultérieure.
  • Nécessite désormais le SDK Google Mobile Ads version 11.0 ou ultérieure.
  • Ajout de Info.plist aux frameworks dans IMobileAdapter.xcframework.

Conçue et testée avec :

  • SDK Google Mobile Ads version 11.0.1.
  • SDK i-mobile version 2.3.2.

Version 2.3.2.0

  • Compatibilité validée avec le SDK i-mobile 2.3.2.
  • Suppression de la compatibilité avec l'architecture armv7.
  • Nécessite désormais iOS 11.0 ou version ultérieure.
  • Nécessite désormais le SDK Google Mobile Ads 10.4.0 ou version ultérieure.

Conçue et testée 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çue et testée avec :

  • SDK Google Mobile Ads 10.3.0.
  • SDK i-mobile version 2.3.1.

Version 2.3.0.1

  • Nécessite désormais le SDK Google Mobile Ads version 10.0.0 ou ultérieure.

Conçue et testée avec :

  • SDK Google Mobile Ads version 10.0.0.
  • 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 version 9.8.0 ou ultérieure.

Conçue et testée avec :

  • SDK Google Mobile Ads version 9.13.0.
  • SDK i-mobile version 2.3.0.

Version 2.2.0.1

  • Nécessite désormais le SDK Google Mobile Ads version 9.0.0 ou ultérieure.

Conçue et testée avec :

  • SDK Google Mobile Ads version 9.0.0.
  • 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çue et testée avec

  • SDK Google Mobile Ads version 8.13.0.
  • SDK i-mobile version 2.2.0.

Version 2.1.0.1

  • Dépendance assouplie au SDK Google Mobile Ads version 8.0.0 ou ultérieure.

Conçue et testée avec

  • SDK Google Mobile Ads version 8.4.0.
  • SDK i-mobile version 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 version 8.1.0 ou ultérieure.
  • Mise à jour de l'adaptateur pour utiliser le format .xcframework.

Conçue et testée avec

  • SDK Google Mobile Ads version 8.1.0.
  • SDK i-mobile version 2.1.0.

Version 2.0.33.1

  • Ajout de codes et de messages d'erreur d'adaptateur standardisés.
  • L'adaptateur limite désormais les demandes de plusieurs annonces interstitielles utilisant le même ID d'emplacement 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çue et testée 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 iOS 9.0 ou version ultérieure.

Conçue et testée avec

  • SDK Google Mobile Ads 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 version 7.60.0 ou ultérieure.
  • Ajout de la prise en charge de la mise à l'échelle des annonces 320 x 50 et 320 x 100 pour mieux s'adapter aux tailles des demandes de bannières adaptatives.
  • Suppression de la compatibilité avec l'architecture i386.

Conçue et testée avec

  • SDK Google Mobile Ads 7.60.0.
  • SDK i-mobile version 2.0.32.

Version 2.0.31.0

  • Compatibilité vérifiée avec la version 2.0.31 du SDK i-mobile.

Conçue et testée 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çue et testée avec

  • SDK Google Mobile Ads version 7.52.0.
  • SDK i-mobile version 2.0.29.