Préparer votre flux de produits

Ce guide explique comment formater vos données de produits pour The Comparator. Un flux propre et exact garantit que vos offres sont jumelées aux bons composants dans notre base de données normalisée.

1. Ce qu’est un flux de produits

Un flux de produits est un fichier de données structurées qui contient l’inventaire, les prix et la disponibilité actuels de votre magasin.

• Un enregistrement = une offre : chaque ligne ou objet représente une variante précise d’un composant matériel.
• Identifiants stables : le SKU ou l’identifiant de votre produit ne doit pas changer d’une mise à jour du flux à l’autre. Notre système peut ainsi suivre l’historique des prix et la disponibilité sans créer de doublons.
• Indépendance du moteur de valeur : soumettre un flux inscrit votre magasin dans nos blocs de comparaison « Où acheter ». Cela ne modifie pas la valeur ni le classement organique d’un produit, qui sont calculés de façon strictement algorithmique.

2. Modes de soumission pris en charge

Pour l’instant, l’intégration d’un nouveau détaillant passe par un processus d’intégration assistée. Vous fournissez l’adresse ou le fichier du flux, et notre équipe d’intégration configure le jumelage d’importation.

3. Référence exacte des champs

Notre chaîne d’importation accepte les champs suivants. Assurez-vous que les colonnes de votre flux ou les clés JSON correspondent à ces définitions.

4. Règles pour les identifiants de produit stables

Votre champ id est la clé primaire qui relie votre offre à notre base de données.

• Ne changez pas l’identifiant lorsque le prix ou le stock d’un produit est mis à jour.
• Ne réutilisez pas un ancien identifiant pour un autre modèle de matériel.
• N’utilisez pas de numéros de ligne et ne générez pas d’UUID aléatoires à chaque exportation.
• Caractères permis : caractères alphanumériques, traits d’union, traits de soulignement ([A-Za-z0-9_-]). 64 caractères au maximum.

5. Titres des produits matériels

Le jumelage du matériel repose sur l’analyse des titres quand le GTIN et le MPN manquent. Écrivez des titres clairs et techniques plutôt que des slogans publicitaires.

Cartes graphiques

Indiquez le fabricant de la carte, le modèle exact de la puce graphique, la capacité de mémoire vidéo et les suffixes (Ti, SUPER, XT, XTX).

• Bon : ASUS TUF Gaming GeForce RTX 4070 Ti SUPER OC 16GB
• Mauvais : Awesome Gaming Graphics Card RTX 4070 - Best Deal!

Processeurs

Indiquez la marque, le numéro de modèle exact et les suffixes (K, KF, F, X, X3D).

• Bon : AMD Ryzen 7 7800X3D Boxed
• Mauvais : Fast 8-Core AMD Processor for PC

Disques SSD

Indiquez la marque, le modèle de la série, la capacité, le format et l’interface.

• Bon : Samsung 990 PRO 2TB NVMe M.2 PCIe 4.0 SSD
• Mauvais : Super Fast 2TB Internal Hard Drive

Mémoire vive

Indiquez la marque, la série, la capacité totale, le nombre de modules, la génération et la vitesse.

• Bon : G.SKILL Trident Z5 RGB 32GB (2x16GB) DDR5 6000MHz CL30
• Mauvais : 32GB High Speed RAM Kit

Cartes mères

Indiquez la marque, le modèle, le jeu de puces, le socket et la révision Wi-Fi.

• Bon : MSI MAG B650 TOMAHAWK WIFI ATX AM5 Motherboard
• Mauvais : MSI AM5 Gaming Mainboard

6. Identifiants de produit (GTIN, MPN, marque)

• GTIN (EAN / UPC) : doit être un GTIN GS1 valide. Ne mettez pas de SKU internes dans le champ GTIN.
• MPN : indiquez les numéros de pièce exacts du fabricant (p. ex. 100-100000910WOF). N’enlevez ni les traits d’union ni les suffixes finaux.
• Marque : nom canonique du fabricant (p. ex. ASUS, Gigabyte, MSI, AMD, Intel, NVIDIA, Western Digital).

