Intégrer nend avec la médiation

Ce guide explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces à partir de nend à l'aide de la médiation, qui couvre les intégrations en cascade. Il explique comment ajouter nend à la configuration de médiation d'un bloc d'annonces, et comment intégrer le SDK nend et l'adaptateur dans uneAndroid application.

Les libellés, boutons et descriptions de l'interface du tableau de bord nend sont en japonais, et les captures d'écran affichées ci-dessous n'ont pas été traduites. Dans ce guide, les libellés et les boutons sont désignés par leur équivalent en anglais. Par exemple, "URL ムム saison lit ーム!" est "schéma d'URL", etc.

Intégrations et formats d'annonces compatibles

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

Intégration
Enchères
Cascade
Formats
Bannière
Interstitiel
Accordé
Natif

Conditions requises

• Niveau d'API Android 19 ou supérieur

• Dernier SDK Google Mobile Ads

• Suivez le guide de démarrage sur la médiation.

Étape 1: Définissez les configurations dans nend UI

Inscrivez-vous ou connectez-vous à votre compte Nend.

Pour ajouter votre application au tableau de bord nend, cliquez d'abord sur l'onglet Placement Management (Gestion des emplacements), puis sélectionnez Site/App (Site/Application). Cliquez sur le bouton Add an app (Ajouter une application) pour ajouter votre application à nend.

Créer une application

Saisissez le nom de votre application et choisissez votre plate-forme d'applications comme type d'application. Saisissez l'URL et vérifiez si votre application est répertoriée sur la plate-forme de téléchargement appropriée.

