トップ ／ プロダクト管理 ／ 構造化マークアップ検出設定
構造化マークアップ検出設定
このページでできること
- クロール時の改善案提案とページ内容との一致確認の対象となる構造化マークアップ種別を、プロダクト単位でオン／オフできます。
- Google リッチリザルト対象タイプと、WebPage / WebSite などの基本型をグループ別に一覧し、一括操作できます。
- 絞り込み検索・「Google対応のみ」などのショートカットで大量の種別を扱いやすくしています。
URL: pages/schema_detection.php?product_id=<id>。サイドバーの「プロダクト管理 → 構造化マークアップ検出設定」から開きます。システム管理者専用です。
デフォルトの挙動
- 未保存のプロダクトはすべての種別を検出対象（全チェック ON）として動作します。
- チェックを外した種別は、
StructuredDataSuggesterの提案とStructuredDataConsistencyCheckerの照合から除外されます。 - ページ上の JSON-LD / Microdata / RDFa の抽出そのものは継続します（結果詳細の「検出エンティティ」には表示され得ます）。オフにしているのは「提案・照合」だけです。
種別カタログ（SchemaDetectionRegistry）
設定の単位は SchemaDetectionRegistry::allTypes() が返す代表 @type 名（type キー）です。各エントリはサブタイプを aliases に持ち、Article なら NewsArticle / BlogPosting なども同じ設定でまとめて扱います。
| category | 内容 | 例 |
|---|---|---|
base | Google リッチリザルト非対象だが画面照合で使用 | WebPage, WebSite |
google | Google リッチリザルト対象（GoogleSchemaRegistry と連携） | Article, BreadcrumbList, FAQPage, Product … |
画面上はカテゴリごとに fieldset でグループ表示され、グループ単位の「すべてチェック／すべて外す」ボタンもあります。
画面上の操作
| 操作 | 説明 |
|---|---|
| 絞り込み（search） | タイプ名・日本語ラベル・説明文でクライアント側フィルタ |
| すべてチェック / すべて外す | 表示中を含むフォーム全体のチェック状態を一括変更 |
| Google対応のみ | category=google の種別だけを ON にするショートカット |
| 検出設定を保存 | action=save。ON の種別から disabled リストを逆算して DB 保存 |
| すべて検出に戻す | action=clear。product_schema_detection_settings の行を削除 |
サマリー行には 検出 N / 未検出 M / 全種別数が表示されます。
保存形式とクロールへの反映
- DB には無効化した種別のリストを
disabled_types_json（JSON 配列）として保存します（ON リストではなく OFF リスト）。 Repository::getDisabledDetectionTypes()→Crawler::run()→SchemaAnalyzer::analyze()のdisabled_detection_typesオプションに渡されます。- 正規化は
SchemaDetectionRegistry::normalizeDisabledTypes()/enabledTypesFromDisabled()で行い、未知の type 名は無視されます。
関連ドキュメント
- Google リッチリザルト対応 — ★Google対応バッジと各機能の要件
- マークアップ × ページ内容の一致確認 — 照合ロジックの詳細
- データベース設計 — テーブル定義