Quel est le format correct pour les fichiers CSV de métadonnées Stacks NFT ?

Si vous déployez une collection en utilisant notre no-code launchpad pour les NFT Bitcoin, vous aurez l'option de créer et télécharger un CSV contenant des métadonnées personnalisées. Bien que cela soit optionnel, cela peut aider votre collection à se distinguer des autres, et fournir des avantages supplémentaires par rapport aux collections qui n'en ont pas. Nous vous expliquerons exactement comment formater votre fichier afin que vous puissiez facilement l'ajouter à votre collection si vous le désirez.

Nombre d'applications vous permettent de créer un fichier CSV, mais les plus communes sont Microsoft Excel ou Google Sheets. Vous pourrez exporter vos fichiers au format CSV au moment du téléchargement.

Fichier CSV de métadonnées NFT

Le fichier CSV des métadonnées NFT est entièrement dépendant des exigences spécifiques de votre collection, il n'y a pas qu'une seule bonne méthode d'insérer des valeurs. Ceci étant dit, il y a un format requis pour que le système puisse lire et interpréter correctement vos métadonnées, de la manière attendue. Cela peut être un peu déroutant pour les créateurs moins expérimentés sur le plan technique, mais c'est vraiment très simple une fois que vous avez compris les principes de base. Nous avons préparé un guide visuel pour expliquer plus simplement la manière dont il vous faudra remplir et formater votre fichier.

______________________

Pourquoi inclure les métadonnées ?

Les métadonnées NFT peuvent prendre du temps et des efforts pour créer, donc il est important de comprendre pourquoi cet investissement de temps peut être utile pour votre collection. Imaginons que vous ayez une collection NFT simple, composée d'une série de formes, chacune avec des couleurs et des attributs différents. L'observation visuelle du NFT peut vous donner toutes les informations dont vous avez besoin pour comprendre ce qui est représenté. Mais l'ajout de caractéristiques descriptives peut contribuer à valoriser votre collection de plusieurs façons.

• L'ajout de métadonnées écrites améliore l'accessibilité de votre collection et décrit ce que contiennent les images.
• Les métadonnées sont le mécanisme par lequel la rareté peut être déterminée, puisque les places de marché peuvent lire la fréquence d'un trait donné et calculer la fréquence ou la rareté de l'ensemble des traits d'un NFT. Après avoir effectué ce calcul, le système peut classer définitivement les NFT d'une collection du plus au moins rare.
• Les métadonnées permettent aux utilisateurs de filtrer et de trier des attributs spécifiques sans avoir à parcourir toute la collection. Cette fonction est particulièrement utile si votre collection est vaste et qu'il serait autrement difficile de retrouver un attribut spécifique en n'utilisant que des éléments visuels.
• Certains attributs ont des qualités ou une utilité qui ne sont pas visibles sur l'image NFT. Peut-être décrivez-vous un son, ou peut-être décrivez-vous une utilité ou un avantage caché d'un NFT par rapport à un autre. Par exemple, vos NFT les plus spéciaux peuvent avoir un attribut qui est ensuite vérifié sur le site web de votre collection. Si l'attribut existe, il peut permettre l'accès à une partie exclusive du site web. Les possibilités sont infinies si vous disposez des ressources de développement pour mettre en œuvre votre concept.

______________________

Résumé du formatage CSV des métadonnées

Vous trouverez ci-dessous un résumé de l'exemple de tutoriel présenté ci-dessous. Si vous suivez ces étapes, préparer les métadonnées de votre collection n'aura pas été une perte de temps.

• Votre fichier doit être enregistré et téléchargé au format CSV.
• La première ligne de votre fichier doit représenter les noms des attributs. Par exemple, la ligne 1 peut inclure "Couleur d'arrière-plan" et chaque ligne suivante peut inclure "Rouge" et "Bleu" en fonction de la couleur de l'arrière-plan du NFT.
• Chaque ligne suivant l'en-tête, la ligne 2 et au-delà, correspondra séquentiellement à chaque ID de token NFT dans votre collection. En d'autres termes, la ligne 2 sera associée au token 1, la ligne 3 sera associée au token 2, et ainsi de suite.
• Il n'est pas nécessaire, et généralement pas recommandé, d'inclure une colonne pour l'ID de token. Ces derniers sont générés automatiquement si vous n'avez pas activé les noms de fichiers pour vos NFT.
• Vous ne devez avoir qu'une seule ligne par token. Si l'attribut en question n'est pas applicable à un NFT donné, vous pouvez laisser la case vide ou définir une valeur constante pour l'absence de cet attribut.
• Il ne doit pas y avoir de lignes vides à la fin de votre fichier. Toutes les lignes en dessous de la dernière doivent être supprimées avant d'exporter le fichier au format CSV.

