Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces à partir de Line à l'aide de la médiation, en couvrant les intégrations en cascade. Il explique comment ajouter Line à la configuration de médiation d'un bloc d'annonces et comment intégrer le SDK et l'adaptateur Line dans une application Unity.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation AdMob pour Line offre les fonctionnalités suivantes :
Intégration | |
---|---|
Enchères | |
Cascade | 1 |
Formats | |
Bannière | |
Interstitiel | |
Avec récompense |
1 L'intégration de Waterfall est en bêta ouverte.
Conditions requises
- Unity 4 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 de la médiation.
Étape 1 : Configurez les configurations dans l'interface utilisateur de Line
Connectez-vous à votre compte Line.
Ajouter une application
Cliquez sur 広告枠管理 (Gestion des espaces publicitaires) > メディア (Supports). Cliquez ensuite sur 新規作成 (Créer).
Remplissez le formulaire, puis cliquez sur 登録 (Enregistrer).
Notez l'ID de l'application.
Créer un emplacement d'annonce
Cliquez sur l'ID de l'application à laquelle vous souhaitez ajouter un emplacement d'annonce. Ensuite, sélectionnez 詳細 (Détails).
Cliquez sur スロット 追加 (Ajouter un emplacement).
Remplissez le formulaire, puis cliquez sur (登録) S'inscrire.
Notez l'ID de l'emplacement.
Étape 2 : Configurez la demande de ligne dans l'interface utilisateur de AdMob
Configurer les paramètres de médiation pour votre bloc d'annonces
Android
Pour obtenir des instructions, consultez l'étape 2 du guide pour Android.
iOS
Pour obtenir des instructions, reportez-vous à l'étape 2 du guide pour iOS.
Étape 3 : Importer le SDK et l'adaptateur Line
Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour Line à partir du lien de téléchargement dans le journal des modifications, puis extrayez GoogleMobileAdsLineMediation.unitypackage
du fichier ZIP.
Dans l'éditeur de votre projet Unity, sélectionnez Assets > Import Package > Custom Package (Éléments > Importer un package > Package personnalisé), puis recherchez le fichier GoogleMobileAdsLineMediation.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 > Play Services Resolver > Android Resolver > Force Resolve (Éléments > Résolveur Play Services > Résolveur Android > Forcer la résolution). La bibliothèque Unity Play Services Resolver 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 : Ajoutez le code requis
Android
Aucun code supplémentaire n'est requis pour l'intégration de Line.
iOS
Intégration de SKAdNetwork
Suivez la documentation de Line 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.
Suivez les instructions de la documentation Android et iOS de Line pour activer les annonces tests Line.
Valider les annonces tests
Pour vérifier que vous recevez des annonces test de Line, activez le test d'une source d'annonces spécifique dans l'inspecteur d'annonces à l'aide de la ou des sources d'annonces Line (cascade).
Étapes facultatives
Paramètres spécifiques au réseau
Le plug-in de médiation Line Unity est compatible avec le paramètre de requête supplémentaire suivant, qui peut être transmis à l'adaptateur via la classe LineMediationExtras
:
SetEnableAdSound(boolean)
: spécifie l'état de démarrage du son par défaut des annonces en bannière, interstitielles et avec récompense.
Voici un exemple de code montrant comment créer une requête d'annonce qui définit ces paramètres :
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
Codes d'erreur
Si l'adaptateur ne reçoit pas d'annonce de Line, les éditeurs peuvent vérifier l'erreur sous-jacente à partir de la réponse d'annonce à l'aide de ResponseInfo
dans les classes suivantes:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Voici les codes et les messages associés générés par l'adaptateur Line lorsqu'un annonce ne parvient pas à se charger :
Android
Code d'erreur | Domaine | Motif |
---|---|---|
1-10 | com.five_corp.ad | Le SDK Line a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez la documentation de Line. |
101 | com.google.ads.mediation.line | ID d'application manquant ou non valide. |
102 | com.google.ads.mediation.line | ID de créneau manquant ou non valide. |
103 | com.google.ads.mediation.line | La taille d'annonce demandée ne correspond pas à une taille de bannière compatible avec Line. |
104 | com.google.ads.mediation.line | Échec du chargement d'une annonce interstitielle ou avec récompense en raison de l'absence de contexte d'activité. |
105 | com.google.ads.mediation.line | Le SDK Line n'a pas réussi à afficher une annonce interstitielle ou avec récompense. |
106 | com.google.ads.mediation.line | Échec du chargement d'une annonce native en raison d'éléments manquants. |
iOS
Code d'erreur | Domaine | Motif |
---|---|---|
1-10 | Envoyé par le SDK Line | Le SDK Line a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez la documentation de Line. |
101 | com.google.ads.mediation.line | Paramètres de serveur non valides (par exemple, ID d'application ou d'emplacement manquants). |
102 | com.google.ads.mediation.line | La taille d'annonce demandée ne correspond pas à une taille de bannière compatible avec Line. |
103 | com.google.ads.mediation.line | Échec du chargement d'un composant Image d'icône d'information dans une annonce native. |
Journal des modifications du plug-in de médiation Unity de la ligne
Version 1.3.1
- Compatible avec la version 2.8.20240808.0 de l'adaptateur Android Line.
- Compatible avec la version 2.8.20240612.0 de l'adaptateur Line pour iOS.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.2.0.
Version 1.3.0
- Compatible avec l'adaptateur Android Line version 2.8.20240722.0.
- Compatible avec la version 2.8.20240612.0 de l'adaptateur Line pour iOS.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.2.0.
Version 1.2.0
- Compatible avec l'adaptateur Line Android version 2.7.20240515.0.
- Compatible avec la version 2.8.20240612.0 de l'adaptateur Line pour iOS.
- Il est conçu et testé avec le plug-in Google Mobile Ads Unity version 9.1.1.
Version 1.1.2
- Compatible avec l'adaptateur Android Line version 2.7.20240515.0.
- Compatible avec l'adaptateur Line pour iOS version 2.7.20240411.0.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.1.0.
Version 1.1.1
- Compatible avec l'adaptateur Android Line version 2.7.20240214.1.
- Compatible avec la version 2.7.20240411.0 de l'adaptateur iOS Line.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.1.0.
Version 1.1.0
- Ajout de la classe
LineMediationExtras
avec les méthodes suivantes pour permettre de transmettre des extras de médiation.SetEnabledAdSound(bool)
- Compatible avec la version 2.7.20240214.1 de l'adaptateur Android Line.
- Compatible avec la version 2.7.20240318.0 de l'adaptateur iOS Line.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.0.0.
Version 1.0.0
- Version initiale.
- Compatible avec l'adaptateur Line Android version 2.6.20230607.0.
- Compatible avec la version 2.6.20230609.0 de l'adaptateur Line pour iOS.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 8.5.1.