Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces provenant de LINE Ads Network à l'aide de la médiation, en couvrant les intégrations en cascade. Il explique comment ajouter LINE Ads Network à la configuration de médiation d'un bloc d'annonces et comment intégrer le SDK et l'adaptateur LINE Ads Network à une application Unity.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation Ad Manager pour le réseau LINE Ads propose les fonctionnalités suivantes:
Intégration | |
---|---|
Enchères | |
Cascade | 1 |
Formats | |
Bannière | |
Interstitiel | |
Avec récompense |
1 L'intégration de la cascade est en version bêta fermée. Contactez votre responsable de compte pour en demander l'accès.
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 Ads Network.
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. Sélectionnez ensuite 詳細 (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 du réseau LINE Ads dans l' Ad Manager interface utilisateur
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 du réseau LINE Ads
OpenUPM-CLI
Si vous avez installé OpenUPM-CLI, vous pouvez installer le plug-in de médiation du réseau publicitaire LINE Ads pour 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.line
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 LINE Ads Network Mediation, puis cliquez sur Install (Installer).
Package Unity
Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour le réseau LINE Ads à partir du lien de téléchargement dans le journal des modifications, puis extrayez le fichier GoogleMobileAdsLineMediation.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 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 > 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: Ajoutez le code requis
Android
Aucun code supplémentaire n'est requis pour intégrer le réseau LINE Ads.
iOS
Intégration de SKAdNetwork
Suivez la documentation de LINE Ads Network 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.
Valider les annonces tests
Pour vérifier que vous recevez des annonces tests du réseau LINE Ads, 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 Ads Network (cascade).
Étapes facultatives
Paramètres spécifiques au réseau
Le plug-in de médiation Unity du LINE Ads Network 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 parvient pas à recevoir une annonce de LINE Ads Network, 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
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 du réseau publicitaire LINE lorsqu'une annonce ne parvient pas à se charger:
Android
Code d'erreur | Domaine | Motif |
---|---|---|
1-10 | com.five_corp.ad | Le SDK du réseau publicitaire LINE a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez la documentation du réseau publicitaire 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 d'annonce bannière compatible avec LINE Ads Network. |
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 Ads Network n'a pas réussi à afficher un interstitiel ou une annonce 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ée par le SDK LINE Ads Network | Le SDK du réseau publicitaire LINE a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez la documentation du réseau publicitaire 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 d'annonce bannière compatible avec LINE Ads Network. |
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.4.0
- Compatible avec la version 2.8.20240827.0 de l'adaptateur Android Line.
- Compatible avec la version 2.9.20241106.1 de l'adaptateur Line pour iOS.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.4.0.
Version 1.3.1
- Compatible avec l'adaptateur Android Line version 2.8.20240808.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.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 Android Line version 2.7.20240515.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.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 la version 2.7.20240214.1 de l'adaptateur Android Line.
- 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.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 l'adaptateur Line pour iOS version 2.7.20240318.0.
- Compilé et testé avec le plug-in Google Mobile Ads Unity 9.0.0.
Version 1.0.0
- Version initiale.
- Compatible avec la version 2.6.20230607.0 de l'adaptateur Android Line.
- 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.