Bien qu'il ne s'agisse pas d'une exigence spécifique, il n'est pas recommandé d'inclure de longues descriptions dans vos métadonnées NFT. Visuellement, ces caractéristiques seront difficiles à filtrer et trier et pourraient limiter l'application pratique de cet attribut.

______________________

Exemple de métadonnées d'une collection

En utilisant l'exemple ci-dessus, nous avons esquissé un guide visuel sur la façon de créer un fichier de métadonnées pour une collection de dix tokens (NFT).

En image : un guide visuel de dix NFT, une série de formes de couleurs alternées et avec des emojis différents. P.S. cette légende est une forme de métadonnées, expliquant le contenu de cette image de manière indexable.

Remarquez les dix tokens et notez les différences visuelles entre eux. Certains sont des cercles, d'autres sont des triangles, d'autres sont des carrés. Certaines ont une couleur d'arrière-plan bleue, d'autres verts, et d'autres jaunes. Et certains contiennent des émoticônes contents, d'autres contiennent des émoticônes en colère et d'autres n'ont aucun emoji. Sous chaque image se trouve une description textuelle du token. Cette description textuelle deviendra nos métadonnées pour notre fichier CSV.

Pour les besoins de cet exemple, supposons également que ces NFT puissent être utilisés dans un jeu simple, dans lequel certains NFT servent de personnages dotés de capacités ou de talents cachés. Ces talents ne sont pas visuellement présents, mais notre jeu ne serait pas en mesure d'activer ces talents cachés si nous ne les associions pas en tant que métadonnées au NFT. Ainsi, notre fichier CSV contiendra ces talents cachés et ils seront associés au NFT de manière non visuelle.

Nous pouvons convertir les descripteurs en catégories, chacune se rapportant à une colonne de notre fichier CSV. Nous allons inclure une ligne d'en-tête avec les noms des attributs. Dans la plupart des cas, il convient d'utiliser la forme singulière du descripteur, car chaque NFT ne possède qu'un seul attribut de ce type. Par exemple, nous ne dirions pas "Couleurs" puisque le NFT n'aura qu'une seule "Couleur" associée à lui. La valeur que nous utilisons comme en-tête sera représentée visuellement à côté du NFT sur la place de marché.

Pour terminer, remarquez que certains NFT de notre exemple ne sont pas associés à des emojis. Nous pouvons donc faire deux choses. Tout d'abord, nous pouvons laisser le champ vide, ce qui aura pour effet de regrouper automatiquement les blancs comme une valeur nulle ou, en pratique, "Aucune" dans des cas comme le tri et le filtrage. Une deuxième option serait de décrire l'absence d'un trait comme une toute autre caractéristique. Le cas échéant, cela dépend de votre collection, mais il peut être plus judicieux de décrire le trait que de ne pas le faire. Par exemple, si vous avez un trait pour "Cheveux", vous pourriez imaginer que l'absence de ce trait ne soit pas "Aucun", mais plutôt "Chauve". Utilisez votre jugement pour déterminer si les valeurs doivent être laissées en blanc ou si elles doivent être décrites.

Une fois terminé, votre fichier CSV devrait ressembler à ceci :

Notez que la ligne 2 représente le token 1, la ligne 3 représente le token 2, et ainsi de suite. Remarquez également qu'il n'y a pas de lignes vides au bas du fichier. Les lignes vides ne seront pas acceptées par le Portail.

En plus, remarquez que la ligne 2 est automatiquement liée au token 1 simplement en vertu de son ordre dans le document. Il n'y a pas besoin d'une colonne spécifique pour l'ID. Si une colonne est incluse pour l'ID, celui-ci sera présent en tant qu'attribut supplémentaire, ce qui encombrera inutilement le tri et le filtrage. Nous vous recommandons de ne pas inclure cet attribut, sauf si vous en avez un besoin spécifique.