The Comparator

Documentation pour détaillants

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

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]
  1. Soumettre la demande et le flux : vous soumettez la demande de votre magasin et l’adresse de votre flux à /fr-ca/retailers/apply/.
  2. 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).
  3. 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.
  4. 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.
  5. 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 :

Interface de demande des détaillants
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 :

Interface des exigences du flux
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êteExemple de valeurDescription
skuGPU-4070S-01L’identifiant interne de votre produit.
feed_titleASUS TUF Gaming GeForce RTX 4070 Ti SUPER OC 16GBLe titre d’origine, tel qu’il figure dans votre flux.
matched_modelNVIDIA GeForce RTX 4070 Ti SUPERLe modèle de matériel canonique dans la base de données de The Comparator.
statusMatchedLe résultat du traitement (Matched, Ambiguous, Review, Rejected).
issue_codeNONELe code de diagnostic des avertissements ou des rejets.
live_urlhttps://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 :

  1. Ouvrez votre rapport de jumelage CSV dans Excel ou Google Sheets.
  2. Ajoutez une colonne intitulée Correction.
  3. Inscrivez le nom exact du matériel canonique ou l’adresse de The Comparator (p. ex. https://thecomparator.tech/gpu/rtx-4070-super/).
  4. 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 :

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