(consultez les questions fréquentes sur les applications non publiées si votre application n'a pas encore été publiée). Sélectionnez une catégorie pour votre application, puis cliquez sur Créer lorsque vous avez terminé.

Votre application s'affichera dans le tableau de bord une fois créée.

Créer un emplacement

Une fois l'application enregistrée, vous pouvez créer un emplacement. Pour créer un emplacement pour des bannières, accédez à l'onglet Gestion des emplacements, puis cliquez sur Emplacement. Cliquez ensuite sur le bouton Créer un emplacement.

Sélectionnez votre application dans le menu déroulant. Suivez ensuite les instructions ci-dessous correspondant à votre format d'annonce préféré.

Bannière

Sélectionnez Image fixe pour le Type d'annonce et Bannière pour le Type d'inventaire. Ensuite, saisissez le nom de l'emplacement, remplissez les champs Introduction à l'inventaire, choisissez un format d'inventaire, puis sélectionnez une taille d'inventaire. Lorsque vous avez terminé, cliquez sur le bouton Créer pour créer votre emplacement.

Remarque :La taille de bannière choisie ici doit correspondre à la taille demandée par votre application.

Interstitiel

Sélectionnez Image fixe pour le Type d'annonce et Interstitiel pour le Type d'inventaire. Ensuite, saisissez le nom de l'emplacement, remplissez le champ Introduction à l'inventaire, puis sélectionnez une fréquence d'affichage des annonces dans la liste déroulante. Lorsque vous avez terminé, cliquez sur le bouton Créer pour créer votre emplacement.

Pour les annonces vidéo interstitielles, sélectionnez Vidéo pour le Type d'annonce et Interstitiel pour le Type d'inventaire. Ensuite, saisissez un nom d'emplacement, remplissez le champ Introduction à l'inventaire, puis sélectionnez la catégorie appropriée dans la liste déroulante. Lorsque vous avez terminé, cliquez sur le bouton Créer pour créer votre emplacement.

Accordé

Sélectionnez Vidéo pour le type d'annonce et Récompense pour le type d'inventaire. Ensuite, saisissez un nom d'emplacement, remplissez le champ Introduction à l'inventaire, puis sélectionnez une catégorie appropriée dans la liste déroulante.

Sous Paramètres relatifs aux récompenses, sélectionnez un Contenu relatif aux récompenses dans la liste déroulante, puis saisissez le nom de la devise virtuelle de votre choix. Lorsque vous avez terminé, cliquez sur le bouton Créer pour créer votre emplacement.

Natif

Sélectionnez Image fixe pour le Type d'annonce et Native pour le Type d'inventaire. Ensuite, indiquez le nom de l'emplacement, remplissez les champs de la page Introduction à l'inventaire, puis sélectionnez une sélection d'image pour l'annonce. Lorsque vous avez terminé, cliquez sur le bouton Créer pour créer votre emplacement.

Remarque :Nous vous recommandons d'utiliser la grande image publicitaire horizontale (5: 3) comme sélection d'images de l'annonce, car elle inclut les composants d'annonce native dont l'affichage est recommandé.

Pour les annonces vidéo natives, sélectionnez Vidéo pour le type d'annonce et Native (personnalisé) pour le type d'inventaire. Ensuite, saisissez un nom d'emplacement, remplissez le champ Introduction à l'inventaire, puis sélectionnez la catégorie appropriée dans la liste déroulante.

Sous Paramètres natifs, sélectionnez une orientation de l'annonce vidéo et un type d'annonce native dans la liste. Lorsque vous avez terminé, cliquez sur le bouton Créer pour créer votre emplacement.

Pour configurer votre bloc d'annonces Ad Manager dans la section suivante, vous aurez besoin de l'apiKey et du spotID pour chaque emplacement. Pour les trouver, accédez à l'onglet Gestion des emplacements et sélectionnez le bouton SDK sous le nom de votre application.

Notez les valeurs apiKey et spotID.

Vous aurez également besoin de votre clé API pour l'API Reporting de Google Cloud, appelée clé API pour la copie de données. Vous le trouverez dans l'onglet Outils.

Étape 2: Configurer la demande dans Ad Manager 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 pournend, vous pouvez le sélectionner. Sinon, sélectionnez Créer un partenaire de rendement.

Sélectionnez nend en tant que réseau publicitaire, saisissez un nom unique et activez la médiation.

Activez la collecte des données automatique et saisissez leReporting API Key from the API Key for Scrapingobtenu à la section précédente.

Une fois que vous avez sélectionné Partenaire de rendement, sélectionnez Médiation SDK pour mobile comme type d'intégration, Android comme Plate-forme et Actif comme État. Saisissez leSlot ID and API Key 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.

Remarque :La collecte automatique des données prend quelques jours avant de pouvoir calculer avec précision une valeur de CPM dynamique pour un réseau de médiation. Une fois l'eCPM calculé, il sera automatiquement mis à jour en votre nom.

Étape 3: Importez le SDK nend et l'adaptateur

Remarque :Si vous n'intégrez pas les versions compatibles du SDK Google Mobile Ads et Nend, vous risquez de rencontrer des problèmes de compilation.

Intégration d'Android Studio (recommandé)

Dans le fichier settings.gradle.kts au niveau du projet, ajoutez les dépôts suivants:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
    }
  }
}

Ensuite, dans le fichier build.gradle.kts au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes. Utilisez les dernières versions du SDK nend et de l'adaptateur:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.0")
}

Intégration manuelle

1. Téléchargez la dernière version du SDK nend Android et ajoutez-la à votre projet.

2. Accédez aux artefacts d'adaptateur nend dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier .aar de l'adaptateur nend et ajoutez-le à votre projet.

Étape 5: Ajoutez le code requis

Aucun code supplémentaire n'est requis pour l'intégration nend.

Étape 6: Testez votre implémentation

Activer les annonces tests

Veillez à enregistrer votre appareil de test pour Ad Manager. Pour tester les bannières, les interstitiels et les annonces avec récompense, nend vous recommande d'utiliser les clés API et les ID Spot fournis sur la page nend test ad blocs . Vous pouvez les saisir en tant que clés API et ID Spot pour vos blocs d'annonces AdMob lors des tests, puis les remplacer par une clé API et un ID Spot lorsque votre application est prête pour la production.

