Skip to content

Result Explanations

Result explanations show why products ranked in specific positions, providing transparency into ranking decisions.

Overview

Result explanations help you understand ranking decisions by showing the factors that influenced each product's position, such as relevance scores, boost rules, and business signals.

Explanation Format

{
  "product_id": "prod_123",
  "position": 3,
  "explanation": {
    "base_relevance_score": 0.85,
    "factors": [
      {
        "factor": "query_match",
        "contribution": 0.3,
        "details": "Strong match for 'running shoes'"
      },
      {
        "factor": "boost_rule",
        "contribution": 0.2,
        "details": "Boosted by high-margin rule (+20%)"
      },
      {
        "factor": "inventory",
        "contribution": 0.15,
        "details": "In stock with high inventory"
      },
      {
        "factor": "purchase_rate",
        "contribution": 0.35,
        "details": "High purchase rate for this query"
      }
    ],
    "final_score": 0.92
  }
}

Best Practices

  1. Show key factors: Highlight most important ranking factors
  2. Use plain language: Make explanations understandable
  3. Provide details: Include specific values and reasons
  4. Enable debugging: Help identify ranking issues