Intégrer le réseau LINE Ads à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces du LINE Ads Network à l'aide de la médiation, y compris 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 dans une application iOS.

L'interface du tableau de bord LINE Ads Network utilise du texte en japonais pour les libellés, les boutons et les 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 leur équivalent en anglais entre parenthèses.

Intégrations et formats d'annonces acceptés

L'adaptateur de médiation pour LINE Ads Network présente les fonctionnalités suivantes :

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

1 Les annonces natives (pour les enchères) sont disponibles en version bêta fermée. Contactez votre responsable de compte pour demander l'accès.

Conditions requises

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

  • [Pour les enchères]: Pour intégrer tous les formats d'annonces compatibles dans les enchères, utilisez l'adaptateur LINE Ads Network 2.8.20240827.0 ou version ultérieure (dernière version recommandée).

Étape 1 : Configurez les configurations dans l'UI LINE Ads Network

Inscrivez-vous et connectez-vous à votre compte LINE Ads Network.

Ajouter une application

Cliquez sur 広告枠管理 (Ad Slot Management) > メディア (Media). Cliquez ensuite sur 新規作成 (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 publicitaire. Ensuite, sélectionnez 詳細 (Détails).

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

Remplissez le formulaire pour obtenir des informations sur le créneau. Pour Type d'enchères, sélectionnez Standard pour configurer cet emplacement pour la médiation en cascade ou Enchères SDK Google pour configurer cet emplacement pour les enchères. Une fois le formulaire rempli, cliquez sur 登録 (S'inscrire).

Notez l'ID de l'emplacement.

Mettre à jour votre fichier app-ads.txt

Authorized Sellers for Apps (app-ads.txt) est une initiative de l'IAB Tech Lab qui vous permet de vendre l'inventaire publicitaire de votre application uniquement par l'intermédiaire de canaux de distribution que vous avez identifiés comme étant autorisés. Pour éviter une perte importante de revenus publicitaires, vous devez implémenter un fichier app-ads.txt. Si vous ne l'avez pas encore fait, créez un fichier app-ads.txt pour Ad Manager.

Pour implémenter app-ads.txt pour LINE Ads Network, consultez À propos d'app-ads.txt.

Étape 2 : Configurez la demande LINE Ads Network dans l'UI Ad Manager

Connectez-vous à votre compte Ad Manager.

Ajouter LINE Ads Network dans "Sociétés"

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 LINE Ads Network comme réseau publicitaire, saisissez un nom unique et activez la médiation. Activez l'option Collecte automatique des données, puis saisissez le nom d'utilisateur et le mot de passe obtenus dans la section précédente.

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és. Cliquez sur Enregistrer.

Cascade

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

Partager des signaux sécurisés dans les demandes d'enchères

Enchères

Accédez à Inventaire > Signaux sécurisés. Sous Signaux sécurisés, recherchez LINE et activez l'option Activer l'intégration dans les 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 SDK Bidding.

Cliquez sur Enregistrer.

Cascade

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

Configurer les enchères 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 LINE Ads Network 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 LINE Ads Network.

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 et votre application mobile. Saisissez ensuite l'ID d'application et l'ID d'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. Choisissez Médiation SDK pour mobile comme Type d'intégration, iOS comme Plate-forme et Actif comme État.

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

Remarque : Laissez quelques jours à la collecte des données automatisée pour que le CPM dynamique d'un réseau de médiation puisse être calculé avec précision. Une fois qu'il est possible de calculer l'eCPM, celui-ci est automatiquement mis à jour pour vous.

Étape 3 : Importer le SDK et l'adaptateur LINE Ads Network

Ajoutez la ligne suivante au fichier Podfile de votre projet :

pod 'GoogleMobileAdsMediationLine'

Depuis la ligne de commande, exécutez :

pod install --repo-update

Intégration manuelle

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

Étape 4 : Ajoutez le code requis

Intégration de SKAdNetwork

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

É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 GADMediationAdapterLineExtras. Cette classe inclut les propriétés suivantes :

adAudio
Spécifie l'état de démarrage du son par défaut des bannières, des annonces interstitielles 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 :

Swift

import LineAdapter
// ...

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

Objective-C

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

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

Utiliser des annonces natives

Affichage des annonces

L'adaptateur LINE Ads Network renseigne les champs suivants pour un GADNativeAd.

Champ Composants toujours inclus par l'adaptateur LINE Ads Network
Titre
Image
Body
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'icône d'application. Au lieu de cela, l'adaptateur LINE Ads Network remplit l'icône de l'application avec une image transparente.

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir d'annonce de LINE Ads Network, vous pouvez vérifier l'erreur sous-jacente à partir de la réponse de l'annonce à l'aide de GADResponseInfo.adNetworkInfoArray sous les classes suivantes :

GADMediationAdapterLine

Voici les codes et les messages associés renvoyés par l'adaptateur LINE Ads Network lorsqu'une annonce ne parvient pas à se charger :

