Intégrer une ligne à la médiation (bêta)

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

L'interface du tableau de bord de Line 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 Line présente les fonctionnalités suivantes:

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

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

Conditions requises

• Niveau d'API Android 21 ou supérieur

• Dernière version du SDK Google Mobile Ads

• 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. Sélectionnez ensuite 詳細 (Détails).

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

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

Remarque :Contactez votre responsable de compte du réseau Line Ads pour pouvoir créer des emplacements d'annonces natives dans l'interface utilisateur de Line.

Notez l'ID de l'emplacement.

Étape 2: Configurer la demande de ligne dans l'interface utilisateur AdMob

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

Vous devez ajouter Line à 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 le modifier, puis passez à la section Ajouter Line en tant que source d'annonces.

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, puis sélectionnez les zones géographiques à cibler. Définissez ensuite 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 afficher les blocs d'annonces que vous avez sélectionnés:

Ajouter Line comme source d'annonces

Enchères

Sous la fiche Enchères, dans la section Sources d'annonces, sélectionnez Ajouter une source d'annonces. Sélectionnez ensuite Ligne.
Cliquez sur Signer un contrat partenaire et configurez un partenariat pour les enchères avec Line.
Cliquez sur Accepter, puis sur Continuer.
Si vous avez déjà un mappage pour "Ligne", vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.
Saisissez ensuite l'ID de l'application et l'ID de l'emplacement obtenus dans la section précédente. Cliquez ensuite sur OK.

Important: L'ID d'application doit être associé à l'application ciblée, comme dans l'interface utilisateur de Line.

Cascade

Sous la fiche Cascade d'annonces, dans la section Sources d'annonces, sélectionnez Ajouter une source d'annonces. Sélectionnez ensuite Ligne.

Sélectionnez Ligne. Saisissez ensuite une valeur d'eCPM pour la ligne, puis cliquez sur Continuer.

Remarque: Vous n'avez besoin de configurer l'optimisation des sources d'annonces qu'une seule fois par réseau.

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

Saisissez ensuite l'ID de l'application et l'ID de l'emplacement obtenus dans la section précédente. Cliquez ensuite sur OK.

Important: L'ID d'application doit être associé à l'application ciblée, comme dans l'interface utilisateur de Line.

Étape 3: Importer le SDK et l'adaptateur Line

Remarque :Si vous n'intégrez pas les versions compatibles du SDK Line et du SDK Google Mobile Ads, vous risquez de rencontrer des problèmes de compilation.

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:

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

Intégration manuelle

1. Téléchargez la dernière version du fichier .aar du SDK Line, puis ajoutez-le à votre projet.

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

Étape 4: Ajoutez le code requis

Aucune ligne de code supplémentaire n'est requise pour l'intégration de Line.

Étape 5: Tester votre implémentation

Activer les annonces tests

Veillez à enregistrer votre appareil de test pour AdMob.

Suivez les instructions de la documentation Line pour activer les annonces tests Line.

Important :Désactivez le mode test pour AdMob et Line avant de publier votre application.

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 d'annonces).

Étapes facultatives

Paramètres spécifiques au réseau

L'adaptateur Line 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ébut 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();

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

Kotlin

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 de ligne renseigne les descriptions avancées des champs des annonces natives suivantes pour un NativeAd.

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

¹ Pour les annonces natives, le SDK Line ne fournit pas d'asset d'icône d'application. À la place, l'adaptateur Line 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, 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 Line lorsqu'une annonce ne parvient pas à se charger:

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 d'annonce 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.

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

Version suivante

• Implémentation d'AdLoader pour activer le RTB pour les bannières.
• Implémentation d'AdLoader pour activer les enchères en temps réel pour les annonces interstitielles.
• Implémentation d'AdLoader pour activer le RTB pour les annonces avec récompense.
• Implémentation d'AdLoader pour activer les enchères en temps réel pour les annonces natives.

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.