Intégrer le réseau publicitaire LINE à la médiation (bêta)

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

L'interface du tableau de bord du LINE Ads Network 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 le réseau LINE Ads propose les fonctionnalités suivantes:

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

1L'intégration des enchères est disponible en version bêta fermée. Contactez votre responsable de compte pour en demander l'accès.

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

3 Ce format n'est accepté que dans l'intégration en cascade.

Conditions requises

  • iOS 12.0 ou version ultérieure comme cible de déploiement

  • [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 une version ultérieure (dernière version recommandée).

Étape 1: Configurez les configurations dans l'interface utilisateur du réseau LINE Ads

Connectez-vous à votre compte LINE Ads Network.

Ajouter une application

Cliquez sur 広告枠管理 (Gestion des espaces publicitaires) > メディア (Supports). 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

Suivez la même procédure pour créer des emplacements d'annonces pour les enchères et les intégrations de cascade. Chaque emplacement publicitaire peut être utilisé pour les deux.

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.

Notez l'ID de l'emplacement.

Étape 2: Configurer la demande du réseau LINE Ads dans l'interface utilisateur AdMob

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

Vous devez ajouter LINE Ads Network à 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 Ads Network 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 Ads Network 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 Réseau LINE Ads.

Cliquez sur Signer un contrat partenaire et configurez un partenariat d'enchères avec LINE Ads Network.



Cliquez sur Accepter, puis sur Continuer.



Si vous avez déjà un mappage pour LINE Ads Network, 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.



Cascade


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

Sélectionnez Réseau LINE Ads. Saisissez ensuite une valeur d'eCPM pour le réseau publicitaire LINE, puis cliquez sur Continuer.



Si vous avez déjà un mappage pour le réseau publicitaire LINE, 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.


Étape 3: Importer le SDK et l'adaptateur du réseau publicitaire LINE

Ajoutez la ligne suivante au 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 dans 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, puis 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 AdMob.

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 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:

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

Affichage des annonces

L'adaptateur du réseau LINE Ads insère les descriptions avancées des champs des annonces natives suivantes pour un GADNativeAd.

Champ Éléments toujours inclus par l'adaptateur LINE Ads Network
Titre
Image
Corps
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'asset d'icône d'application. À la place, l'adaptateur LINE Ads Network 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 Ads Network, vous pouvez vérifier l'erreur sous-jacente de la réponse de l'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 du réseau publicitaire LINE lorsqu'une annonce ne parvient pas à se charger:

Code d'erreur Domaine Motif
1-10 Envoyée par le SDK LINE Ads Network Le SDK du réseau publicitaire LINE a renvoyé une erreur spécifique au SDK. Pour en savoir plus, consultez la documentation du réseau publicitaire LINE.
101 com.google.ads.mediation.line Paramètres de serveur non valides (par exemple, ID d'application ou d'emplacement manquants).
102 com.google.ads.mediation.line La taille d'annonce demandée ne correspond pas à une taille d'annonce bannière compatible avec LINE Ads Network.
103 com.google.ads.mediation.line Échec du chargement d'un composant Image d'icône d'information dans une annonce native.

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

Version suivante

  • Correction d'un problème qui empêchait GADMediationAdapterLine.h d'être un en-tête public.

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 flag doit être défini avant d'initialiser le 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 12.0.0 ou version ultérieure.

Compilé et testé avec:

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

Version 2.9.20241106.1

  • Mise à jour de l'adaptateur pour qu'il utilise la dernière API de chargement d'annonces pour les bannières d'enchères.
  • Correction d'un problème qui empêchait la transmission correcte des événements d'annonce pour les annonces interstitielles d'enchères.

Compilé et testé avec:

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

Version 2.9.20241106.0

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

Compilé et testé avec:

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

Version 2.8.20240827.1

  • Modification de CFBundleShortVersionString pour qu'il comporte trois composants au lieu de quatre.

Compilé et testé avec:

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

Version 2.8.20240827.0

  • Compatibilité vérifiée avec le SDK FiveAd version 2.8.20240827.
  • Ajout de la compatibilité avec les enchères pour les formats d'annonces bannière, interstitielle, avec récompense et native.

Compilé et testé avec:

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

Version 2.8.20240612.0

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

Compilé et testé avec:

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

Version 2.7.20240411.0

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

Compilé et testé avec:

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

Version 2.7.20240318.0

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

Compilé et testé avec:

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

Version 2.7.20240214.1

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

Compilé et testé avec:

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

Version 2.7.20240214.0

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

Compilé et testé avec:

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

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.

Compilé et testé avec:

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

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

Compilé et testé avec:

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

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.

Compilé et testé avec:

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

Version 2.6.20230609.0

  • Version initiale
  • Ajout de la compatibilité avec la cascade d'annonces pour les formats d'annonces bannière, interstitielle, avec récompense et native.
  • Compatibilité vérifiée avec la version 2.6.20230609 du SDK FiveAd.

Compilé et testé avec:

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