Intégrer une ligne à 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 Unity.

Intégrations et formats d'annonces compatibles

L'adaptateur de médiation Ad Manager pour Line offre les fonctionnalités suivantes:

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

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

Conditions requises

  • Unity 4 ou version ultérieure
  • Dernière version du SDK Google Mobile Ads
  • Pour déployer sur Android
    • Niveau d'API Android 21 ou supérieur
  • Pour déployer sur iOS :
    • iOS 12.0 ou version ultérieure comme cible de déploiement
  • Un projet Unity fonctionnel configuré avec le SDK Google Mobile Ads. Pour en savoir plus, consultez la section Premiers pas.
  • Suivez le guide de démarrage de la médiation.

É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: Configurez la demande de ligne dans l'interface utilisateur de Ad Manager

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

Android

Pour savoir comment procéder, consultez l'étape 2 du guide pour Android.

iOS

Pour savoir comment procéder, consultez l'étape 2 du guide pour iOS.

Étape 3: Importer le SDK et l'adaptateur Line

OpenUPM-CLI

Si OpenUPM-CLI est installé, vous pouvez installer le plug-in de médiation de ligne Google Mobile Ads pour Unity dans votre projet en exécutant la commande suivante à partir du répertoire racine de votre projet:

openupm add com.google.ads.mobile.mediation.line

OpenUPM

Dans l'éditeur de votre projet Unity, sélectionnez Edit (Modifier) > Project Settings (Paramètres du projet) > Package Manager (Gestionnaire de paquets) pour ouvrir les paramètres du Gestionnaire de paquets Unity.

Dans l'onglet Registres à portée limitée, ajoutez OpenUPM en tant que registre à portée limitée avec les informations suivantes:

  • Nom : OpenUPM
  • URL : https://package.openupm.com
  • Champ(s) d'application : com.google

Détails sur OpenUPM

Accédez ensuite à Window > Package Manager (Fenêtre > Gestionnaire de paquets) pour ouvrir le Gestionnaire de paquets Unity, puis sélectionnez My Registries (Mes registres) dans le menu déroulant.

Registres Unity

Sélectionnez le package Google Mobile Ads Line Mediation, puis cliquez sur Install (Installer).

Installer depuis OpenUPM

Package Unity

Téléchargez la dernière version du plug-in de médiation Google Mobile Ads pour Line à partir du lien de téléchargement dans le journal des modifications, puis extrayez le GoogleMobileAdsLineMediation.unitypackage du fichier ZIP.

Dans l'éditeur de votre projet Unity, sélectionnez Assets (Éléments) > Import Package (Importer un package) > Custom Package (Package personnalisé), puis recherchez le fichier GoogleMobileAdsLineMediation.unitypackage que vous avez téléchargé. Vérifiez que tous les fichiers sont sélectionnés, puis cliquez sur Importer.

Importer depuis Unity

Sélectionnez ensuite Assets > External Dependency Manager > Android Resolver > Force Resolve (Composants > Gestionnaire de dépendances externes > Résolveur Android > Forcer la résolution). La bibliothèque External Dependency Manager effectue la résolution des dépendances à partir de zéro et copie les dépendances déclarées dans le répertoire Assets/Plugins/Android de votre application Unity.

Forcer la résolution

Étape 4: Ajoutez le code requis

Android

Aucune ligne de code supplémentaire n'est requise pour l'intégration de Line.

iOS

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

Veillez à enregistrer votre appareil de test pour AdMob.

Suivez les instructions de la documentation Android et iOS 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

Le plug-in de médiation Line Unity est compatible avec le paramètre de requête supplémentaire suivant, qui peut être transmis à l'adaptateur via la classe LineMediationExtras:

  • SetEnableAdSound(boolean): spécifie l'état de démarrage du son par défaut des annonces en bannière, 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:

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir une annonce de Line, les éditeurs peuvent vérifier l'erreur sous-jacente de la réponse de l'annonce à l'aide de ResponseInfo dans les classes suivantes:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

Voici les codes et les messages associés générés par l'adaptateur Line lorsqu'un annonce ne parvient pas à se charger:

Android

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 de créneau manquant ou non valide.
103 com.google.ads.mediation.line La taille d'annonce demandée ne correspond pas à une taille d'annonce bannière compatible avec Line.
104 com.google.ads.mediation.line Échec du chargement d'une annonce interstitielle ou avec récompense en raison de l'absence de contexte d'activité.
105 com.google.ads.mediation.line Le SDK Line n'a pas réussi à afficher une annonce interstitielle ou avec récompense.
106 com.google.ads.mediation.line Échec du chargement d'une annonce native en raison d'éléments manquants.

iOS

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 du plug-in de médiation Unity de la ligne

Version 1.4.0

Version 1.3.1

Version 1.3.0

Version 1.2.0

Version 1.1.2

Version 1.1.1

Version 1.1.0

Version 1.0.0