構造化データ（JSON-LD）のエラー確認とテスト方法・原因と対処法

JSON-LDを用いてホームページ（ウェブサイト）に構造化データを実装した後、その記述が正しく機能しているかを確認するテストとデバッグの作業は非常に重要です。いくら丁寧にコードを記述しても括弧の閉じ忘れといった単純な構文ミスやWordPressなどのCMSが出力するプラグインとの競合、あるいはJavaScriptによる動的レンダリングのタイムラグなど、様々な要因でエラーが発生します。

実装した構造化データがGoogleに正確に認識され、検索結果にリッチリザルトとして表示されるよう、専用のテストツールを使った検証手順やSearch Consoleでの監視方法、そして現場でよく遭遇するエラーの原因と具体的な対処法について詳しく解説します。

JSON-LDテストツールによる記述の検証とデバッグ

ホームページ（ウェブサイト）にJSON-LDを記述した後は、公開前後を問わず必ず検証ツールを使って構文や仕様のチェックを行います。Googleが提供している公式のデバッグツールなどを活用することで、検索エンジンがデータをどう解釈するかを事前に把握し、トラブルを未然に防ぐことが可能です。

Googleリッチリザルトテストの活用

JSON-LDの記述がGoogle検索でどのように解釈され、リッチリザルトとして表示される可能性があるかを確認するための最も重要なツールが、Googleリッチリザルトテストです。このツールは、実装したJSON-LDがGoogleの品質ガイドラインに準拠しているか、特定の検索機能の対象となるかを検証してくれます。

リッチリザルトテスト（Google）

URL入力とコード貼り付けによるテスト方法

使い方はとてもシンプルです。すでに公開されているホームページ（ウェブサイト）の場合は、該当のURLを入力してテストを実行します。ツールはそのURLからHTMLをフェッチし、埋め込まれているJSON-LDを解析します。

まだ公開されていない開発中のローカル環境のページや、特定のコードスニペットだけをテストしたい場合は、JSON-LDのコードを直接テキストエリアに貼り付けて検証することもできます。

JavaScriptやGoogleタグマネージャー（GTM）経由で動的にJSON-LDを生成している場合でも、URLテストであればレンダリング後の状態を検証できるため、実際のGooglebotの挙動に近いテストが可能です。

有効な項目、警告、エラーの確認

テストを実行すると、結果画面には判定情報が表示されます。「有効な項目」と表示された場合は、構造化データが正しく記述されており、リッチリザルトの対象となる可能性が高いことを示します。ここには、どのタイプのリッチリザルトが検出されたか、そのデータが持つ主なプロパティなどが表示されます。

「警告」は、構造化データ自体は有効であるものの、推奨プロパティが不足しているなど、改善の余地があることを示します。警告がある場合でもリッチリザルトが表示されることはありますが、検索結果での視認性やクリック率を最大化するためにも可能な限り解消しておくことが望ましいです。

「エラー」は、構造化データに重大な問題があり、リッチリザルトの対象とならないことを示します。構文エラーや必須プロパティの欠如などが原因で発生します。

テスト結果の解釈と修正手順

エラーが表示された場合、ツールは具体的にどの行でどのような問題が発生しているかを教えてくれます。この情報を基にソースコードを修正し、再度テストを実行して問題が解消されたことを確認します。

警告の場合も同様に、どのプロパティが不足しているかなどが示されるため、必要に応じて情報を追加したり、既存の記述を見直したりします。このツールを有効活用することで、実装段階でのミスを早期に発見し、修正することが可能になります。

Schema.org Markup Validatorによるスキーマ準拠の確認

GoogleリッチリザルトテストがGoogle検索に特化しているのに対し、Schema.org Markup Validatorは、記述された構造化データがSchema.orgの仕様に正しく準拠しているかを確認するための汎用的なツールです。

https://search.google.com/test/rich-results?hl=ja

Google以外の検索エンジンや、一般的な構造化データツールとの互換性を確保する上で役立ちます。

このツールもURL入力またはコード直接貼り付けで利用でき、特定のスキーマタイプが正しく認識されているか、プロパティのスペルミスがないかなどを確認するのに便利です。Googleがサポートしていないマイナーなスキーマを実装する際にも重宝します。

Google Search Consoleでの構造化データレポートと監視

個別のページをテストするツールとは異なり、ホームページ（ウェブサイト）全体で構造化データにどのような問題が発生しているかを俯瞰的に把握するためには、Google Search Consoleを活用します。

サイト規模が大きくなるほど、ページ単位での手動テストは非現実的になるため、Search Consoleでの定期的な監視が必要となります。

エラーの監視と改善箇所の特定