Important :Désactivez le mode test pour Ad Manager etnend avant de publier votre application.

Valider les annonces tests

Pour vérifier que vous recevez des annonces tests denend, activez le test d'une source d'annonce unique dans l'inspecteur d'annonces à l'aide de nend (Waterfall) sources d'annonces.

Étapes facultatives

Paramètres réseau

L'adaptateur nend accepte des paramètres de requête supplémentaires, qui peuvent lui être transmis à l'aide de la classe NendExtrasBundleBuilder. Cette classe comprend les méthodes suivantes:

• setInterstitialType(InterstitialType): Nend permet de sélectionner TYPE_NORMAL pour les annonces interstitielles standards ou TYPE_VIDEO pour les annonces vidéo interstitielles. Si ce paramètre supplémentaire n'est pas ajouté, Nend utilise par défaut TYPE_NORMAL comme type d'interstitiel.

• setNativeAdsType(nativeAdsType): Nend permet de sélectionner TYPE_NORMAL pour les annonces natives standards ou TYPE_VIDEO pour les annonces vidéo natives. Si ce paramètre supplémentaire n'est pas ajouté, Nend utilise par défaut TYPE_NORMAL comme type d'annonce native.

Java

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build();

adLoader.loadAd(adRequest);

Kotlin

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build()

adLoader.loadAd(adRequest)

Utiliser des annonces natives

Rendu des annonces

L'adaptateur Nend renvoie ses annonces natives sous forme d'objets NativeAd . Il renseigne les pour un NativeAd.

Champ	Segment rempli par l'adaptateur Nend
Titre
Images	1
Corps
Icône de l'application	2
Incitation à l'action
Nom de l'annonceur
Star rating [Note]
Stocker
Prix

¹ Nend fournit uniquement un composant Image pour les emplacements natifs configurés avec une sélection d'image d'annonce définie sur Grande image publicitaire horizontale (5: 3).

² Nend ne fournit pas d'élément "Icône" pour les emplacements natifs configurés avec une sélection d'image de l'annonce définie sur Aucune image (texte uniquement).

Codes d'erreur

Si l'adaptateur ne reçoit pas d'annonce de nend, les éditeurs peuvent vérifier l'erreur sous-jacente dans la réponse d'annonce à l'aide de ResponseInfo.getAdapterResponse() sous les classes suivantes:

Format	Nom de la classe
Bannière	com.google.ads.mediation.nend.NendAdapter
Interstitiel	com.google.ads.mediation.nend.NendAdapter
Accordé	com.google.ads.mediation.nend.NendRewardedAdapter
Natif	com.google.ads.mediation.nend.NendMediationAdapter

Voici les codes et les messages associés générés par l'adaptateur nend en cas d'échec du chargement d'une annonce:

