構造化データ設計

設計方針

構造化データはページ内容の理解を助けるための表現であり、可視内容に対応していることが前提です。AiventXでは、マークアップを本文から生成できる形に設計し、手書きの記述が本文から乖離しないようにします。

このサイト自体も同じ方針で実装しています。たとえばFAQのマークアップは、ページに表示しているFAQブロックから生成しており、片方だけを書き換えることができません。

タイプの使い分け

ページの役割に対して過剰なタイプを付けないことを重視します。

矛盾の検出

構造化データと可視内容の不一致は、目視では見つけにくい不備です。AiventX Web Lab では、意図的に矛盾させたページを検証ケースとして持ち、検出できるかどうかを回帰テストしています。

• 本文に存在しない著者・更新日の宣言
• 表示価格とマークアップ価格の不一致
• 可視パンくずと BreadcrumbList の階層ずれ
• FAQ マークアップに対応する質問が本文にない

成果物

テンプレート単位のマークアップ仕様、生成方法、検証手順を文書化します。仕様は実装後に検証できる形で書き、目視確認だけに依存しないようにします。

{
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "（ページに表示している質問文）",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "（ページに表示している回答文）"
      }
    }
  ]
}