Académie des détaillants | PC Part Comparator

Gérer votre flux et les résultats de jumelage

Mon, 01 Jan 0001 00:00:00 +0000

Gérer votre flux et les résultats de jumelage

The Comparator utilise un processus d’intégration assistée et de gestion opérationnelle. Nous n’exploitons pas, pour l’instant, de portail libre-service ni de tableau de bord avec connexion pour les détaillants.

Ce guide explique comment votre magasin interagit avec notre équipe d’intégration, comment lire vos rapports de jumelage en CSV et comment soumettre des corrections.

1. Aperçu du processus opérationnel

Comme le jumelage du matériel exige une rigueur technique stricte, notre équipe d’ingénierie gère la chaîne d’ingestion.

[1. Soumettre le flux] ➔ [2. Ingestion et validation] ➔ [3. Rapport de jumelage CSV] ➔ [4. Soumettre les corrections] ➔ [5. Synchronisation en direct]

Soumettre la demande et le flux : vous soumettez la demande de votre magasin et l’adresse de votre flux à .
Ingestion initiale : notre système récupère votre flux, valide les règles du schéma et tente le jumelage avec notre base de référence du matériel (ref_specs.json).
Réception du rapport de jumelage CSV : notre équipe d’intégration vous envoie par courriel un rapport CSV détaillant les éléments jumelés, ambigus et rejetés.
Examiner et corriger : vous examinez le CSV, vous ajoutez les MPN et les GTIN manquants dans votre flux ou vous annotez les corrections, puis vous le renvoyez à retailers@thecomparator.tech.
Publication et synchronisation en direct : nous appliquons vos remplacements de jumelage à la configuration de notre chaîne de traitement (corrections.json). Vos produits jumelés apparaissent en direct dans les tableaux de comparaison.

2. Interface d’intégration et captures d’écran

Interface de demande des détaillants (`/fr-ca/retailers/apply/`)

Quand vous inscrivez votre magasin, vous soumettez vos renseignements dans notre formulaire de demande de partenariat :

Figure 1 : le formulaire de demande de partenariat. Le texte de confirmation précise qu’aucune connexion à un portail ni aucun appel de configuration n’est exigé à cette étape.

Référence des exigences du flux (`/fr-ca/retailers/feed-requirements/`)

Les directives techniques sur les formats de flux peuvent être consultées en tout temps :

Figure 2 : la page des exigences techniques du flux, qui détaille les structures CSV, JSON et XML acceptées.

3. Lire le rapport de jumelage (format CSV)

Quand votre flux est traité, notre équipe produit un rapport de jumelage (format CSV).

Structure du rapport de jumelage CSV

En-tête	Exemple de valeur	Description
`sku`	`GPU-4070S-01`	L’identifiant interne de votre produit.
`feed_title`	`ASUS TUF Gaming GeForce RTX 4070 Ti SUPER OC 16GB`	Le titre d’origine, tel qu’il figure dans votre flux.
`matched_model`	`NVIDIA GeForce RTX 4070 Ti SUPER`	Le modèle de matériel canonique dans la base de données de The Comparator.
`status`	`Matched`	Le résultat du traitement (`Matched`, `Ambiguous`, `Review`, `Rejected`).
`issue_code`	`NONE`	Le code de diagnostic des avertissements ou des rejets.
`live_url`	`https://thecomparator.tech/gpu/rtx-4070-ti-super/`	La page de The Comparator où l’offre apparaît.

4. Signification des statuts et codes de problème

Définitions des statuts de jumelage

✅ Matched : l’élément a été identifié et jumelé avec succès à un modèle de matériel canonique. Il apparaît en direct lorsqu’il est in_stock.
⚠️ Ambiguous : notre algorithme a trouvé plusieurs jumelages possibles (p. ex. impossible de distinguer une variante de 12 Go d’une variante de 16 Go à cause d’un titre vague). Une correction manuelle est nécessaire.
🔍 Review : l’offre a été signalée pour un examen manuel (p. ex. le prix est 40 % sous la moyenne du marché). Elle est retenue jusqu’à vérification.
❌ Rejected : l’offre ne peut pas être importée (p. ex. catégorie non prise en charge ou ensemble).

