Intégrer le réseau LINE Ads à la médiation (bêta)

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 Android.

L'interface du tableau de bord du LINE Ads Network 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 pour le réseau LINE Ads propose les fonctionnalités suivantes:

Intégration
Enchères
Cascade  1
Formats
Bannière
Interstitiel
Avec récompense
Natif

1 L'intégration de la cascade est disponible en version bêta ouverte.

Conditions requises

  • Niveau d'API Android 21 ou supérieur

Étape 1: Configurez les configurations dans l'interface utilisateur du réseau LINE Ads

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: Configurer la demande du réseau LINE Ads dans l'interface utilisateur d'Ad Manager

Connectez-vous à votre compte Ad Manager.

Ajouter LINE Ads Network dans "Entreprises"

Enchères

Cette étape n'est pas obligatoire pour les intégrations d'enchères.

Cascade

Accédez à Admin > Entreprises, puis cliquez sur le bouton Nouvelle entreprise dans l'onglet Toutes les entreprises. Sélectionnez Réseau publicitaire.

Sélectionnez Réseau publicitaire LINE comme Réseau publicitaire, saisissez un nom unique et activez la médiation.

Vous n'avez pas besoin de saisir de nom d'utilisateur ni de mot de passe. Lorsque vous avez terminé, cliquez sur Enregistrer.

Activer le partage des signaux sécurisés

Enchères

Accédez à Admin > Paramètres généraux. Accédez à l'onglet Paramètres de compte Ad Exchange, puis vérifiez et activez l'option Partage de signaux sécurisé. Cliquez sur Enregistrer.

Cascade

Cette étape n'est pas obligatoire pour les intégrations en cascade.

Partager un signal sécurisé dans les demandes d'enchères

Enchères

Accédez à Inventaire > Signaux sécurisés. Sous Signaux sécurisés, recherchez LINE, puis activez l'option Activer l'intégration d'applications.

Cliquez sur Enregistrer.

Cascade

Cette étape n'est pas obligatoire pour les intégrations en cascade.

Autoriser le partage de signaux sécurisés pour les enchères par SDK

Enchères

Accédez à Diffusion > Paramètres des canaux de demande. Dans l'onglet Paramètres par défaut, activez l'option Autoriser le partage de signaux sécurisés pour Enchères par SDK.

Cliquez sur Enregistrer.

Cascade

Cette étape n'est pas obligatoire pour les intégrations en cascade.

Configurer les enchères sur LINE Ads Network

Enchères

Accédez à Diffusion > Enchérisseurs, puis cliquez sur Accéder aux enchères par SDK.

Cliquez sur Nouvel enchérisseur.

Sélectionnez Réseau LINE Ads comme enchérisseur.

Cliquez sur Continuer pour activer les enchères par SDK pour cet enchérisseur.

Cliquez sur OK.

Cascade

Cette étape n'est pas obligatoire pour les intégrations en cascade.

Configurer la mise en correspondance des blocs d'annonces

Enchères

Accédez à Diffusion > Enchérisseurs, puis cliquez sur Accéder aux enchères par SDK.

Sélectionnez l'entreprise pour le réseau publicitaire LINE.

Accédez à l'onglet Mise en correspondance des blocs d'annonces, puis cliquez sur Nouvelle mise en correspondance des blocs d'annonces.

Sélectionnez Bloc d'annonces spécifique. Sélectionnez un bloc d'annonces et un format, Application mobile comme Type d'inventaire, puis votre Application mobile. Saisissez ensuite l'ID de l'application et l'ID de l'emplacement obtenus dans la section précédente. Enfin, cliquez sur Enregistrer.

Cascade

Accédez à Diffusion > Groupes de rendement, puis cliquez sur le bouton Nouveau groupe de rendement. Sélectionnez votre application mobile.

Faites défiler la page vers le bas, puis cliquez sur Ajouter un partenaire de rendement.

Sélectionnez l'entreprise que vous avez créée pour LINE Ads Network dans la section précédente. Sélectionnez Médiation SDK pour mobile comme Type d'intégration, Android comme Plate-forme et Actif comme État.