Code d'erreur	Domaine	Motif
101	com.google.ads.mediation.nend	nend a besoin d'un contexte d'activité pour charger et diffuser des annonces.
102	com.google.ads.mediation.nend	Les paramètres du serveur nend configurés dans Ad Manager l'interface utilisateur sont manquants/non valides.
103	com.google.ads.mediation.nend	L'annonce nend n'est pas encore prête à être diffusée.
104	com.google.ads.mediation.nend	nend n'a pas pu lire l'annonce.
105	com.google.ads.mediation.nend	La taille d'annonce demandée ne correspond à aucune taille de bannière prise en charge.
106	com.google.ads.mediation.nend	La référence d'objet de contexte est null et/ou a été récemment libérée de la mémoire.
200-299	net.nend.android	Le SDK nend a renvoyé une erreur de chargement d'annonce interstitielle. Pour plus d'informations, reportez-vous à la section sur le code.
300-399	net.nend.android	Le SDK nend a renvoyé une erreur d'annonce interstitielle. Pour plus d'informations, reportez-vous à la section sur le code.
400-499	net.nend.android	Le SDK nend a renvoyé une erreur d'annonce. Pour plus d'informations, reportez-vous à la section sur le code.
101	com.google.mediation.nend	Le SDK nend a renvoyé un rappel d'échec de chargement sans informations supplémentaires sur l'erreur.
102	com.google.mediation.nend	Le SDK nend a renvoyé un rappel d'échec d'affichage sans informations supplémentaires sur l'erreur.
103	com.google.mediation.nend	Les paramètres du serveur nend configurés dans Ad Manager l'interface utilisateur sont manquants/non valides.
104	com.google.mediation.nend	Échec du chargement des composants Image des annonces natives.
105	com.google.mediation.nend	Échec de l'affichage des annonces nend, car l'annonce n'est pas prête.
106	com.google.mediation.nend	La taille de bannière demandée ne correspond pas à une taille de bannière prise en charge.
200-699	Envoyé par le SDK nend.	Le SDK nend a renvoyé une erreur. Pour en savoir plus, consultez le document de nend.

Journal des modifications de l'adaptateur de médiation Android nend

Version 10.0.0.0

• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.3.0.
• Compatibilité vérifiée avec le SDK nend 10.0.0.

Conçu et testé avec

• SDK Google Mobile Ads version 22.3.0.
• SDK Nend version 10.0.0.

Version 9.0.1.0

• Mise à jour de l'adaptateur pour utiliser la nouvelle classe VersionInfo.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.0.0.
• Compatibilité vérifiée avec le SDK nend 9.0.1.

Conçu et testé avec

• SDK Google Mobile Ads version 22.0.0.
• SDK Nend version 9.0.1.

Version 9.0.0.0

• Compatibilité vérifiée avec le SDK nend 9.0.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 21.2.0.

Conçu et testé avec

• SDK Google Mobile Ads version 21.2.0.
• SDK Nend version 9.0.0.

Version 8.2.0.0

• Compatibilité vérifiée avec le SDK nend 8.2.0.

Conçu et testé avec

• SDK Google Mobile Ads version 21.0.0.
• SDK Nend version 8.2.0.

Version 8.1.0.1

• Mise à jour de compileSdkVersion et targetSdkVersion vers l'API 31.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 21.0.0.

Conçu et testé avec

• SDK Google Mobile Ads version 21.0.0.
• SDK Nend version 8.1.0.

Version 8.1.0.0

• Compatibilité vérifiée avec le SDK nend 8.1.0.
• Correction d'un plantage de NullPointerException lorsque nend renvoyait une URL de logo ou d'image d'annonce null
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.5.0.

Conçu et testé avec

• SDK Google Mobile Ads version 20.5.0.
• SDK Nend version 8.1.0.

Version 8.0.1.0

• Compatibilité vérifiée avec le SDK nend 8.0.1.
• Correction d'un bug qui provoquait le renvoi de certains objets AdError avec le domaine incorrect.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.4.0.

Conçu et testé avec

• SDK Google Mobile Ads version 20.4.0.
• SDK Nend version 8.0.1.

Version 7.1.0.0

• Compatibilité vérifiée avec le SDK nend 7.1.0.
• Mise à jour des codes d'erreur pour capturer l'erreur UNSUPPORTED_DEVICE nend.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.2.0.

Conçu et testé avec

• SDK Google Mobile Ads version 20.2.0.
• SDK Nend version 7.1.0.

Version 7.0.3.0

• Compatibilité vérifiée avec le SDK nend 7.0.3.
• Ajout de codes d'erreur descriptifs et des raisons des échecs de chargement/d'affichage de l'adaptateur.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.0.0.

Conçu et testé avec

• SDK Google Mobile Ads version 20.0.0.
• SDK Nend version 7.0.3.

Version 7.0.0.0

• Compatibilité vérifiée avec le SDK nend 7.0.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.4.0.

