Intégrer un élément à la médiation (bêta)

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces depuis 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 application iOS.

L'interface du tableau de bord de Line 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 Line présente les fonctionnalités suivantes:

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

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

Conditions requises

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

Étape 1: Configurez les configurations dans l'interface utilisateur de Line

Connectez-vous à votre compte Line.

Ajouter une application

Cliquez sur 広告枠管理 (Gestion des espaces publicitaires) > メディア (Supports). Cliquez ensuite sur 新規作成 (Créer).

Remplissez le formulaire, puis cliquez sur 登録 (Enregistrer).

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. 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 par ligne dans l'interface utilisateur d'Ad Manager

Connectez-vous à votre compte Ad Manager.

Ajouter une ligne dans "Entreprises"

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 Ligne comme réseau publicitaire, saisissez un nom unique et activez la médiation.

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 requise pour les intégrations en cascade.

Configurer les enchères par ligne

Enchères

Accédez à Diffusion > Enchérisseurs, puis cliquez sur Nouvel enchérisseur sous l'onglet Enchères par SDK.

Sélectionnez Ligne comme enchérisseur.

Activez les options Ajouter la bibliothèque de signaux de cet enchérisseur à la liste des signaux autorisés et Autoriser le partage des signaux avec cet enchérisseur. Cliquez ensuite sur Continuer.

Cliquez sur Continuer.

Cliquez sur OK.

Cascade

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

Configurer la mise en correspondance des blocs d'annonces

Enchères

Accédez à Diffusion > Enchérisseurs, puis sélectionnez l'entreprise pour la ligne sous l'onglet Enchères par SDK.

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, puis votre Application mobile. Saisissez ensuite l'ID de l'application et l'ID de l'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 dans la section précédente. Sélectionnez Médiation SDK pour mobile comme Type d'intégration, iOS comme Plate-forme et Actif comme État.

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

Étape 3: Importer le SDK et l'adaptateur 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 et associez FiveAd.framework dans votre projet.
  • Téléchargez la dernière version de l'adaptateur de ligne à l'aide 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 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.

Suivez les instructions de la documentation de Line pour activer les annonces tests Line.

Valider les annonces tests

Pour vérifier que vous recevez des annonces test de Line, 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 (cascade d'annonces).

Étapes facultatives

Paramètres spécifiques au réseau

L'adaptateur Line 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 = 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 de ligne renseigne les champs suivants pour un GADNativeAd.

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 Line 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, 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 Line lorsqu'une annonce ne parvient pas à se charger:

Code d'erreur Domaine Motif
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 (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.
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 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 la version 2.8.20240827 du SDK FiveAd.
  • 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 de la commande 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é vérifié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.