構造化データの検証ツール:1ページでもサイト全体でも確認する方法
構造化データは、ページが何についてのものかを、検索エンジンが推測せずに読める形で伝えます。これは商品で、これが価格で、これが著者です、というように。構造化データの検証ツールはそのマークアップを読み、解析できるか、語彙を正しく使っているか、検索機能に十分なほど完全かを教えてくれます。1ページのテストは簡単です。テンプレートで作られた数千ページのサイトでは、同じテストをすべてのページで実行する必要があります。
構造化データの検証ツールが確認すること
検証には4つの段階があり、それぞれ異なる種類の問題を見つけます:
- 構文。JSON-LDを解析できるか。microdataのプロパティはすべてアイテムの中にあるか。カンマが1つ抜けていたり、引用符がエスケープされていなかったりするだけで、ブロック全体が読めなくなることがあります。
- 語彙。タイプとプロパティは実在するSchema.orgの用語で、それが属するタイプに使われているか。スペルを間違えたプロパティはJSONとしては有効でも、何の意味も持ちません。
- 機能の要件。Googleは、対応する各リッチリザルトについて必須と推奨のプロパティを文書化しています。マークアップがSchema.orgとして有効でも、商品スニペットやイベントの掲載にGoogleが必要とするプロパティが欠けていることがあります。
- ページとの一致。Googleの構造化データのガイドラインでは、マークアップは訪問者に見えるコンテンツを記述するよう求めています。ページにない価格がマークアップにあったり、見出しが表示されているものと違ったりするのは、どんな構文チェックでも見つけられない品質の問題です。
1ページ用のツールのほとんどは最初の3つをカバーします。4つ目には、マークアップとレンダリング後のページを並べて見る必要があります。
Schema.orgの検証ツールとGoogleのリッチリザルトテスト
1ページずつテストする無料ツールが2つあり、答える問いが異なります。Googleの構造化データの概要では、作成中はリッチリザルトテストを使うよう勧めています。
| Schema Markup Validator | リッチリザルトテスト | |
|---|---|---|
| 開発元 | Schema.org | |
| 1回のテストのページ数 | 1 | 1 |
| URLまたは貼り付けたコード | ✓ | ✓ |
| JSON-LD、microdata、RDFa | ✓ | ✓ |
| Schema.orgの語彙全体 | ✓ | – |
| Googleのリッチリザルトの対象かどうか | – | ✓ |
| 欠けている必須プロパティ | – | ✓ |
| 結果のプレビュー | – | ✓ |
Schema Markup Validatorは、Googleの旧構造化データテストツールに代わるものです。ナレッジパネルやAIの回答に使われてもリッチリザルトのないタイプも含め、マークアップがSchema.orgとして正しいかを知るのに使います。特定のGoogleの機能が目的なら、リッチリザルトテストを使います。どちらもサイト全体を一度にはテストできません。SEO ProCheckでは、両方を使ってうまく表示されないリッチリザルトをデバッグする方法を解説しています。
JSON-LD、microdata、RDFa
Googleは3つの形式をすべて読み、有効であればどれも問題ないとしていますが、JSON-LDを推奨しています。HTMLとは別の1つのscriptブロックにまとまり、テンプレート全体で正しく保ちやすいからです。最小限のProductブロックは次のようになります:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"image": "https://www.example.com/shoe.jpg",
"offers": {
"@type": "Offer",
"price": "89.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
microdataとRDFaは、同じ情報を表示されるHTMLの属性に入れます。マークアップをコンテンツの近くに置けますが、HTMLのテンプレートを変えると気づかないうちに壊れることがあります。どれを使うにしても、1つのアイテムには1つの形式にしましょう。同じ商品を2つの形式で2回記述すると、両者が食い違う原因になります。
構造化データのよくあるエラー
- 壊れたJSON。末尾のカンマ、文書から貼り付けたスマート引用符、文字列内の生の改行など。
- @contextや@typeがない。これがないと、パーサーはブロックが何を記述しているかわかりません。
- 必須プロパティがない。下の表をご覧ください。
- ページと食い違うマークアップ。ページでは変わったのに、マークアップでは変わっていない価格など。
- 古い値。priceValidUntilを過ぎたOfferや、datePublishedより前のdateModifiedなど。
Googleの検索ギャラリーから、よくある機能の必須プロパティをいくつか紹介します:
| 種類 | Googleが必須とするもの |
|---|---|
| 商品スニペット | nameと、offers、review、aggregateRatingのいずれか |
| Event | name、startDate、location |
| Recipe | name、image |
| BreadcrumbList | itemListElement:name、position、item |
| Article | 0(すべて推奨) |
有効でも、以前のような効果がなくなったマークアップもあります:
| マークアップ | 変更 | 開始時期 |
|---|---|---|
| data-vocabulary.org | サポート終了 | 2021 |
| HowTo | リッチリザルトなし | 2023年9月 |
| FAQPage | 政府と医療のサイトのみ | 2023年8月 |
| FAQPage | リッチリザルトなし | 2026年5月 |
1ページでは不十分な理由
構造化データは、ほとんどの場合テンプレートで生成されます。壊れると、そのテンプレートが配信するすべてのページか、1つの項目が空になっている一部のページで壊れます。たまたま開いた商品ページをテストしても、価格の項目が範囲になっているせいで300の商品に価格がないことや、ある著者の記事に著者のマークアップがないことはわかりません。
サイト全体で見て初めてわかることが3つあります:
- カバー範囲。どのページグループにマークアップがあり、グループ内のどのページに、同じグループのほかのページにあるものが欠けているか。
- 特殊なケース。空の項目、変わった文字、一部のレコードにしかない値。
- ずれ。公開時には有効だったのに、リリースの後に無効になったマークアップ。Googleのドキュメントが、デプロイ後にリッチリザルトのレポートを確認するよう勧めているのはまさにこのためです。
サイト全体の構造化データを検証する方法
- サイトをクロールし、すべてのHTMLページから構造化データを抽出します。一部のマークアップがJavaScriptで挿入されるなら、JavaScript SEOクローラーのガイドにあるとおり、ページもレンダリングします。
- まず構文エラーを直します。解析できないブロックでは、ほかに何も確認できません。
- ページをテンプレートごとにまとめ、各グループにあるタイプを一覧にします。グループの大半にあるタイプが欠けているページを探します。
- 必須プロパティを確認します。目的の機能について確認し、次に推奨プロパティを確認します。
- マークアップを表示テキストと比べます:名前、見出し、価格はページ上に表示されているべきです。
- リッチリザルトテストで抜き取り確認します。テンプレートごとに1ページ確認し、Googleに何が見えているかを確かめます。
- Search Consoleを確認します。リリースのたびに、リッチリザルトのレポートとURL検査で、Googleが自身のクロールで見つけたものを確認します。
構造化データはテクニカルSEO監査チェックリストのステップの1つです。AI SEOクローラーのガイドで説明しているとおり、整ったマークアップはAIシステムがページを読む助けにもなります。
Neovaで構造化データを検証する
Neovaの構造化データのカテゴリでは、各ページの構造化データを「有効」「警告あり」「エラーあり」に分け、Schemaの型の列を追加し、URLパネルでタイプごとに判定を出します。クロールのすべてのHTMLページからJSON-LD、microdata、RDFaを読み取ります。チェック項目の一部:
- 構造化データに構文エラーがある:解析できない、または@contextや@typeがないJSON-LD
- 構造化データに必須プロパティがない、または表示されているテキストと異なる(Googleがドキュメント化している機能が対象)
- 構造化データに推奨プロパティがない:data-vocabulary.orgのマークアップにもフラグを立てます
- 構造化データのProductの価格がHTMLページに表示されていないとOfferのpriceValidUntilの日付が過ぎている
- 構造化データ、サイトマップのlastmod、Last-Modifiedの日付が矛盾している
- ページグループで一般的な構造化データの型がないとHTMLページに、そのページグループが持つリッチリザルトのマークアップがない
- OrganizationまたはPersonのマークアップに識別用のプロパティがない
- HTMLページに構造化データがない:クロールでレンダリングした場合は、レンダリング後のHTMLも読みます
- リッチリザルトが無効:Google Search ConsoleのURL検査から
NeovaはHTMLからページグループを見つけるので、テンプレートの問題は、数千の別々の行ではなく、同じフラグを持つ1つのグループとして表示されます。タイプや形式についての疑問には、SEO ProCheckの構造化データのFAQが答えています。機能をご覧になるか、Neovaをダウンロードしてください。Freeプランではすべてのチェック項目つきで1,000 URLまでクロールできます。
よくある質問
構造化データの検証ツールとは何ですか?
ページ上のJSON-LD、microdata、RDFaの構造化データを読み、解析できるか、Schema.orgのタイプとプロパティを正しく使っているか、そしてツールによっては、検索機能に必要なものがそろっているかを確認するツールです。
Schema Markup Validatorとリッチリザルトテストの違いは何ですか?
validator.schema.orgのSchema Markup Validatorは、Schema.orgの語彙全体に照らしてマークアップを確認します。Googleのリッチリザルトテストは、ページがどのGoogleのリッチリザルトの対象になるか、どの必須・推奨プロパティが欠けているかを確認します。
有効な構造化データがあればリッチリザルトは保証されますか?
いいえ。Googleによると、有効なマークアップはページを対象にするだけで、表示を保証するものではありません。リッチリザルトを表示するかどうかは、クエリ、ページ、品質に関するガイドラインに基づいて判断されます。
サイト全体の構造化データを検証できますか?
1ページ用のツールではできません。すべてのページで構造化データを抽出して確認するクローラーなら、テンプレートの問題、欠けているマークアップ、グループのほかのページと違うページがわかります。その後、テンプレートごとに1ページをリッチリザルトテストで抜き取り確認します。
構造化データはどの形式を使うべきですか?
GoogleはJSON-LD、microdata、RDFaを読み取り、JSON-LDを推奨しています。HTMLとは別の1つのブロックにまとまり、最も管理しやすいからです。