Skip to content

Product Matcher

Results and review

When a run has ended, Results shows every compared row of the run. Each row is Matched, No match or waits for Review. Three columns tell you why.

  1. Open your group, pick Matching, then Results. The tab is there after the first finished run.
  2. Pick a pill: Matched, No match or Review. Each pill shows its count.
  3. Read the three columns on each row:
    • Why matched: how the match was made, for example “Code”, “Text”, “Saved review decision” or “Approved in review”. A dash means a run from before these columns, or a match proven by the same EAN or maker code (the portal does not name these yet; the API field matchBasis says EAN or MPN).
    • Decided by: the step and rule that decided, for example “Step 2 · total score · Floor 40, Max 70 (shop)”. “Before the steps” means a check before step 1 decided.
    • Lines: each line’s result, for example “sku 100 (match) · name 62 (no)”. A photo line can show (not scored) or (not checked).
  4. To see the scores, press Show system fields. The group Technical matching fields holds totalScore (the total score), matchScore, photoScore (the photo score), descScore and more.
  5. Rank by orders the pairs: Total, Name, Photo or Description.
  6. To decide the pairs that wait, pick Review. Each card shows your item on the left and the shop item on the right, with their pictures.
  7. Every card counts as a match unless you flag it. Tap a card to flag it as not a match and add a reason if you want.
  8. Under a card, press the strip “I’ve reviewed to here” to send every pair from the top down to that card. Flagged pairs are rejected, the rest approved.
  9. Fields picks the values shown under both pictures (Both sides, Left only, Right only, Technical). Pairs narrows the review to some shops; Show all clears it.
  10. To undo one decision, press Unmatch on the approved row in Results. To undo all of them, use Unmatch all reviewed… below History. Careful: this puts every pair you approved, in every match setup of the group, back into Review and deletes your decisions, so you must decide them again. Your setup, run history and the matcher’s own matches stay. You type the group name to confirm.
The Results tab: Matched, No match and Review pills, and rows with Why matched, Decided by and Lines.
Each row says how it was matched and which step decided it.

Your decisions are kept on the next run

A decision is saved for the pair, not only for today’s rows. On every new run, an approved pair is matched again and a rejected pair is not suggested again. After you decide pairs, Match quality is checked again by itself; the old numbers stay on screen until the new ones are ready.

Matched row fields

FieldMeaning
matchDecisionMATCH, REVIEW or NO
totalScore / matchScoreThe total score, 0 to 100
photoScoreThe photo score, when photos were compared
descScoreThe description score
matchBasisWhat decided a match: EAN, MPN, CODE, TEXT, or VERDICT (a saved review decision)
decidedByThe step (step), the rule (rule) and the limits (band) that decided
matchLinesEach line’s result and score (the Lines column)
masterRefThe linked row of your list
reviewMasterRefOn review and no-match rows: the closest product of your list
gatesFiredThe checks that fired while deciding
sourceNameThe shop
matcherRunId, matchedAtThe run that wrote the row and when

Errors you may see

400 on match/data
An unknown bucket, or bucket with view=wide.
400 IDEMPOTENCY_KEY_REQUIRED
A decision or unmatch call without the Idempotency-Key header.
400 on more than 200 rows
Send review decisions in chunks of at most 200.
400 on unmatch
The pair has no saved decision: the matcher matched it, or you already unmatched it.
409 on unmatch
A match run of the group is going. Try again when it has ended.
403 with a Read key
A Read key cannot send decisions. Use a Full key.

Questions

Why is Results not there?

Results appears after the group’s first finished run. Until then you see only Match the data.

Where are the text score, the photo score and the total score?

Press Show system fields and look under Technical matching fields: totalScore, photoScore and the line scores. Lines shows each line’s score in short.

Does a new run undo my review?

No. Approved pairs stay matched and rejected pairs stay out on every new run.

How do I get all matched rows as a file?

Use the daily matched file, see Schedule and history.

Everything on this screen

Review the pairs:

  • Right match, Wrong match and Not sure: your decision on a pair.
  • To check, Checked, To review and Audit: the lists of pairs. The number is how many pairs are in it.
  • Total, Photo and Desc: order the pairs by the total score, the photo score or the description score.
  • The strip “I’ve reviewed to here” saves every pair from the top down to that card. Flagged pairs are rejected, the rest approved. It reads Submitting while it saves.
  • Each card shows your item and the shop item. Where a photo check ran, a small panel shows what the photo check read from both pictures.
  • After you flag a card you can pick a reason from a list or type your own: why is it wrong?
  • Under the pictures, the field lines show the values chosen in Fields.
  • In the wide view, badges count the rows of the long view. The wide view pivots accepted matches.

Display and export:

  • Display: Long shows one row per pair, Wide one row per match. Matching fields only hides the other columns, Visible columns and All columns pick which columns show, and Description shows the description.
  • When the Display panel is folded, a narrow strip of buttons opens it again: the layout, Rank by, Show system fields, Matching fields only, and an arrow to open the panel.
  • Export: downloads the matched rows as JSON Lines or CSV.

Undo all your decisions:

  • Unmatch ALL hand-reviewed matches for this group? and Unmatch everything: undo every decision you made by hand. The pairs go back to Review and your decisions are deleted. Type the group name to confirm.

Last updated 4 November 2026