Intégrer le réseau LINE Ads à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces du LINE Ads Network à l'aide de la médiation AdMob, 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 dans une application Android.

L'interface du tableau de bord LINE Ads Network utilise du texte en japonais pour les libellés, les boutons et les 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 leur équivalent en anglais entre parenthèses.

Intégrations et formats d'annonces acceptés

L'adaptateur de médiation pour LINE Ads Network présente les fonctionnalités suivantes :

¹ L'intégration des enchères est en version bêta fermée. Contactez votre responsable de compte pour demander l'accès.

Conditions requises

• Niveau d'API Android 23 ou supérieur

• Dernière version du SDK Google Mobile Ads

• Suivez le guide de démarrage sur la médiation.

Étape 1 : Configurez les configurations dans l'UI LINE Ads Network

Inscrivez-vous et connectez-vous à votre compte LINE Ads Network.

Ajouter une application

Cliquez sur 広告枠管理 (Ad Slot Management) > メディア (Media). Cliquez ensuite sur 新規作成 (Créer).

Remplissez le formulaire, puis cliquez sur 登録 (S'inscrire).

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 publicitaire. Ensuite, sélectionnez 詳細 (Détails).

Cliquez sur スロット 追加 (Ajouter un emplacement).

Remplissez le formulaire pour obtenir des informations sur le créneau. Pour Type d'enchères, sélectionnez Standard pour configurer cet emplacement pour la médiation en cascade ou Enchères SDK Google pour configurer cet emplacement pour les enchères. Une fois le formulaire rempli, cliquez sur 登録 (S'inscrire).

Notez l'ID de l'emplacement.

Mettre à jour votre fichier app-ads.txt

Authorized Sellers for Apps (app-ads.txt) est une initiative de l'IAB Tech Lab qui vous permet de vendre l'inventaire publicitaire de votre application uniquement par l'intermédiaire de canaux de distribution que vous avez identifiés comme étant 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 déjà fait, configurez un fichier app-ads.txt pour votre application.

Pour implémenter app-ads.txt pour LINE Ads Network, consultez À propos d'app-ads.txt.

Étape 2 : Configurez la demande LINE Ads Network dans l'UI AdMob

Configurer les paramètres de médiation pour votre bloc d'annonces

Vous devez ajouter LINE Ads Network à 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 l'éditer, puis passez à la section Ajouter LINE Ads Network comme source d'annonce.

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 et sélectionnez les zones géographiques à cibler. Ensuite, définissez 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 être remplie avec les blocs d'annonces que vous avez sélectionnés :

Ajouter LINE Ads Network comme source d'annonces

Enchères

Dans la fiche Enchères de la section Sources d'annonces, sélectionnez Ajouter une source d'annonce. Sélectionnez ensuite LINE Ads Network.

Cliquez sur Signer un contrat partenaire et configurez un partenariat d'enchères avec LINE Ads Network.



Cliquez sur Accepter et continuer, puis sur Continuer.



Si vous avez déjà un mappage pour LINE Ads Network, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.



Ensuite, saisissez l'ID d'application et l'ID d'emplacement obtenus dans la section précédente. Cliquez ensuite sur OK.

Cascade

Dans la fiche Cascade de la section Sources d'annonces, sélectionnez Ajouter une source d'annonce.

Sélectionnez LINE Ads Network et activez le bouton Optimiser. Saisissez le nom d'utilisateur et le mot de passe obtenus dans la section précédente pour configurer l'optimisation des sources d'annonces pour LINE Ads Network. Saisissez ensuite une valeur d'eCPM pour le réseau LINE Ads, puis cliquez sur Continuer.



Si vous avez déjà un mappage pour LINE Ads Network, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.

Ensuite, saisissez l'ID d'application et l'ID d'emplacement obtenus dans la section précédente. Cliquez ensuite sur OK.

Étape 3 : Importer le SDK et l'adaptateur LINE Ads Network

Intégration d'Android Studio (recommandée)

Dans le fichier build.gradle.kts au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes. Utilisez les dernières versions du SDK et de l'adaptateur LINE Ads Network :

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.google.ads.mediation:line:2.9.20250519.0")
}

Intégration manuelle

1. Téléchargez la dernière version du fichier .aar du SDK LINE Ads Network et ajoutez-le à votre projet.

2. Accédez aux artefacts de l'adaptateur LINE Ads Network dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier .aar de l'adaptateur LINE Ads Network et ajoutez-le à votre projet.

Étape 4 : Ajoutez le code requis

Aucun code supplémentaire n'est requis pour l'intégration de LINE Ads Network.

Étape 5 : Tester votre implémentation

Activer les annonces tests

Assurez-vous d'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

L'adaptateur LINE Ads Network accepte un paramètre de requête supplémentaire qui peut être transmis à l'adaptateur à l'aide de la classe LineExtras. Le constructeur de cette classe inclut les paramètres suivants :

enableAdSound