Codes de diagnostic

NON_COMPONENT_ACCESSORY : l’élément est un boîtier de PC, un bloc de refroidissement liquide ou un support. (Ignoré sans risque par l’importateur.)
PRICE_ANOMALY : le prix est nettement en dehors des limites attendues pour ce matériel.
ERR_NO_IDENTIFIER : le titre est vague et aucun GTIN ni MPN n’a été fourni.
COMBO_OR_BUNDLE : l’élément contient plusieurs composants (rejeté par le filtre isComboListing).

5. Comment soumettre des corrections de jumelage

Si un élément a été marqué Ambiguous ou jumelé à la mauvaise variante de matériel :

Ouvrez votre rapport de jumelage CSV dans Excel ou Google Sheets.
Ajoutez une colonne intitulée Correction.
Inscrivez le nom exact du matériel canonique ou l’adresse de The Comparator (p. ex. https://thecomparator.tech/gpu/rtx-4070-super/).
Envoyez le CSV annoté à retailers@thecomparator.tech, avec l’objet Mapping Corrections - [Nom du magasin].

Notre équipe applique vos corrections en 24 heures, en mettant à jour cpu_corrections.json ou mobo_sata_corrections.json dans la chaîne de traitement en production.

6. Signaler une offre en ligne incorrecte

Si une offre en ligne affiche un prix incorrect ou renvoie à la mauvaise page de destination :

Vérifiez votre flux source pour vous assurer que le SKU et le prix sont corrects.
Envoyez un courriel à retailers@thecomparator.tech avec l’objet : URGENT: Live Price Mismatch - [Nom du magasin].
Indiquez le SKU, l’adresse en ligne erronée et le lien de la bonne page de destination.
Les signalements urgents sont traités en 4 heures.

Préparer votre flux de produits

Mon, 01 Jan 0001 00:00:00 +0000

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.

Mode de soumission	Pris en charge?	Format	Authentification	Taille max. du fichier	Fréquence d’actualisation	Avis d’erreur
Adresse publique du flux	Oui (préféré)	CSV / JSON / XML	Authentification HTTP de base ou aucune	50 Mo	Planifiée (quotidienne ou horaire)	Rapport de jumelage par courriel
XML Google Merchant	Oui	XML RSS 2.0	Aucune	50 Mo	Planifiée	Rapport de jumelage par courriel
Réseau d’affiliation	Oui	Flux du réseau	Authentification du réseau	Selon le réseau	Quotidienne	Rapport de jumelage par courriel
API libre-service	Prévue	REST / webhooks	Jeton porteur	S.O.	En temps réel	Réponse de l’API

Note

Note opérationnelle : si votre flux exige une authentification ou une liste d’adresses IP autorisées, fournissez les détails lors de votre demande à .

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.

Champ	Statut	Type de données	Exemple	Règle de validation	Utilisé pour
`id`	Obligatoire	Chaîne	`GPU-4070S-01`	Non vide, unique par article, 64 caractères max.	Suivi du SKU et de l’historique des prix
`title`	Obligatoire	Chaîne	`ASUS TUF Gaming GeForce RTX 4070 Ti SUPER OC 16GB`	Doit contenir la marque et le modèle de matériel	Jumelage du modèle et affichage
`link`	Obligatoire	URL	`https://example.com/gpu-4070`	URL HTTP/HTTPS valide, accessible sans connexion	Diriger les acheteurs vers l’achat
`price`	Obligatoire	Décimal	`599.99`	Nombre positif, 2 décimales	Calcul de la valeur et affichage
`currency`	Obligatoire	Chaîne	`CAD`	`USD` pour le marché des États-Unis, `CAD` pour le marché du Canada	Normalisation des prix
`availability`	Obligatoire	Chaîne	`in_stock`	Doit correspondre aux chaînes de stock acceptées	Filtrage des offres actives
`condition`	Obligatoire	Chaîne	`New`	`New`, `Refurbished` ou `Used`	Regroupement du moteur de valeur
`brand`	Obligatoire	Chaîne	`ASUS`	Nom de fabricant non vide	Empreinte du matériel
`gtin`	Obligatoire sous condition	Chaîne	`4711387450889`	Chiffres EAN/UPC valides (12 à 14 chiffres)	Jumelage exact du produit
`mpn`	Obligatoire sous condition	Chaîne	`90YV0J80-M0NA00`	Numéro de pièce exact du fabricant	Jumelage exact du produit
`image_link`	Recommandé	URL	`https://example.com/img.jpg`	URL d’image directe valide (HTTPS)	Visuels de remplacement
`shipping`	Facultatif	Décimal	`9.99`	Décimal non négatif	Coût total de possession

Important

Exigence d’identifiant : vous devez fournir un gtin valide ou un mpn (ou les deux) pour un jumelage fiable du matériel. Les flux qui ne reposent que sur les titres sont rejetés 35 % plus souvent en raison de l’ambiguïté.

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 :

Valeur du flux du détaillant	État interne normalisé	Publié sur le site?	Notes
`in_stock`, `available`, `instock`	`in_stock`	Oui	Affiché dans le tableau de comparaison actif.
`out_of_stock`, `sold_out`, `unavailable`	`out_of_stock`	Non	Masqué de la vue par défaut (archivé).
`preorder`, `backorder`	`preorder`	Non	Retenu temporairement jusqu’à l’arrivée du stock.

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

Warning

Ne listez pas d’articles remis à neuf ou usagés comme New. Un état mal indiqué entraîne la suspension permanente du magasin.

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

Code d’erreur	Description du problème	Exemple de flux erroné	Exemple corrigé	Bloquant?
`ERR_MISSING_ID`	Le champ SKU est vide	`""`	`"GPU-4070-01"`	🔴 Oui
`ERR_INVALID_PRICE`	Symbole monétaire dans le prix	`"$599.99"`	`599.99`	🔴 Oui
`ERR_UNSUPPORTED_CURRENCY`	La devise n’est ni USD ni CAD	`"EUR"`	`"CAD"`	🔴 Oui
`ERR_AMBIGUOUS_TITLE`	Le titre manque d’information sur le modèle	`"NVIDIA RTX Card"`	`"ASUS RTX 4070 SUPER 12GB"`	🔴 Oui
`ERR_COMBO_REJECTED`	Lot de composants détecté	`"Ryzen 7 + B650 Bundle"`	À exclure du flux	🔴 Oui
`WARN_MISSING_GTIN`	Aucun GTIN ni MPN fourni	`gtin: ""`	`gtin: "4711387450889"`	🟡 Non

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 :

📄
📄
📄

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

node scripts/test_sample_feeds.js

Académie des détaillants | PC Part Comparator

Gérer votre flux et les résultats de jumelage

Gérer votre flux et les résultats de jumelage

1. Aperçu du processus opérationnel

2. Interface d’intégration et captures d’écran

Interface de demande des détaillants (/fr-ca/retailers/apply/)

Référence des exigences du flux (/fr-ca/retailers/feed-requirements/)

3. Lire le rapport de jumelage (format CSV)

Structure du rapport de jumelage CSV

4. Signification des statuts et codes de problème

Définitions des statuts de jumelage

Codes de diagnostic

5. Comment soumettre des corrections de jumelage

6. Signaler une offre en ligne incorrecte

Préparer votre flux de produits

Préparer votre flux de produits

1. Ce qu’est un flux de produits

2. Modes de soumission pris en charge

3. Référence exacte des champs

4. Règles pour les identifiants de produit stables

5. Titres des produits matériels

Cartes graphiques

Processeurs

Disques SSD

Mémoire vive

Cartes mères

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

7. Prix et devise

8. Correspondance de la disponibilité

9. Normes d’état

10. Exigences pour les adresses de produit

11. Exigences pour les adresses d’image

12. Variantes, ensembles et lots

13. Sémantique d’actualisation et de suppression

14. Étapes du processus de validation

15. Dépannage des erreurs courantes

16. Liste de vérification avant la soumission

17. Fichiers d’exemple fonctionnels

Interface de demande des détaillants (`/fr-ca/retailers/apply/`)

Référence des exigences du flux (`/fr-ca/retailers/feed-requirements/`)