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, 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 à une application Unity.
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 Ad Manager pour i-mobile offre les fonctionnalités suivantes:
Intégration | |
---|---|
Enchères | |
Cascade | |
Formats | |
Bannière | |
Interstitiel | |
Avec récompense |
Conditions requises
- Unity 5.6 ou version ultérieure
- Dernière version du SDK Google Mobile Ads
- Pour déployer sur Android
- Niveau d'API Android 21 ou supérieur
- Pour déployer sur iOS :
- iOS 12.0 ou version ultérieure comme cible de déploiement
- Un projet Unity fonctionnel configuré avec le SDK Google Mobile Ads. Pour en savoir plus, consultez la section Premiers pas.
- Suivez le guide de démarrage pour 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.
Android
iOS
Remplissez le formulaire, puis cliquez sur le bouton 新規登録 (S'inscrire).
Android
iOS
Pour créer un emplacement publicitaire, sélectionnez votre application dans l'onglet サイト/アプリ管理 (Site/Application Management) (Site/Gestion des applications).
Android
iOS
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 d'Ad Manager.
Android
iOS
Étape 2: Configurez la demande i-mobile dans l'interface utilisateur de Ad Manager
Configurer les paramètres de médiation pour votre bloc d'annonces
Android
Pour savoir comment procéder, consultez l'étape 2 du guide pour Android.
iOS
Pour savoir comment procéder, consultez l'étape 2 du guide pour iOS.
Étape 3: Importer le SDK et l'adaptateur i-mobile
OpenUPM-CLI
Si OpenUPM-CLI est installé, vous pouvez installer le plug-in de médiation i-mobile Google Mobile Ads pour Unity dans votre projet en exécutant la commande suivante à partir du répertoire racine de votre projet:
openupm add com.google.ads.mobile.mediation.imobile
OpenUPM
Dans l'éditeur de votre projet Unity, sélectionnez Edit (Modifier) > Project Settings (Paramètres du projet) > Package Manager (Gestionnaire de paquets) pour ouvrir les paramètres du Gestionnaire de paquets Unity.
Dans l'onglet Registres à portée limitée, ajoutez OpenUPM en tant que registre à portée limitée avec les informations suivantes:
- Nom :
OpenUPM
- URL :
https://package.openupm.com
- Champ(s) d'application :
com.google
Accédez ensuite à Window > Package Manager (Fenêtre > Gestionnaire de paquets) pour ouvrir le Gestionnaire de paquets Unity, puis sélectionnez My Registries (Mes registres) dans le menu déroulant.
Sélectionnez le package Google Mobile Ads i-mobile Mediation, puis cliquez sur Installer.
Package Unity
Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour i-mobile à partir du lien de téléchargement dans le journal des modifications, puis extrayez le fichier GoogleMobileAdsIMobileMediation.unitypackage
du fichier ZIP.
Dans l'éditeur de votre projet Unity, sélectionnez Assets (Éléments) > Import Package (Importer un package) > Custom Package (Package personnalisé), puis recherchez le fichier GoogleMobileAdsIMobileMediation.unitypackage
que vous avez téléchargé. Vérifiez que tous les fichiers sont sélectionnés, puis cliquez sur Importer.
Sélectionnez ensuite Assets > External Dependency Manager > Android Resolver > Force Resolve (Composants > Gestionnaire de dépendances externes > Résolveur Android > Forcer la résolution). La bibliothèque External Dependency Manager effectue la résolution des dépendances à partir de zéro et copie les dépendances déclarées dans le répertoire Assets/Plugins/Android
de votre application Unity.
Étape 4: Code supplémentaire requis
Android
Aucune modification de code n'est nécessaire pour l'intégration i-mobile.
iOS
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
Assurez-vous d'enregistrer votre appareil de test pour Ad Manager. 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).
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 ResponseInfo
dans les classes suivantes:
Android
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 |
iOS
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:
Android
Code d'erreur | Motif |
---|---|
0-99 | Le SDK i-mobile a renvoyé une erreur. Pour en savoir plus, consultez le code. |
101 | i-mobile nécessite un contexte Activity pour charger des annonces. |
102 | Les paramètres du serveur i-mobile configurés dans l'interface utilisateur de Ad Manager sont manquants ou non valides. |
103 | La taille d'annonce demandée ne correspond pas à une taille de bannière compatible avec i-mobile. |
104 | Le rappel de succès du chargement d'annonces natives d'i-mobile a renvoyé une liste d'annonces natives vide. |
iOS
Code d'erreur | Motif |
---|---|
0-10 | Le SDK i-mobile a renvoyé une erreur. Pour en savoir plus, consultez code. |
101 | Les paramètres du serveur i-mobile configurés dans l'interface utilisateur de Ad Manager 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 du plug-in de médiation Unity i-mobile
Version 1.3.6
- Compatible avec l'adaptateur Android i-mobile version 2.3.2.0.
- Compatible avec l'adaptateur iOS i-mobile version 2.3.4.1.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.3.0.
Version 1.3.5
- Compatible avec l'adaptateur Android i-mobile version 2.3.2.0.
- Compatible avec l'adaptateur iOS i-mobile version 2.3.4.0.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.1.0.
Version 1.3.4
- Compatible avec l'adaptateur Android i-mobile version 2.3.1.2.
- Compatible avec l'adaptateur iOS i-mobile version 2.3.4.0.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.0.0.
Version 1.3.3
- Compatible avec l'adaptateur Android i-mobile version 2.3.1.1.
- Compatible avec l'adaptateur iOS i-mobile version 2.3.3.0.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.0.0.
Version 1.3.2
- Le contenu de l'adaptateur a été déplacé vers
GoogleMobileAds/Mediation/IMobile/
. - Compatible avec l'adaptateur Android i-mobile version 2.3.1.1.
- Compatible avec l'adaptateur iOS i-mobile version 2.3.2.0.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 8.1.0.
Version 1.3.1
- Compatible avec l'adaptateur Android i-mobile version 2.3.0.0.
- Compatible avec l'adaptateur iOS i-mobile version 2.3.0.1.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 7.4.1.
Version 1.3.0
- Compatible avec l'adaptateur Android i-mobile version 2.3.0.0.
- Compatible avec l'adaptateur iOS i-mobile version 2.3.0.0.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 7.3.1.
Version 1.2.2
- Compatible avec l'adaptateur Android i-mobile version 2.0.23.1.
- Compatible avec l'adaptateur iOS i-mobile version 2.2.0.1.
- Compilé et testé avec la version 7.0.2 du plug-in Google Mobile Ads Unity.
Version 1.2.1
- Compatible avec l'adaptateur Android i-mobile version 2.0.23.0.
- Compatible avec l'adaptateur iOS i-mobile version 2.2.0.1.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 7.0.0.
Version 1.2.0
- Compatible avec l'adaptateur Android i-mobile version 2.0.23.0.
- Compatible avec l'adaptateur iOS i-mobile version 2.2.0.0.
Version 1.1.0
- Compatible avec l'adaptateur Android i-mobile version 2.0.22.2.
- Compatible avec l'adaptateur iOS i-mobile version 2.1.0.1.
Version 1.0.2
- Compatible avec l'adaptateur Android i-mobile version 2.0.22.0.
- Compatible avec l'adaptateur iOS i-mobile version 2.0.32.0.
Version 1.0.1
- Compatible avec l'adaptateur Android i-mobile version 2.0.21.0.
- Compatible avec l'adaptateur iOS i-mobile version 2.0.31.0.
Version 1.0.0
- Première version !
- Compatible avec l'adaptateur Android i-mobile version 2.0.20.1.
- Compatible avec l'adaptateur iOS i-mobile version 2.0.29.0.