Intégrer nend à 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 uneiOS 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 AdMob pour nend offre les fonctionnalités suivantes:

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

Conditions requises

  • Cible de déploiement iOS 12.0 ou version ultérieure

É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é.

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.

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.

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 AdMob 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 AdMob l'UI

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

Vous devez ajouter nend à 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 nend 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 nend 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 nend.

Sélectionnez nend et activez le bouton Optimiser. Saisissez l' Reporting API Key from the API Key for Scraping obtenue à la section précédente pour configurer l'optimisation de la source d'annonces pour nend. Ensuite, saisissez une valeur d'eCPM pour nend et cliquez sur Continuer.

Si vous disposez déjà d'un mappage pour nend, vous pouvez le sélectionner. Sinon, cliquez sur Ajouter un mappage.

Saisissez ensuite les Slot ID and API Keyobtenus à la section précédente. Cliquez ensuite sur Done (OK).

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

  • Ajoutez la ligne suivante au Podfile de votre projet:

    pod 'GoogleMobileAdsMediationNend'

  • Dans 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 nend iOS et associez nendSDK.framework à votre projet. Téléchargez la dernière version de l'adaptateur nend via le lien de téléchargement du journal des modifications et associez NendAdapter.framework à votre projet.

Ajoutez les frameworks suivants à votre projet:

  • AdSupport.framework
  • Security.framework
  • ImageIO.framework
  • AVFoundation.framework
  • CoreMedia.framework
  • SystemConfiguration.framework
  • WebKit.framework

De plus, l'ajout des frameworks suivants permet d'utiliser des informations détaillées par diffusion d'annonces.

  • CoreLocation.framework
  • CoreMotion.framework
  • CoreTelephony.framework

Étape 5: Ajoutez le code requis

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

Intégration de SKAdNetwork

Suivez la documentation de nend pour ajouter les identifiants SKAdNetwork au fichier Info.plist de votre projet.

Paramètres du projet

Ajoutez l'indicateur -ObjC aux Other Linker Flags (Autres indicateurs Linker) sous Application Target > Build Settings (Cible de l'application > Paramètres de compilation).

Étape 6: Testez votre implémentation

Activer les annonces tests

Veillez à enregistrer votre appareil de test pour AdMob. 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.

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 GADMAdapterNendExtras. Cette classe comprend les propriétés suivantes:

  • interstitialType: Nend permet de sélectionner soit TypeNormal pour les annonces interstitielles standards, soit TypeVideo pour les annonces vidéo interstitielles. Si ce paramètre supplémentaire n'est pas ajouté, Nend utilise par défaut TypeNormal comme type d'interstitiel.
  • nativeType: Nend permet de sélectionner TypeNormal pour les annonces natives standards ou TypeVideo pour les annonces vidéo natives. Si ce paramètre supplémentaire n'est pas ajouté, Nend utilise par défaut TypeNormal comme type d'annonce native.

Voici des exemples illustrant comment définir ces paramètres de demande d'annonce:

Swift 

let request = GADRequest()
let extras = GADMAdapterNendExtras()
extras.interstitialType = GADMAdapterNendInterstitialType.normal
extras.nativeType = GADMAdapterNendNativeType.normal
request.registerAdNetworkExtras(extras)

Objective-C 

GADRequest *request = [GADRequest request];
GADMAdapterNendExtras *extras = [[GADMAdapterNendExtras alloc] init];
extras.interstitialType = GADMAdapterNendInterstitialTypeNormal;
extras.nativeType = GADMAdapterNendNativeTypeNormal;
[request registerAdNetworkExtras:extras];

Utiliser des annonces natives

Rendu des annonces

L'adaptateur Nend renvoie ses annonces natives sous forme d'objets GADNativeAd . Il renseigne les champs de description des champs d'annonces natives pour un GADNativeAd.

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

1 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).

2 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 GADResponseInfo.adNetworkInfoArray dans les classes suivantes:

Format Nom de la classe
Bannière GADMAdapterNend
Interstitiel GADMAdapterNend
Accordé GADMAdapterNendRewarded
Natif GADMediationAdapterNend

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 AdMob 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 AdMob 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 iOS nend

Version suivante

  • Suppression de la méthode de délégué willBackgroundApplication, obsolète du chargeur d'annonces natives.
  • Nécessite désormais la version minimale d'iOS 12.0.
  • Nécessite désormais le SDK Google Mobile Ads 11.0 ou version ultérieure.
  • Ajout d'Info.plist dans les frameworks de NendAdapter.xcframework.

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 10.11.0.
  • SDK Nend version 8.2.0.

Version 8.1.0.0

  • Suppression de la compatibilité avec l'architecture armv7.
  • Nécessite désormais la version minimale d'iOS 11.0.
  • Nécessite désormais le SDK Google Mobile Ads 10.4.0 ou version ultérieure.

Conçu et testé avec:

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

Version 8.0.1.0

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

Conçu et testé avec:

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

Version 8.0.0.0

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 10.2.0.
  • SDK Nend version 8.0.0.

Version 7.4.0.1

  • Nécessite désormais le SDK Google Mobile Ads 10.0.0 ou version ultérieure.

Conçu et testé avec:

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

Version 7.4.0.0

  • Compatibilité vérifiée avec le SDK nend 7.4.0.
  • Mise à jour de l'adaptateur pour utiliser l'API didRewardUser.
  • Nécessite désormais le SDK Google Mobile Ads 9.8.0 ou version ultérieure.

