Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher annonces provenant de Line avec médiation sur les intégrations de cascades d'annonces. Elle explique comment ajouter des éléments à la campagne configuration de médiation, et comment intégrer le SDK Line et l'adaptateur dans une Android application.
L'interface du tableau de bord pour Line utilise du texte en japonais pour ses étiquettes, des boutons et des descriptions. Les captures d'écran de ce guide n'ont pas été traduit. Toutefois, dans les descriptions et les instructions de ce guide, sont traduits et leur équivalent en anglais est indiqué entre parenthèses.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation pour Line offre 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 d'annonces est en cours en version bêta fermée, contactez votre responsable de compte pour demander l'accès.
Conditions requises
- Niveau d'API Android 21 ou supérieur
Le dernier SDK Google Mobile Ads
Finaliser la médiation Guide de démarrage
Étape 1: Définir les configurations dans l'interface utilisateur de ligne
Étape 2: Configurez la demande de campagne Ad Manager dans l'UI
É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 l'implémentation suivante :
les dépendances et les configurations. Utiliser les dernières versions du SDK Line
et l'adaptateur:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:line:2.8.20240808.0")
}
Intégration manuelle
Téléchargez la dernière version de
.aar
du SDK Line et l'ajouter à votre projet.Accédez à Artefacts d'adaptateur de ligne. dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez Line le fichier
.aar
de l'adaptateur 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 Ad Manager.
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:
enableAdSound
- Un élément
boolean
pour spécifier l'état de démarrage du son par défaut de la bannière les annonces interstitielles et 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();
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
Rendu des annonces
L'adaptateur de ligne renseigne les éléments suivants :
champs
pendant
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 |
1 Pour les annonces natives, le SDK Line ne fournit pas d'asset d'icône d'application. À la place, l'adaptateur de ligne insère 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 de la réponse d'annonce
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 de ligne lorsque l'annonce ne se charge pas:
Code d'erreur | Domaine | Motif |
---|---|---|
1-10 | com.five_corp.ad | Le SDK Line a renvoyé une erreur spécifique au SDK. Voir Documentation de Line pour en savoir plus. |
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 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 2.8.20240808.0
- Compatibilité validée avec le SDK FiveAd version 2.8.20240808.0
Conçu et testé avec:
- SDK Google Mobile Ads version 23.2.0.
- SDK FiveAd version 2.8.20240808.0
Version 2.8.20240722.0
- Compatibilité validée avec le SDK FiveAd version 2.8.20240722.0
Conçu et testé avec:
- SDK Google Mobile Ads version 23.2.0.
- SDK FiveAd version 2.8.20240722.0
Version 2.7.20240515.0
- Compatibilité validée avec le SDK FiveAd version 2.7.20240515.0
Conçu et testé avec:
- SDK Google Mobile Ads version 23.1.0.
- SDK FiveAd version 2.7.20240515.0
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
, désormais obsolète, en faveur deFiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
etFiveAdNativeEventListener
. - 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
LineExtras
permettant aux éditeurs de définir des paramètres audio par défaut pour les bannières, les annonces interstitielles 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.