{
  "acceptance": "The export reproduces the chart counts, 304 responses are labeled as revalidation, and any content-transfer total names the observed evidence it uses. An unavailable cached representation is disclosed.",
  "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": "A stale cached representation can lead to a conditional request using validators."
    },
    {
      "id": "c2",
      "section": "Explanation and verification steps",
      "source_numbers": [
        1
      ],
      "statement": "A 304 response can refresh the cache and allow the cached resource to be reused."
    }
  ],
  "description": "Keep conditional requests, transferred content and crawler access separate when reporting 304 responses.",
  "diagram": [
    "Initial representation and validator",
    "Conditional request with validator",
    "304: reuse cached representation",
    "Report requests and bytes separately"
  ],
  "draft_hash": "7190a43888404f11db6a26fe24572a83b0dc28e0156adfdee4a3b422c772ac49",
  "evidence": {
    "observed_at": "2026-11-02T18:45:53.757768+00:00",
    "period": {
      "end": "2026-11-02T18:45:53.757768+00:00",
      "start": "2026-11-02T18:45:53.757768+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": "sequence",
  "figure_notes": [
    "Retain the representation version and its validator.",
    "Inspect the request condition before interpreting the response.",
    "The client can reuse the cached representation.",
    "Do not turn revalidation requests into full-download counts."
  ],
  "figure_title": "Interpret 304 crawler responses as revalidation",
  "group": "Collection diagnostics",
  "human_review_claim": false,
  "intent": "304-crawler-revalidation-metrics",
  "interpretation": "MDN describes a conditional request as a check against a resource validator. If the resource has not changed, the server can return 304 Not Modified and the client can reuse its cached representation. The request still happened, but its meaning differs from a fresh full response. A report that treats all non-200 statuses as failed access loses that distinction; a report that calls each request a complete download overstates what was transferred.",
  "keyword_volume": "Not obtained",
  "limits": "The saved documentation explains HTTP behavior; it does not prove a specific crawler cached your page or included it in an AI answer. This article contains a hypothetical worksheet, not a completed crawler experiment.",
  "paid_api_calls": 0,
  "path": "/ai-analytics/guides/304-crawler-revalidation-metrics/",
  "policy": "session-evidence-editorial-v1",
  "preparation_mode": "session_editorial_batch",
  "problem": "A crawler response report classifies 304 responses as failures or treats every revalidation as a new full content transfer.",
  "product": "/ai-analytics",
  "published_at": "2026-11-04T11:50:31.943675+00:00",
  "reader": "Site owners and analysts investigating a crawler response report classifies 304 responses as failures or treats every revalidation as a new full content transfer.",
  "related": [
    "crawler-error-rate-denominator",
    "origin-logs-cdn-coverage"
  ],
  "related_links": [
    {
      "path": "/ai-analytics/guides/crawler-error-rate-denominator/",
      "title": "Choose a defensible crawler error-rate denominator"
    },
    {
      "path": "/ai-analytics/guides/origin-logs-cdn-coverage/",
      "title": "Explain the cache blind spot in origin-only logs"
    }
  ],
  "research_document_ids": [
    "0567a292bc0f19330a3064407b9cc316"
  ],
  "slug": "304-crawler-revalidation-metrics",
  "source_signature": "af7ade0d9ea42c05ede346d0ca3c2945a4c804ca770ff21b09e02119f34539f1",
  "sources": [
    {
      "hash": "0c33949f43563c1cdde7a5523cc85782a4b8efe22f6287b82289d6c7c7c25477",
      "locator": "Cache update / b25; Cache update / b26",
      "observed_at": "2026-11-02T18:45:53.757768+00:00",
      "title": "HTTP conditional requests",
      "url": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Conditional_requests"
    }
  ],
  "sources_required": [],
  "steps": [
    "For a small authorized sample, retain the status, request time and relevant validator headers. Check whether the request is conditional before interpreting its 304 response.",
    "Create distinct report buckets for content responses, revalidation responses and error responses. Document the classification and use the same rule in the chart and export.",
    "Compare transfer-byte fields only after naming their scope. A request count and a byte count are different measures; neither should be silently converted into a reader or citation count.",
    "Validate the reporting logic with a controlled resource that you can fetch, revalidate and then change. Record the actual responses from that experiment before using it as evidence of your implementation."
  ],
  "title": "Interpret 304 crawler responses as revalidation",
  "worked_example": "Hypothetical example: a monitoring worksheet contains one initial 200 response and two later conditional requests that received 304. A defensible summary is three requests, two successful revalidations and one observed initial representation transfer. It is not three independently observed reads of the complete article. If the initial representation is outside your retained window, mark that part unavailable instead of inventing it."
}