Saisissez l'ID de l'application et l'ID de l'emplacement obtenus dans la section précédente, ainsi que la valeur du CPM par défaut. Cliquez sur Enregistrer.

Étape 3: Importer le SDK et l'adaptateur du réseau publicitaire LINE

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 du réseau publicitaire LINE:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:line:2.9.20250110.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 réseau LINE Ads et ajoutez-le à votre projet.

Étape 4: Ajoutez le code requis

Aucun code supplémentaire n'est requis pour intégrer le réseau LINE Ads.

Étape 5: Tester votre implémentation

Activer les annonces tests

Assurez-vous d'enregistrer votre appareil de test pour Ad Manager.

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. Ce constructeur de classe inclut les paramètres suivants:

enableAdSound
Un boolean pour spécifier l'état de démarrage du son par défaut des annonces bannières, 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:

Java 

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

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

Kotlin 

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

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

Utiliser des annonces natives

Affichage des annonces

L'adaptateur du réseau LINE Ads renseigne les champs suivants pour un NativeAd.

Champ Éléments toujours inclus par l'adaptateur LINE Ads Network
Titre
Image
Corps
Icône de l'application 1
Incitation à l'action
Note
Boutique
Prix

1 Pour les annonces natives, le SDK LINE Ads Network ne fournit pas d'asset d'icône d'application. À la place, l'adaptateur LINE Ads Network renseigne l'icône de l'application avec une image transparente.

Codes d'erreur

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

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

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:

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 à diffuser un interstitiel ni une annonce avec récompense.
106 com.google.ads.mediation.line Échec du chargement d'une annonce native en raison d'éléments manquants.

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

Version suivante

  • Mise à jour pour utiliser le contexte plutôt que l'activité pour charger toutes les annonces de format.
  • Correction de la façon dont le mode test est défini sur le SDK LINE.

Version 2.9.20250110.0

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

Compilé et testé avec:

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

Version 2.9.20241129.0

  • Ajout de la compatibilité avec les enchères pour les formats d'annonces bannière, interstitielle, avec récompense et native.
  • Compatibilité vérifiée avec le SDK FiveAd version 2.9.20241129.0

Compilé et testé avec:

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

Version 2.8.20240827.0

  • Compatibilité vérifiée avec le SDK FiveAd version 2.8.20240827.0

Compilé et testé avec:

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

Version 2.8.20240808.0

  • Compatibilité vérifiée avec le SDK FiveAd version 2.8.20240808.0

Compilé et testé avec:

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

Version 2.8.20240722.0

  • Compatibilité vérifiée avec le SDK FiveAd version 2.8.20240722.0

Compilé et testé avec:

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

Version 2.7.20240515.0

  • Compatibilité vérifiée avec le SDK FiveAd version 2.7.20240515.0

Compilé et testé avec:

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

Version 2.7.20240214.1

  • Mise à jour de la version minimale requise du SDK Google Mobile Ads : 23.0.0.
  • Compatibilité vérifiée avec le SDK FiveAd version 2.7.20240214.0.

Compilé et testé avec:

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

Version 2.7.20240214.0

  • Compatibilité vérifiée avec le SDK FiveAd version 2.7.20240214.0.

Compilé et testé avec:

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

Version 2.7.20240126.0

  • Compatibilité vérifiée avec le SDK FiveAd version 2.7.20240126.0.

Compilé et testé avec:

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

Version 2.7.20240112.0

  • FiveAdViewEventListener est désormais obsolète et remplacé par FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener et FiveAdNativeEventListener.
  • Compatibilité vérifiée avec la version 2.7.20240112 du SDK FiveAd.
  • Mise à jour de la version minimale requise du SDK Google Mobile Ads : 22.6.0.

Compilé et testé avec:

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

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 en bannière, interstitielle et avec récompense.
  • Mise à jour de la version minimale requise du SDK Google Mobile Ads : 22.4.0.

Compilé et testé avec:

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

Version 2.6.20230607.0

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

Compilé et testé avec:

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