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

Ce guide explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces à partir de l'API Line à l'aide de la médiation, qui couvre 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 Line et l'adaptateur dans une iOS 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 avec leurs équivalents en anglais entre parenthèses.

Intégrations et formats d'annonces compatibles

L'adaptateur de médiation AdMob pour Line offre les fonctionnalités suivantes:

Intégration
Enchères
Cascade	^1
Formats
Bannière
Interstitiel
Accordé
Natif

¹ L'intégration de Waterfall est en version bêta ouverte.

Conditions requises

• Cible de déploiement iOS 12.0 ou version ultérieure

• Dernier SDK Google Mobile Ads

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

Étape 1: Définissez les configurations dans l'UI de ligne

Connectez-vous à votre compte Line.

Ajouter une application

Cliquez sur 広告枠管理 (Gestion des espaces publicitaires) > NUMBEROFデテア (Médias). Ensuite, cliquez sur Define規作成 (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 d'annonce. Ensuite, sélectionnez 詳細 (Détails).

Cliquez sur 㿽加 (Ajouter un emplacement).

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

Remarque :Contactez votre responsable de compte Line Ads Network pour pouvoir créer des emplacements d'annonces natives dans l'UI Line.

Notez l'ID de l'emplacement.

Étape 2: Configurez la demande d'élément de gamme dans l' AdMob 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.

Remarque :Vous ne devez configurer l'optimisation des sources d'annonces qu'une seule fois par réseau.

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

Important : Application ID doit être associé à l'application ciblée, comme dans l'Line UI.

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

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.

Utiliser CocoaPods (recommandé)

Ajoutez la ligne suivante au Podfile de votre projet:

pod 'GoogleMobileAdsMediationLine'

Dans la ligne de commande, exécutez la commande suivante:

pod install --repo-update

Intégration manuelle

• Téléchargez la dernière version du SDK Line et associez FiveAd.framework dans votre projet.
• Téléchargez la dernière version de l'adaptateur de ligne à partir du lien de téléchargement dans le journal des modifications et associez LineAdapter.framework à votre projet.

Étape 4: Ajoutez le code requis

Intégration de SKAdNetwork

Suivez la documentation de Line pour ajouter les identifiants SKAdNetwork au fichier Info.plist de votre projet.

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

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

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 réseau

L'adaptateur de ligne accepte un paramètre de requête supplémentaire qui peut lui être transmis à l'aide de la classe GADMediationAdapterLineExtras. Cette classe comprend les propriétés suivantes:

adAudio

Spécifie l'état par défaut du son des bannières, des interstitiels et des annonces avec récompense.

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

Swift

import LineAdapter
// ...

let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

Utiliser des annonces natives

Rendu des annonces

L'adaptateur de ligne renseigne les champs de description avancés des annonces natives pour un GADNativeAd.

Champ	Assets toujours inclus par l'adaptateur de ligne
Titre
Images
Corps
Icône de l'application	^1
Incitation à l'action
Star rating [Note]
Stocker
Prix

¹ Pour les annonces natives, le SDK Line ne fournit pas d'élément d'icône d'application. Au lieu de cela, l'adaptateur de ligne remplit l'icône d'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 à l'aide de GADResponseInfo.adNetworkInfoArray dans les classes suivantes:

GADMediationAdapterLine

Voici les codes et les messages associés générés par l'adaptateur de ligne lorsqu'une 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. 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 prise en charge au format Ligne.
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 à diffuser un interstitiel ou une annonce avec récompense.
106	com.google.ads.mediation.line	Échec du chargement d'une annonce native, car il manque des composants.
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 serveur non valides (par exemple, ID d'application ou ID d'emplacement manquant).
102	com.google.ads.mediation.line	La taille d'annonce demandée ne correspond pas à une taille de bannière prise en charge au format Ligne.
103	com.google.ads.mediation.line	Échec du chargement d'un composant Image représentant une icône d'informations dans l'annonce native.

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

Version 2.7.20240214.1

• Nécessite désormais la version minimale d'iOS 12.0.
• Nécessite désormais le SDK Google Mobile Ads 11.0 ou version ultérieure.
• Inclusion de Info.plist dans les frameworks dans LineAdapter.xcframework

Conçu et testé avec:

• SDK Google Mobile Ads version 11.0.1.
• SDK FiveAd version 2.7.20240214.

Version 2.7.20240214.0

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

Conçu et testé avec:

• SDK Google Mobile Ads version 11.0.1.
• SDK FiveAd version 2.7.20240214.

Version 2.7.20240126.0

• Compatibilité validée avec la version 2.7.20240126 du SDK FiveAd.
• Mise à jour de l'implémentation de l'adaptateur avec les nouveaux protocoles délégués du SDK FiveAd.

Conçu et testé avec:

• SDK Google Mobile Ads version 10.14.0.
• SDK FiveAd version 2.7.20240126.

Version 2.7.20231115.0

• Compatibilité validée avec la version 2.7.20231115 du SDK FiveAd.
• Inclusion de l'en-tête GADMediationAdapterLineExtras dans le modulemap.

Conçu et testé avec:

• SDK Google Mobile Ads version 10.14.0.
• SDK FiveAd version 2.7.20231115.

Version 2.6.20230609.1

• Ajout de GADMediationAdapterLineAudioState pour gérer l'état audio initial de la bannière, de l'interstitiel et de l'annonce avec récompense lorsqu'ils sont affichés pour la première fois.

Conçu et testé avec:

• SDK Google Mobile Ads version 10.14.0.
• SDK FiveAd version 2.6.20230609.

Version 2.6.20230609.0

• Version initiale
• Ajout de la compatibilité avec la cascade d'annonces pour les annonces au format bannière, interstitielles, avec récompense et native.
• Compatibilité validée avec la version 2.6.20230609 du SDK FiveAd.

Conçu et testé avec:

• SDK Google Mobile Ads version 10.9.0.
• SDK FiveAd version 2.6.20230609.