{
  "acceptance": "The unequal-weight fixture produces the expected result, the query names its measure and units, and the method accounts for weights that vary by row.",
  "automated_checks": true,
  "batch_id": "analytics-editorial-20261104-v1",
  "built_at": "2026-11-04T11:50:28.566595+00:00",
  "claims": [
    {
      "id": "c1",
      "section": "Explanation and verification steps",
      "source_numbers": [
        1
      ],
      "statement": "The sample interval is associated with the inverse sample rate."
    },
    {
      "id": "c2",
      "section": "Explanation and verification steps",
      "source_numbers": [
        1
      ],
      "statement": "A sampled point represents a number of unsampled data points."
    },
    {
      "id": "c3",
      "section": "Explanation and verification steps",
      "source_numbers": [
        1
      ],
      "statement": "Sample intervals can vary by row, so a constant factor is insufficient."
    },
    {
      "id": "c4",
      "section": "Explanation and verification steps",
      "source_numbers": [
        1
      ],
      "statement": "The documented weighted average divides the weighted sum by the sum of sample intervals."
    },
    {
      "id": "c5",
      "section": "Explanation and verification steps",
      "source_numbers": [
        1
      ],
      "statement": "Sample interval alone does not determine result accuracy."
    }
  ],
  "description": "Calculate represented counts and weighted averages using each row’s sample interval instead of applying one assumed sampling factor.",
  "diagram": [
    "Row A: value 2, weight 10",
    "Row B: value 8, weight 30",
    "Represented count: 10 + 30 = 40",
    "Weighted mean: 260 / 40 = 6.5"
  ],
  "draft_hash": "109777433e2594ac58ebcf372dae50b5e67e7781804bb602eced6e4bf20a6cac",
  "evidence": {
    "observed_at": "2026-11-02T23:15:29.254292+00:00",
    "period": {
      "end": "2026-11-02T23:15:29.254292+00:00",
      "start": "2026-11-02T23:15:29.254292+00:00",
      "timezone": "UTC"
    },
    "rows": [],
    "scope": "Official documentation; no customer or own-site traffic measurement"
  },
  "evidence_kind": "documentation",
  "figure_caption": "Original explanatory diagram based on the dated sources below. Any example values are hypothetical; this is not a screenshot, customer measurement or AI platform result.",
  "figure_kind": "calculation",
  "figure_notes": [
    "This is a hypothetical sampled row, not measured traffic.",
    "The unequal weight makes an unweighted calculation detectable.",
    "Sum weights for the represented count in this example.",
    "Divide the weighted sum by the total weight."
  ],
  "figure_title": "Use row weights in Workers Analytics Engine metrics",
  "group": "Log queries and report integrity",
  "human_review_claim": false,
  "intent": "weighted-analytics-engine-metrics",
  "interpretation": "Cloudflare documents _sample_interval as a per-row value related to the inverse sample rate and the number of original data points represented by a sampled row. The interval can vary between rows, so multiplying a total by one constant is not sufficient. The documentation also shows a weighted average using the sum of value times interval divided by the sum of intervals. Define the measure first, then apply the appropriate row weights consistently.",
  "keyword_volume": "Not obtained",
  "limits": "A larger sample interval alone does not determine accuracy. This guide covers arithmetic and query design, not a guarantee about the accuracy or completeness of any production dataset.",
  "paid_api_calls": 0,
  "path": "/ai-analytics/guides/weighted-analytics-engine-metrics/",
  "policy": "session-evidence-editorial-v1",
  "preparation_mode": "session_editorial_batch",
  "problem": "A sampled Workers Analytics Engine report treats every returned row as one original event or applies a single weight to all rows.",
  "product": "/ai-analytics",
  "published_at": "2026-11-05T14:40:21.922701+00:00",
  "reader": "Site owners and analysts investigating a sampled Workers Analytics Engine report treats every returned row as one original event or applies a single weight to all rows.",
  "related": [
    "sampled-graphql-results-comparison"
  ],
  "related_links": [
    {
      "path": "/ai-analytics/guides/sampled-graphql-results-comparison/",
      "title": "Why the same sampled analytics query can return different totals"
    }
  ],
  "research_document_ids": [
    "e7f0bd51ac011cde62a5c16d881e4b3c"
  ],
  "slug": "weighted-analytics-engine-metrics",
  "source_signature": "08d1245ad6383a9d67af996068fdb5ef9b4ebd54435a2c716ba3e21e982214b5",
  "sources": [
    {
      "hash": "6b4025546fe66b06ae652cf8737252d84f8ecdc4260bc451cedee91a800af59d",
      "locator": "How to read sampled data / b19; How to read sampled data / b20; How to read sampled data / b21; How to read sampled data / b26; How to read sampled data / b28",
      "observed_at": "2026-11-02T23:15:29.254292+00:00",
      "title": "Sampling with WAE",
      "url": "https://developers.cloudflare.com/analytics/analytics-engine/sampling/"
    }
  ],
  "sources_required": [],
  "steps": [
    "Confirm that the chosen dataset and query use the documented _sample_interval field. Preserve the measure, its unit and the returned per-row weights in a restricted verification sample.",
    "For a represented count, reason from the number of original points each row represents. For a sum or average, apply the documented weighting formula to the intended numeric field.",
    "Check a tiny hand-calculated fixture before running the production query. Include unequal weights so an implementation that ignores weights cannot accidentally pass.",
    "Compare the query result with the fixture and retain the formula in the report method. Label sampled estimates appropriately instead of describing them as an unsampled raw-event export."
  ],
  "title": "Use row weights in Workers Analytics Engine metrics",
  "worked_example": "Hypothetical arithmetic: one row has value 2 and weight 10; another has value 8 and weight 30. Their represented count is 40 and weighted mean is (2×10 + 8×30) / 40 = 6.5. The unweighted mean is 5 and answers a different question about the two returned rows. This calculation is an instructional fixture, not data from a Cloudflare account."
}