Conçu et testé avec

• SDK Google Mobile Ads version 19.4.0.
• SDK Nend version 7.0.0.

Version 6.0.1.0

• Compatibilité vérifiée avec le SDK nend 6.0.1.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.3.0.

Conçu et testé avec

• SDK Google Mobile Ads version 19.3.0.
• SDK Nend version 6.0.1.

Version 6.0.0.0

• Compatibilité vérifiée avec le SDK nend 6.0.0.
• Mise à jour de la version minimale du SDK Android vers l'API 19.

Conçu et testé avec

• SDK Google Mobile Ads version 19.2.0.
• SDK Nend version 6.0.0.

Version 5.4.2.1

• Mise à jour de l'adaptateur pour accepter les requêtes de bannières adaptatives intégrées.
• Correction d'un plantage rare qui pouvait se produire lorsque les bannières intelligentes étaient détruites.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.2.0.

Conçu et testé avec

• SDK Google Mobile Ads version 19.2.0.
• SDK Nend version 5.4.2.

Version 5.4.2.0

• Ajout de la compatibilité avec les annonces natives.
• Compatibilité vérifiée avec le SDK nend 5.4.2.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.0.0.

Conçu et testé avec

• SDK Google Mobile Ads version 19.0.0.
• SDK Nend version 5.4.2.

Version 5.3.0.0

• Compatibilité vérifiée avec le SDK nend 5.3.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.2.0.

Conçu et testé avec

• SDK Google Mobile Ads version 18.2.0.
• SDK Nend version 5.3.0.

Version 5.2.0.0

• Compatibilité vérifiée avec le SDK nend 5.2.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.1.1.

Version 5.1.0.4

• Les bannières et les annonces interstitielles ne transféraient pas l'événement onAdClicked(). Ce problème a été résolu.
• Correction d'un problème qui entraînait une exception NullPointerException lorsqu'une bannière nend était détruite.
• Migration de l'adaptateur vers AndroidX.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.0.0.

Version 5.1.0.3

• Ajout d'une implémentation pour afficher une partie de la bannière nend dans SmartBanner. Taille appropriée pour les bannières intelligentes
  • Portrait et Paysage
    • Téléphones: 320 × 50
    • Tablettes: 728 × 90 ou 320 × 50

Version 5.1.0.2

• Les tailles de bannière flexibles sont désormais acceptées.

Version 5.1.0.1

• Mise à jour de l'adaptateur pour assurer la compatibilité avec la nouvelle API Récompense en version bêta ouverte.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 17.2.0.

Version 5.1.0.0

• Compatibilité vérifiée avec le SDK nend 5.1.0.

Version 5.0.2.1

• Suppression de la fonction qui transfère les fonctionnalités utilisateur, car les méthodes suivantes sont obsolètes sur AdRequest.Builder.
  • setGender()
  • setBirthday()
  • setIsDesignedForFamiles()

Version 5.0.2.0

• Compatibilité vérifiée avec le SDK nend 5.0.2.

Version 5.0.1.0

• Compatibilité vérifiée avec le SDK nend 5.0.1.

Version 5.0.0.0

• Compatibilité vérifiée avec le SDK nend 5.0.0.

Version 4.0.5.0

• Compatibilité vérifiée avec le SDK nend 4.0.5.

Version 4.0.4.1

• Prise en charge de la méthode onRécompenseVideoCompleted() de RewardVideoAdListener.

Version 4.0.4.0

• Compatibilité vérifiée avec le SDK nend 4.0.4.

Version 4.0.2.1

• Ajout de la possibilité de créer un Bundle d'éléments supplémentaires de médiation à l'aide de la classe NendExtrasBundleBuilder.

Version 4.0.2.0

• Première version dans le projet Open Source de médiation Google Mobile Ads.
• Les bannières, les interstitiels et les annonces vidéo avec récompense sont désormais acceptés.