Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces à partir de 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 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 et leur équivalent en anglais est indiqué entre parenthèses.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation Ad Manager pour la ligne offre les fonctionnalités suivantes:
| Intégration | |
|---|---|
| Enchères | |
| Cascade | 1 |
| Formats | |
| Bannière | |
| Interstitiel | |
| Accordé | |
| Il s'agit de ma langue maternelle | |
1 L'intégration de Waterfall est 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
Le dernier SDK Google Mobile Ads
Suivez la procédure de médiation. Guide de démarrage
Étape 1: Définir les configurations dans l'interface utilisateur 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.
Notez l'ID de l'emplacement.
Étape 2: Configurez la demande de campagne Ad Manager dans l'UI
Configurer les paramètres de médiation pour votre bloc d'annonces
Connectez-vous à votre compte Ad Manager.
Accédez à Diffusion > Groupes de rendement, puis cliquez sur le bouton Nouveau groupe de rendement.
Attribuez un nom unique à votre groupe de rendement, définissez l'état sur Actif, puis le format d'annonce et le type d'inventaire sur Application mobile. Dans la section Ciblage > Inventaire, sélectionnez le bloc d'annonces auquel vous souhaitez ajouter une médiation sous Inventaire et Application mobile.
Cliquez ensuite sur le bouton Ajouter un partenaire de rendement.
Si vous disposez déjà d'un partenaire de rendement pourLine, vous pouvez le sélectionner. Sinon, sélectionnez Créer un partenaire de rendement.
Sélectionnez Line en tant que réseau publicitaire, saisissez un nom unique et activez la médiation.
Une fois que vous avez sélectionné Partenaire de rendement, sélectionnez Médiation SDK pour mobile comme type d'intégration, iOS comme Plate-forme et Actif comme État. Saisissez leApplication ID and Slot ID obtenu dans la section précédente. Saisissez ensuite une valeur dans le champ CPM par défaut.
Lorsque vous avez terminé, cliquez sur Enregistrer en bas de la page.
Étape 3: Importez le SDK Line et l'adaptateur
Utiliser CocoaPods (recommandé)
Ajoutez la ligne suivante au Podfile de votre projet:
pod 'GoogleMobileAdsMediationLine'
Depuis 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.frameworkdans 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, puis associez
LineAdapter.frameworkdans votre projet.
Étape 4: Ajoutez le code requis
Intégration 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 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 GADMediationAdapterLineExtras. Cette classe comprend les propriétés suivantes:
adAudio- Spécifie l'état de début du son par défaut des bannières, des interstitiels 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
Rendu des annonces
L'adaptateur de ligne renseigne les
champs
pour un
GADNativeAd
| Champ | Éléments toujours inclus par l'adaptateur de ligne |
|---|---|
| Titre principal | |
| Image | |
| Corps | |
| Icône de l'appli | 1 |
| Incitation à l'action | |
| Star rating [Note] | |
| Boutique | |
| Prix |
1 Pour les annonces natives, le SDK Line ne fournit pas d'élément d'icône d'application. Au lieu de cela, l'adaptateur Line remplit l'icône de 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 dans 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 en cas d'échec du chargement d'une annonce:
| 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 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 d'interstitiel ou d'annonce avec récompense. |
| 106 | com.google.ads.mediation.line | Échec du chargement d'une annonce native en raison d'éléments manquants. |
| 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 (ID d'application ou ID d'emplacement manquant, par exemple). |
| 102 | com.google.ads.mediation.line | La taille d'annonce demandée ne correspond pas à une taille de bannière compatible avec 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 iOS LINE
Version suivante
- Ajout d'une commande audio pour l'annonce native via GADVideoOptions.
Version 2.7.20240411.0
- La compatibilité avec la version 2.7.20240411 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 11.3.0
- SDK FiveAd version 2.7.20240411.
Version 2.7.20240318.0
- La compatibilité avec la version 2.7.20240318 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 11.2.0.
- SDK FiveAd version 2.7.20240318.
Version 2.7.20240214.1
- Nécessite la version minimale d'iOS 12.0.
- Nécessite la version 11.0 ou ultérieure du SDK Google Mobile Ads.
- Ajout de
Info.plistaux frameworks dansLineAdapter.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
- La compatibilité avec la version 2.7.20240214 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 11.0.1
- SDK FiveAd version 2.7.20240214.
Version 2.7.20240126.0
- La compatibilité avec la version 2.7.20240126 du SDK FiveAd a été vérifiée.
- 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
- La compatibilité avec la version 2.7.20231115 du SDK FiveAd a été vérifiée.
- Inclusion de l'en-tête
GADMediationAdapterLineExtrasdans 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
GADMediationAdapterLineAudioStatepour gérer l'état audio initial de la bannière, de l'interstitiel et de l'annonce avec récompense lors de son premier affichage.
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 prise en charge de la cascade d'annonces pour les formats d'annonces natives, bannières, interstitiels et annonces avec récompense.
- La compatibilité avec la version 2.6.20230609 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 10.9.0.
- SDK FiveAd version 2.6.20230609.