7. Prix et devise

• Format : un nombre décimal simple, sans symbole monétaire (p. ex. 599.99, et non $599.99).
• Devise : USD pour le marché des États-Unis, CAD pour le marché du Canada. Un prix d’un marché n’est jamais affiché dans l’autre.
• Concordance avec la page de destination : le prix du flux doit correspondre au prix de votre page de produit. Les prix cachés, débloqués seulement par des codes promotionnels à la caisse, sont interdits.

8. Correspondance de la disponibilité

Nous normalisons la disponibilité des magasins en états internes standardisés :

9. Normes d’état

The Comparator classe les offres en trois catégories d’état distinctes :

• New : article neuf, scellé en usine, avec la garantie complète du fabricant.
• Refurbished : remis à neuf par l’usine ou le vendeur. Doit être signalé explicitement.
• Used : article usagé.

10. Exigences pour les adresses de produit

• Doivent mener directement à la page du produit (pas de résultats de recherche ni de pages de catégorie).
• Doivent être accessibles publiquement, sans connexion, sans témoin et sans blocage par captcha.
• Doivent utiliser des URL HTTPS propres et canoniques.

11. Exigences pour les adresses d’image

• Adresse directe d’un fichier image (.jpg, .png, .webp) en HTTPS.
• Ne doit pas mener à des pages de visionneuse HTML ni exiger d’authentification.

12. Variantes, ensembles et lots

• Kits de mémoire vive et SSD : indiquez la capacité totale exacte et la répartition des modules (p. ex. 32GB (2x16GB)).
• Lots de composants et PC préassemblés : NON PRIS EN CHARGE. Notre chaîne de jumelage (filtre isComboListing) rejette automatiquement les combos processeur + carte mère, les boîtiers de PC et les systèmes préassemblés. Soumettez uniquement des composants individuels.

13. Sémantique d’actualisation et de suppression

• Intervalle de synchronisation : la synchronisation par défaut a lieu toutes les 24 heures. Les comptes prioritaires se synchronisent toutes les heures.
• Lignes manquantes : si un SKU est absent de 2 récupérations consécutives du flux, il est marqué out_of_stock.
• Flux périmés : si la récupération d’un flux échoue pendant plus de 48 heures, toutes les offres du magasin sont masquées temporairement jusqu’au rétablissement du flux.

14. Étapes du processus de validation

Notre chaîne d’importation valide les données selon 3 niveaux de gravité :

[Récupération du flux] ➔ [Analyse] ➔ [Validation du schéma] ➔ [Jumelage du matériel] ➔ [Publication]

• 🔴 Erreur (bloquante) : SKU manquant, prix mal formé ou XML/JSON inanalysable. L’offre est rejetée.
• 🟡 Avertissement (non bloquant) : lien d’image ou GTIN manquant. L’offre est publiée, mais signalée pour un examen manuel.
• 🔵 Information : conseils pour améliorer le formatage des titres.

15. Dépannage des erreurs courantes

16. Liste de vérification avant la soumission

• Les identifiants de produit (SKU) sont stables, non vides et uniques.
• Les prix s’analysent correctement comme des décimaux, sans symbole $.
• La devise est explicitement USD ou CAD, selon le marché.
• La disponibilité du stock est exacte (in_stock / out_of_stock).
• Les titres de produits contiennent les spécifications exactes du matériel (mémoire vidéo, modèle, suffixes).
• Au moins un identifiant (gtin ou mpn) est fourni par ligne.
• Les lots et les PC préassemblés sont exclus.
• Les adresses de produit s’ouvrent directement, sans authentification.

17. Fichiers d’exemple fonctionnels

Téléchargez nos exemples de flux validés pour tester la configuration de votre exportation :

• 📄 Télécharger un exemple de flux CSV
• 📄 Télécharger un exemple de flux JSON
• 📄 Télécharger un exemple de flux XML Google Merchant

Vous pouvez valider vos exemples de flux en local avec notre commande de validation :

node scripts/test_sample_feeds.js