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 Android application.
L'interface du tableau de bord de Line utilise du texte en 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 et leur équivalent en anglais est indiqué entre parenthèses.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation AdMob pour la ligne offre les fonctionnalités suivantes:
| Intégration | |
|---|---|
| Enchères | |
| Cascade | 1 |
| Formats | |
| Bannière | |
| Interstitiel | |
| Accordé | |
| Il s'agit de ma langue maternelle | |
1 L'intégration de Waterfall est en bêta ouverte.
Conditions requises
- Niveau d'API Android 21 ou supérieur
Le dernier SDK Google Mobile Ads
Suivez la procédure de médiation. Guide de démarrage
Étape 1: Définir les configurations dans l'interface utilisateur de ligne
Log in to your Line account.
Add a new application
Click 広告枠管理 (Ad Slot Management) > メディア (Media). Then, click 新規作成 (Create New).
Fill out the form and click 登録 (Register).
Take note of the Application ID.
Create an ad placement
Click the ID of the application you want to add an ad placement. Then, select 詳細 (Detail).
Click スロット 追加 (Add Slot).
Fill out the form and once done, click (登録) Register.
Take note of the Slot ID.
Étape 2: Configurez la demande de campagne AdMob dans l'UI
Configurer les paramètres de médiation pour votre bloc d'annonces
Vous devez ajouter Line à la configuration de la médiation pour votre bloc d'annonces.
Connectez-vous à 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 à l'étape Ajouter Line comme source d'annonces.
Pour créer un groupe de médiation, sélectionnez Créer un groupe de médiation.
Saisissez le format de votre annonce et votre plate-forme, 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'annoncesAdMob existants. Cliquez ensuite sur Done (OK).
Vous devriez maintenant voir la fiche des blocs d'annonces que vous avez sélectionnés:
Ajouter Line comme source d'annonces
Sous la fiche Waterfall (Cascade d'annonces) de la section Ad Sources (Sources d'annonces), sélectionnez Add Ad Source (Ajouter une source d'annonces). Sélectionnez ensuite Line.
Sélectionnez Line. Ensuite, saisissez une valeur d'eCPM pour Line et cliquez sur Continuer.
Si vous disposez déjà d'un mappage pour Line, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.
Saisissez ensuite les Application ID and Slot IDobtenus à la section précédente. Cliquez ensuite sur Done (OK).
Étape 3: Importez le SDK Line et l'adaptateur
Intégration d'Android Studio (recommandé)
Dans le fichier build.gradle.kts au niveau de l'application, ajoutez les configurations et dépendances d'implémentation suivantes. Utilisez les dernières versions du SDK Line et de l'adaptateur:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.1.0")
implementation("com.google.ads.mediation:line:2.7.20240515.0")
}
Intégration manuelle
Téléchargez la dernière version du fichier
.aardu SDK Line, puis ajoutez-la à votre projet.Accédez aux artefacts d'adaptateur de ligne dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier
.aarde l'adaptateur de ligne et ajoutez-le à votre projet.
Étape 4: Ajoutez le code requis
Aucun code supplémentaire n'est requis pour l'intégration de Line.
Étape 5: Testez votre implémentation
Activer les annonces tests
Veillez à enregistrer votre appareil de test pour AdMob.
Suivez les instructions dans Documentation de Line pour savoir comment activer les annonces de test de ligne.
Valider les annonces tests
Pour vérifier que vous recevez des annonces tests deLine, activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de Line (Waterfall) sources d'annonces.
Étapes facultatives
Paramètres propres au réseau
L'adaptateur de ligne 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:
enableAdSoundbooleanpour 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:
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
Rendu des annonces
L'adaptateur de ligne renseigne les
descriptions des champs avancés des annonces natives
pour un
NativeAd.
| Champ | Éléments toujours inclus par l'adaptateur de ligne |
|---|---|
| Titre principal | |
| Image | |
| Corps | |
| Icône de l'appli | 1 |
| Incitation à l'action | |
| Star rating [Note] | |
| Boutique | |
| Prix |
1 Pour les annonces natives, le SDK Line ne fournit pas d'élément d'icône d'application. Au lieu de cela, l'adaptateur Line remplit l'icône de l'application avec une image transparente.
Codes d'erreur
Si l'adaptateur ne reçoit pas d'annonce de Line, vous pouvez vérifier l'erreur sous-jacente dans la réponse d'annonce à l'aide de
ResponseInfo.getAdapterResponse() 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 de ligne en cas d'échec du chargement d'une annonce:
| 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 d'emplacement 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'un interstitiel ou d'une annonce avec récompense en raison d'un contexte d'activité manquant. |
| 105 | com.google.ads.mediation.line | Le SDK Line n'a pas pu diffuser d'interstitiel ou d'annonce avec récompense. |
| 106 | com.google.ads.mediation.line | Échec du chargement d'une annonce native en raison d'éléments manquants. |
| 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 (ID d'application ou ID d'emplacement manquant, par exemple). |
| 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 l'annonce native. |
Journal des modifications de l'adaptateur de médiation Android LINE
Version 2.7.20240214.1
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 23.0.0.
- La compatibilité avec la version 2.7.20240214.0 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 23.0.0.
- SDK FiveAd version 2.7.20240214.0.
Version 2.7.20240214.0
- La compatibilité avec la version 2.7.20240214.0 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK FiveAd version 2.7.20240214.0.
Version 2.7.20240126.0
- La compatibilité avec la version 2.7.20240126.0 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK FiveAd version 2.7.20240126.0.
Version 2.7.20240112.0
- Suppression de
FiveAdViewEventListener, devenu obsolète, au profit deFiveAdCustomLayoutEventListener,FiveAdVideoRewardEventListener,FiveAdInterstitialEventListeneretFiveAdNativeEventListener. - La compatibilité avec la version 2.7.20240112 du SDK FiveAd a été vérifiée.
- Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.6.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.6.0.
- SDK FiveAd version 2.7.20240112.
Version 2.6.20230607.1
- Ajout de la classe
LineExtraspermettant aux éditeurs de définir les paramètres sonores par défaut pour les bannières, les interstitiels et les annonces avec récompense. - Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.4.0.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.4.0.
- SDK FiveAd version 2.6.20230607.
Version 2.6.20230607.0
- Version initiale.
- Il est désormais compatible avec les bannières, les interstitiels, les annonces avec récompense et les annonces natives.
- La compatibilité avec la version 2.6.20230607 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 22.1.0.
- SDK FiveAd version 2.6.20230607.