トップ / プロダクト管理 / メタ情報の事前登録
メタ情報の事前登録
このページでできること
- プロダクト単位で WebSite 構造化マークアップの期待値を登録し、結果一覧の照合に使えます。
- パンくず UI を検出するための 追加 CSS セレクターをプロダクトごとに登録できます。
- 保存内容から
@type: WebSiteの JSON-LD プレビューを確認できます。
URL: pages/website.php?product_id=<id>。サイドバーの「プロダクト管理 → メタ情報の事前登録」から開きます。システム管理者専用のページです(プロダクト管理者はアクセスできません)。
先にプロダクトを選んでください
画面上部のプロダクトセレクタで対象が選ばれていない場合は「プロダクトを選択してください」とだけ表示されます。
2 つのタブ
画面はタブで切り替えます。保存後も、保存したタブがアクティブのまま表示されます(active_tab hidden フィールド)。
| タブ | 保存先 | 用途 |
|---|---|---|
| WebSite 期待値 | product_website_expectations(WebSite 系カラム) |
各 URL のクロール結果で検出された @type: WebSite と厳密一致で照合(空欄フィールドは照合スキップ) |
| パンくずセレクター | product_website_expectations.breadcrumb_selectors_json |
HtmlParser がパンくず UI を探す際の追加ヒント(1 行 1 セレクター) |
WebSite 期待値タブ
登録できるフィールドは Repository::WEBSITE_FIELDS で定義されています。
| フォーム名 | schema.org | 説明 |
|---|---|---|
name | name | サイト名 |
url | url | サイトの代表 URL |
alternate_name | alternateName | 別名・略称 |
description | description | サイト説明 |
in_language | inLanguage | 言語コード(例: ja) |
publisher_name / publisher_url | publisher | 発行者(Organization)の name / url |
search_action_target / search_action_query_input | potentialAction(SearchAction) | サイト内検索の urlTemplate / query-input |
same_as(textarea・改行区切り) | sameAs 配列 | SNS 等の関連 URL(JSON 配列として保存) |
照合の仕組み
WebsiteExpectationChecker が、ページから検出された WebSite エンティティと登録値を突き合わせます。文字列は前後空白除去のみで比較し、登録側が空のフィールドは「未設定」としてスキップします。結果は consistency_checks に出力され、結果一覧/詳細 で確認できます(詳細は 一致確認の仕組み も参照)。
操作
- WebSite 期待値を保存(
action=website_save)— UPSERT で保存。 - WebSite 期待値の登録を解除(
action=website_clear)— 行ごと削除。確認ダイアログあり。
画面下部の JSON-LD プレビュー は、現在の保存値から組み立てた @type: WebSite の参考 JSON です(ページへの貼り付け用)。
パンくずセレクタータブ
- textarea に CSS セレクターを 1 行 1 件で入力(例:
.breadcrumb、#crumbs、nav.bc)。 - 既定の検出(class / aria-label に
breadcrumbを含む要素)に加えて、プロダクト固有の命名規則に合わせて拡張します。 - 保存(
action=breadcrumb_save)/クリア(action=breadcrumb_clear)の 2 ボタン。 - クロール時は
CrawlerがRepository::getBreadcrumbSelectors()で読み込み、SchemaAnalyzerのbreadcrumb_selectorsオプションに渡します。
構造化マークアップ検出設定との関係
パンくずの提案・照合をオフにしたい場合は、構造化マークアップ検出設定 で
BreadcrumbList のチェックを外してください。セレクター登録だけでは提案対象のオン/オフは変わりません。