Search Consoleの「拡張」セクションにある各リッチリザルトタイプ（商品、レビュー、FAQなど）のレポートでは、有効な項目数、警告のある項目数、そしてエラーのある項目数がグラフで表示されます。

エラーが発生している場合、その詳細な内容と対象となるURLが一覧で表示されるため、ページ数の多いホームページ（ウェブサイト）で問題箇所を特定する際に非常に有用です。このレポートを定期的に確認することで、サイト改修のタイミングで新たなエラーが発生していないか、以前修正したエラーが解決済みと認識されているかなどを継続的に監視できます。

パフォーマンスレポートとの連携による効果測定

Search Consoleのパフォーマンスレポートでは、「検索での見え方」でフィルタリングすることで、リッチリザルトが表示された際のクリック数や表示回数、平均掲載順位を確認できます。これにより、JSON-LDの実装が実際にどの程度、検索からの流入や事業への貢献につながっているかを定量的に把握することが可能になります。

どのリッチリザルトがユーザーにクリックされているか、どのようなクエリで表示されているかなどを分析し、今後のSEO施策やマークアップの改善に役立てられます。

よくある構造化データエラーの原因と一般的な対処法

JSON-LDの実装でよく遭遇する代表的なエラーメッセージと、その解決に向けた具体的な対処法をいくつかご紹介します。WordPressなどのCMS特有のトラブルや、JavaScriptレンダリングに起因する問題についても対応できるようにしておくことで、ホームページ（ウェブサイト）が常に検索エンジンに正しく評価され続ける状態を保てます。

必須プロパティの欠如（Required property is missing）

エラー内容として「Required property ‘name’ is missing」のように表示されるケースです。対処法として、Schema.orgのドキュメントやGoogleの検索セントラルを参照し、そのスキーマタイプにとって必須とされるプロパティ（name、image、priceなど）がJSON-LDに正しく記述されているかを確認し、不足している場合は追加します。特にECサイトの商品ページなどでは、価格や在庫状況のプロパティが欠落しやすいため注意が必要です。

型定義の誤り（Value must be of type）

エラー内容として「Value for ‘price’ must be of type ‘Number’」のように表示されるケースです。対処法として、プロパティに与える値のデータ型が、Schema.orgの定義と一致しているかを確認します。数値であるべきところに文字列が入っていたり、URLであるべきところにテキストが入っていたりしないか、@typeの指定が正しいかなどを確認します。

JSON構文エラー（Unexpected token）

エラー内容として「Unexpected token」や「Expected ‘,’ or ‘}’」など、JSONの書式自体に関するエラーが表示されるケースです。対処法として、カンマの付け忘れ、コロンの欠如、引用符の閉じ忘れ、全角スペースの混入、最後の行の余分なカンマなど、JSONの構文ルールに厳密に従っているかを確認します。記述が複雑な場合は、オンラインのJSONバリデーターツールやエディタのシンタックスハイライト機能を活用して構文チェックを行うとスムーズに発見できます。

関連性のない情報による品質ガイドライン違反

明示的な構文エラーメッセージが出ないにもかかわらず、リッチリザルトが表示されない、または品質ガイドライン違反の警告がSearch Consoleに届くケースです。

対処法として、JSON-LDに記述している情報が、そのホームページ（ウェブサイト）のメインコンテンツと密接に関連しているかを見直します。ページ上に表示されていない隠しテキストをマークアップしていたり、ページ内容と無関係なスキーマを記述していたりしないかを確認し、適切に修正します。

CMSプラグインとの重複・競合によるエラー

WordPressなどのCMSを使用している場合、導入しているSEOプラグインが自動的にJSON-LDを出力していることがあります。そこに手動で独自のJSON-LDを追加すると、同じページ内に異なる構造化データが重複して出力され、Googlebotが正しく解釈できずにエラーや警告を引き起こす原因となります。

この場合は、ブラウザでソースコードを表示して重複を確認し、プラグイン側の出力を制御するか、手動での記述をやめてプラグインの機能に統合するなどの調整を行います。

JavaScriptによる動的レンダリングのタイムラグ

Googleタグマネージャー（GTM）やJavaScriptフレームワークを使ってJSON-LDを動的に生成・挿入している場合、クローラーがJavaScriptをレンダリングする前にページを評価してしまうと、構造化データが認識されないことがあります。

GooglebotはJavaScriptを解釈できますが、レンダリングにはリソースと時間がかかるためです。リッチリザルトテストのURL検査で正しく認識されているかを確認し、もし継続的に問題が起きる場合は、静的なHTML内に直接JSON-LDを記述する方式への変更を検討します。

構造化データJSON-LDの実装とSEO