Conçu et testé avec:

  • SDK Google Mobile Ads version 9.10.0.
  • SDK Nend version 7.4.0.

Version 7.3.0.0

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

Conçu et testé avec:

  • SDK Google Mobile Ads version 9.3.0.
  • SDK Nend version 7.3.0.

Version 7.2.0.0

  • Compatibilité vérifiée avec le SDK nend 7.2.0.
  • Ajout de la prise en charge de l'architecture du simulateur arm64.

Conçu et testé avec:

  • SDK Google Mobile Ads version 9.1.0.
  • SDK Nend version 7.2.0.

Version 7.1.0.1

  • Compatibilité validée avec la version 9.0.0 du SDK Google Mobile Ads.
  • Nécessite désormais le SDK Google Mobile Ads 9.0.0 ou version ultérieure.

Conçu et testé avec:

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

Version 7.1.0.0

  • Compatibilité vérifiée avec le SDK nend 7.1.0.
  • Nécessite désormais la version minimale d'iOS 10.0.

Conçu et testé avec

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

Version 7.0.6.1

  • Correction d'un problème qui empêchait le transfert du rappel adDidRecordClick pour les annonces interstitielles.

Conçu et testé avec

  • SDK Google Mobile Ads version 8.9.0.
  • SDK Nend version 7.0.6.

Version 7.0.6.0

  • Compatibilité vérifiée avec le SDK nend 7.0.6.
  • Ajout de codes et de messages d'erreur standardisés pour les adaptateurs.

Conçu et testé avec

  • SDK Google Mobile Ads version 8.8.0.
  • SDK Nend version 7.0.6.

Version 7.0.5.0

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

Conçu et testé avec

  • SDK Google Mobile Ads version 8.5.0.
  • SDK Nend version 7.0.5.

Version 7.0.4.0

  • Compatibilité vérifiée avec le SDK nend 7.0.4.
  • Dépendance flexible à la version 8.0.0 ou ultérieure du SDK Google Mobile Ads.
  • Mise à jour de l'adaptateur pour utiliser le format .xcframework.

Conçu et testé avec

  • SDK Google Mobile Ads version 8.5.0.
  • SDK Nend version 7.0.4.

Version 7.0.2.0

  • Compatibilité vérifiée avec le SDK nend 7.0.2.
  • Correction d'un problème qui entraînait parfois l'affichage incorrect de la vue multimédia.

Conçu et testé avec

  • SDK Google Mobile Ads version 7.69.0.
  • SDK Nend version 7.0.2.

Version 7.0.1.0

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

Conçu et testé avec

  • SDK Google Mobile Ads version 7.69.0.
  • SDK Nend version 7.0.1.

Version 7.0.0.0

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

Conçu et testé avec

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

Version 6.0.3.0

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

Conçu et testé avec

  • SDK Google Mobile Ads version 7.65.0.
  • SDK Nend version 6.0.3.

Version 6.0.2.0

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

Conçu et testé avec

  • SDK Google Mobile Ads version 7.64.0.
  • SDK Nend version 6.0.2.

Version 6.0.1.0

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

Conçu et testé avec

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

Version 6.0.0.0

  • Compatibilité vérifiée avec le SDK nend 6.0.0.
  • Suppression de la classe GADNendRewardedNetworkExtras. Si vous souhaitez transmettre des extras réseau à l'adaptateur iOS nend, utilisez la classe GADMAdapterNendExtras.
  • Renommage des énumérations suivantes à partir de la classe GADMAdapterNendExtras :
    • Remplacement de GADMNendInterstitialType par GADMAdapterNendInterstitialType.
    • Remplacement de GADMNendNativeType par GADMAdapterNendNativeType.
  • Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 7.62.0.

Conçu et testé avec

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

Version 5.4.1.0

  • Compatibilité vérifiée avec le SDK nend 5.4.1.
  • Ajout de la compatibilité avec les annonces natives.
  • Suppression de la compatibilité avec l'architecture i386.

Conçu et testé avec

  • SDK Google Mobile Ads version 7.58.0.
  • SDK Nend version 5.4.1.

Version 5.3.1.0

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

Compiler et tester avec

  • SDK Google Mobile Ads version 7.52.0.
  • SDK Nend version 5.3.1.

Version 5.3.0.0

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

Conçu et testé avec:

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

Version 5.1.1.0

  • Mise à jour de l'adaptateur pour utiliser la nouvelle API avec récompense.
  • Nécessite désormais le SDK Google Mobile Ads 7.42.2 ou version ultérieure.
  • Compatibilité vérifiée avec le SDK nend 5.1.1.
  • Modification de la condition liée à la vérification de la taille de la bannière. Taille appropriée pour les bannières intelligentes
    • kGADAdSizeSmartBannerPortrait
      • iPhone: 320×50
      • iPad: 728 × 90 ou 320 × 50
    • kGADAdSizeSmartBannerLandscape
      • iPad: 728 × 90 ou 320 × 50
  • Les tailles de bannière flexibles sont désormais acceptées.

Version 5.1.0.0

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

Version 5.0.3.0

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

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.6.0

  • Compatibilité vérifiée avec le SDK nend 4.0.6.
  • Supprimez pour définir la propriété userFeature.

Version 4.0.5.0

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

Version 4.0.4.0

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

Version 4.0.3.0

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

Version 4.0.2.0

  • Première version du projet Open Source de médiation Google Mobile Ads.
  • Ajout de la compatibilité avec les annonces vidéo avec récompense.

Versions précédentes

  • Il est compatible avec les bannières et les annonces interstitielles.