A boolean pour spécifier l'état de démarrage du son par défaut des bannières, des interstitiels et des annonces avec récompense.

Voici un exemple de code montrant comment créer une demande d'annonce qui définit ces paramètres :

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

Utiliser des annonces natives

Affichage des annonces

L'adaptateur LINE Ads Network remplit les descriptions des champs avancés des annonces natives pour un NativeAd.

¹ Pour les annonces natives, le SDK LINE Ads Network ne fournit pas d'icône d'application. Au lieu de cela, l'adaptateur LINE Ads Network remplit l'icône de l'application avec une image transparente.

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir d'annonce de LINE Ads Network, vous pouvez vérifier l'erreur sous-jacente à partir de la réponse de l'annonce à l'aide de ResponseInfo.getAdapterResponses() sous les classes suivantes :

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

Voici les codes et les messages associés renvoyés par l'adaptateur LINE Ads Network lorsqu'une annonce ne parvient pas à se charger :

Journal des modifications de l'adaptateur de médiation LINE pour Android

Version 2.9.20250519.0

• Compatibilité vérifiée avec la version 2.9.20250519 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 24.3.0.
• Version 2.9.20250519.0 du SDK FiveAd.

Version 2.9.20250317.1

• Correction des dimensions de chargement des bannières pour les annonces avec enchères avec la nouvelle API FiveAd

Conçu et testé avec :

• SDK Google Mobile Ads version 24.1.0.
• Version 2.9.20250317.0 du SDK FiveAd

Version 2.9.20250317.0

• Compatibilité vérifiée avec la version 2.9.20250317 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 24.1.0.
• Version 2.9.20250317.0 du SDK FiveAd

Version 2.9.20250110.1

• Le niveau d'API Android minimal requis est désormais 23.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 24.0.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 24.0.0.
• Version 2.9.20250110.0 du SDK FiveAd

Version 2.9.20250110.0

• Suppression de la classe UnifiedNativeAdMapper obsolète au profit de NativeAdMapper
• Correction du processus de collecte des signaux.
• Processus d'initialisation fixe pour les formats d'annonces interstitielles et avec récompense en cascade.
• Compatibilité vérifiée avec la version 2.9.20250110 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 23.6.0.
• Version 2.9.20250110.0 du SDK FiveAd

Version 2.9.20241129.0

• Ajout de la prise en charge des enchères pour les formats d'annonce bannière, interstitiel, avec récompense et natif.
• Compatibilité vérifiée avec la version 2.9.20241129 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 23.5.0.
• Version 2.9.20241129.0 du SDK FiveAd

Version 2.8.20240827.0

• Compatibilité vérifiée avec la version 2.8.20240827 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 23.3.0.
• Version 2.8.20240827.0 du SDK FiveAd

Version 2.8.20240808.0

• Compatibilité vérifiée avec la version 2.8.20240808 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 23.2.0.
• Version 2.8.20240808.0 du SDK FiveAd

Version 2.8.20240722.0

• Compatibilité vérifiée avec la version 2.8.20240722 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 23.2.0.
• Version 2.8.20240722.0 du SDK FiveAd

Version 2.7.20240515.0

• Compatibilité vérifiée avec la version 2.7.20240515 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 23.1.0.
• Version 2.7.20240515.0 du SDK FiveAd

Version 2.7.20240214.1

• La version minimale requise du SDK Google Mobile Ads est désormais la version 23.0.0.
• Compatibilité vérifiée avec la version 2.7.20240214 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 23.0.0.
• Version 2.7.20240214.0 du SDK FiveAd.

Version 2.7.20240214.0

• Compatibilité vérifiée avec la version 2.7.20240214 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.6.0.
• Version 2.7.20240214.0 du SDK FiveAd.

Version 2.7.20240126.0

• Compatibilité vérifiée avec la version 2.7.20240126 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.6.0.
• Version 2.7.20240126.0 du SDK FiveAd.

Version 2.7.20240112.0

• Suppression de FiveAdViewEventListener obsolète au profit de FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener et FiveAdNativeEventListener.
• Compatibilité vérifiée avec la version 2.7.20240112 du SDK FiveAd.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 22.6.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.6.0.
• Version 2.7.20240112 du SDK FiveAd.

Version 2.6.20230607.1

• Ajout de la classe LineExtras pour permettre aux éditeurs de définir les paramètres audio par défaut pour les formats d'annonces bannière, interstitiel et avec récompense.
• La version minimale requise du SDK Google Mobile Ads est désormais la version 22.4.0.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.4.0.
• Version 2.6.20230607 du SDK FiveAd.

Version 2.6.20230607.0

• Version initiale.
• Ajout de la prise en charge des formats d'annonces bannière, interstitiel, avec récompense et natif.
• Compatibilité vérifiée avec la version 2.6.20230607 du SDK FiveAd.

Conçu et testé avec :

• SDK Google Mobile Ads version 22.1.0.
• Version 2.6.20230607 du SDK FiveAd.