Code d'erreur Domaine Motif
1-10 Envoyé par le SDK LINE Ads Network Le SDK LINE Ads Network a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez la documentation de LINE Ads Network.
101 com.google.ads.mediation.line Paramètres de serveur non valides (par exemple, ID d'application ou ID d'emplacement manquants).
102 com.google.ads.mediation.line La taille d'annonce demandée ne correspond pas à une taille de bannière acceptée par le Réseau publicitaire 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 LINE pour iOS

Version 2.9.20250825.0 (en cours)

Version 2.9.20250805.0 (en cours)

  • Le SDK FiveAd tente désormais de s'enregistrer avant chaque demande d'annonce.

Version 2.9.20250512.0

  • Nécessite désormais la version 13.0 d'iOS au minimum.
  • Compatibilité vérifiée avec la version 2.9.20250512 du SDK FiveAd.

Conçu et testé avec :

  • SDK Google Mobile Ads version 12.14.0.
  • Version 2.9.20250512 du SDK FiveAd.

Version 2.9.20241106.3

  • Correction d'un problème qui empêchait GADMediationAdapterLine.h d'être un en-tête public.
  • Les options -fobjc-arc et -fstack-protector-all sont activées.
  • Suppression de la vérification de la taille des bannières publicitaires pour les enchères après le chargement réussi.
    • Les bannières en cascade continueront de vérifier les tailles de bannières une fois le chargement réussi.

Conçu et testé avec :

  • SDK Google Mobile Ads version 12.2.0.
  • Version 2.9.20241106 du SDK FiveAd.

Version 2.9.20241106.2

  • Ajout de la propriété GADMediationAdapterLine.testMode pour indiquer si le SDK FiveAd doit être initialisé en mode test. Ce signalement doit être défini avant l'initialisation du SDK Google Mobile Ads.
  • Suppression de la vérification de l'état d'initialisation du SDK FiveAd avant l'initialisation du SDK FiveAd.
  • Suppression de la vérification de l'état des annonces natives obsolète avant le téléchargement des composants d'annonces natives.
  • Nécessite désormais le SDK Google Mobile Ads version 12.0.0 ou ultérieure.

Conçu et testé avec :

  • SDK Google Mobile Ads version 12.0.0.
  • Version 2.9.20241106 du SDK FiveAd.

Version 2.9.20241106.1

  • L'adaptateur a été mis à jour pour utiliser la dernière API de chargement d'annonces pour les bannières d'enchères.
  • Correction d'un problème qui empêchait le transfert correct des événements d'annonces pour les annonces interstitielles avec enchères.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.12.0.
  • Version 2.9.20241106 du SDK FiveAd.

Version 2.9.20241106.0

  • Compatibilité vérifiée avec la version 2.9.20241106 du SDK FiveAd.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.12.0.
  • Version 2.9.20241106 du SDK FiveAd.

Version 2.8.20240827.1

  • Mise à jour de CFBundleShortVersionString pour qu'il comporte trois composants au lieu de quatre.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.10.0.
  • Version 2.8.20240827 du SDK FiveAd.

Version 2.8.20240827.0

  • Compatibilité vérifiée avec la version 2.8.20240827 du SDK FiveAd.
  • Ajout de la prise en charge des enchères pour les formats d'annonces bannière, interstitiel, avec récompense et natif.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.8.0.
  • Version 2.8.20240827 du SDK FiveAd.

Version 2.8.20240612.0

  • Ajout du contrôle audio pour les annonces natives via GADVideoOptions.
  • Compatibilité vérifiée avec la version 2.8.20240612 du SDK FiveAd.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.5.0.
  • Version 2.8.20240612 du SDK FiveAd.

Version 2.7.20240411.0

  • Compatibilité vérifiée avec la version 2.7.20240411 du SDK FiveAd.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.3.0.
  • Version 2.7.20240411 du SDK FiveAd.

Version 2.7.20240318.0

  • Compatibilité vérifiée avec la version 2.7.20240318 du SDK FiveAd.

Conçu et testé avec :

  • SDK Google Mobile Ads version 11.2.0.
  • Version 2.7.20240318 du SDK FiveAd.

Version 2.7.20240214.1

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

Conçu et testé avec :

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

Version 2.7.20240214.0

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

Conçu et testé avec :

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

Version 2.7.20240126.0

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

Conçu et testé avec :

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

Version 2.7.20231115.0

  • Compatibilité vérifiée avec la version 2.7.20231115 du SDK FiveAd.
  • En-tête GADMediationAdapterLineExtras inclus dans le fichier modulemap.

Conçu et testé avec :

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

Version 2.6.20230609.1

  • Ajout de GADMediationAdapterLineAudioState pour gérer l'état audio initial de la bannière, de l'annonce interstitielle et de l'annonce avec récompense lors de leur premier affichage.

Conçu et testé avec :

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

Version 2.6.20230609.0

  • Version initiale
  • Ajout de la prise en charge des cascades pour les formats d'annonces bannière, interstitiel, avec récompense et natif.
  • Compatibilité vérifiée avec la version 2.6.20230609 du SDK FiveAd.

Conçu et testé avec :

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