Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher annonces provenant de Line avec Médiation AdMob, sur les intégrations de cascades d'annonces. Elle explique comment ajouter des éléments à la campagne configuration de médiation, et comment intégrer le SDK Line et l'adaptateur dans une iOS application.
L'interface du tableau de bord pour Line utilise du texte en japonais pour ses étiquettes, des boutons et des descriptions. Les captures d'écran de ce guide n'ont pas été traduit. Toutefois, dans les descriptions et les instructions de ce guide, sont traduits et leur équivalent en anglais est indiqué entre parenthèses.
Intégrations et formats d'annonces compatibles
L'adaptateur de médiation pour Line offre les fonctionnalités suivantes:
Intégration | |
---|---|
Enchères | |
Cascade | 1 |
Formats | |
Bannière | |
Interstitiel | |
Avec récompense | |
Natif |
1. L'intégration de Waterfall est en bêta ouverte.
Conditions requises
- Cible de déploiement iOS 12.0 ou version ultérieure
Le dernier SDK Google Mobile Ads
Finaliser la médiation Guide de démarrage
Étape 1: Définir les configurations dans l'interface utilisateur de ligne
Étape 2: Configurez la demande de campagne AdMob dans l'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.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).
É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 de la Line
SDK et le lien
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
Journal des modifications et
associer
LineAdapter.framework
dans 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 AdMob.
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
. Ce cours
inclut 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 = 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 éléments suivants :
Description des champs (avancés) des annonces natives
pendant
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 de ligne insère 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 de la réponse d'annonce
GADResponseInfo.adNetworkInfoArray
dans les classes suivantes:
GADMediationAdapterLine
Voici les codes et les messages associés générés par l'adaptateur de ligne lorsque l'annonce ne se charge pas:
Code d'erreur | Domaine | Motif |
---|---|---|
1-10 | Envoyé par le SDK Line | Le SDK Line a renvoyé une erreur spécifique au SDK. Voir Documentation de Line pour en savoir plus. |
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 2.8.20240612.0
- Ajout d'une commande audio pour l'annonce native via GADVideoOptions.
- La compatibilité avec la version 2.8.20240612 du SDK FiveAd a été vérifiée.
Conçu et testé avec:
- SDK Google Mobile Ads version 11.5.0
- SDK FiveAd version 2.8.20240612.
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.plist
aux 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
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 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.