JSON-LD構造化データの記述場所と必須プロパティ

公開ツールJSON-LD スキーマ ジェネレーター

目次
  1. 構造化データは順位ではなく「表示」に関わります
  2. JSON-LDはどんな形をしているか
  3. どこに入れるのか
  4. ツールを使わずに自分で作り、検証する方法
  5. 必須プロパティと推奨プロパティは違います
  6. 設定したのにリッチリザルトが表示されない理由
  7. まとめ
  8. よくある質問

ブログや商品ページに「JSON-LDを入れましょう」と言われたけれど、それが一体何なのか、どこに入れるのか分からず困っている方に向けた記事です。

結論から言うと、JSON-LDはページの内容を検索エンジンが読める形式で別に書き留めておいたデータであり、HTML内の <script type="application/ld+json"> タグに入れます。

まず一点、はっきりさせておきます。マークアップを入れたからといって、星評価や画像のようなリッチリザルトが表示されるわけではありません。Googleのドキュメントにも「正しくマークアップしても、検索結果に表示されることを保証するものではない」と明記されています。

まとめ ① JSON-LDは <script type="application/ld+json"> の中に入れるJSONデータで、Googleのドキュメント上は <head> と <body> のどちらに入れてもかまいません。 ② リッチリザルトの対象になるには、タイプごとに必須プロパティがあります。Articleには必須プロパティがなく、ローカルビジネスはnameとaddressが必須です。 ③ 必須プロパティをすべて満たしても、表示は保証されません。FAQリッチリザルトのように、機能自体がなくなることもあります。

構造化データは順位ではなく「表示」に関わります

検索結果に星評価、価格、画像、サイト名といった付加要素が付いた結果をリッチリザルト(rich result)と呼びます。こうした要素は、ページ本文を読んで推測した値ではなく、ページが自ら申告したデータから来ています。

その申告書が構造化データであり、申告書を書くための文法のひとつがJSON-LDです。語彙はschema.org、表記形式はJSON-LD 1.1(2020年7月のW3C勧告)と、役割が分かれています。

ここでよく誤解が生まれます。構造化データは検索結果の見た目に関わるデータであって、順位を上げる仕組みではありません。Googleのドキュメントでは、構造化データに対する手動措置について「リッチリザルトとして表示される資格を失うだけで、ウェブ検索におけるページの順位には影響しません」と説明しています。

JSON-LDはどんな形をしているか

JSON-LDブロックは3つの部分から成ります。囲むタグ、語彙を指す @context、そして何についてのデータなのかを示す @type です。

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "構造化データ入門ガイド",
  "author": { "@type": "Person", "name": "山田太郎" },
  "datePublished": "2026-07-20",
  "image": "https://example.com/cover.jpg"
}
</script>

type 属性の値は application/ld+json でなければなりません。text/javascript と書くと、ブラウザがその中のJSONをコードとして実行しようとしてエラーになり、application/json と書くと実行はされないものの、検索エンジンが構造化データとして見つけられません。

@context は、後に続く headline や author といった名前をschema.orgの語彙として読むようにという宣言です。@type は、このデータが記事なのか商品なのか店なのかを決めます。この2つが欠けると、残りをどれだけ正確に書いても解釈されません。

値がまた別の事物であれば、入れ子のオブジェクトとして書きます。上の例の author がそれです。人名をひとつ書くときも { "@type": "Person", "name": "…" } の形で包むのはそのためです。

どこに入れるのか

GoogleのドキュメントはJSON-LDを「HTMLページの <head> と <body> 要素内の <script> タグに入る表記」と説明しています。つまりどちらに入れてもかまいません。

同じドキュメントでは、JavaScriptやウィジェットが後から挿入したJSON-LDも読み取れると明らかにしています。静的なHTMLに直接書き込むのが難しい環境では、この点が助けになります。

1ページに複数入れてもかまいません。たとえば記事ページにArticleブロックとパンくずリスト(BreadcrumbList)ブロックをそれぞれ置く、という形です。

ツールを使わずに自分で作り、検証する方法

手順は4ステップです。手作業でも十分にできます。

ステップ1: タイプを選び、必須プロパティを確認します

まずページが何なのかを決めます(記事・商品・店など)。次にGoogle検索セントラルの該当機能のドキュメントを開き、必須プロパティの表を確認します。タイプごとにリストが異なり、ドキュメントが更新されることもあります。

ステップ2: JSONを書きます

上の例の形で @context と @type を先に書き、確認したプロパティを埋めます。値が分からないプロパティは空文字列で残さず、いっそ省くほうがよいでしょう。空の値は不正なデータとして読まれる可能性があります。

ステップ3: 文法を検査します

JSONはカンマがひとつずれるだけで全体が無効になります。ブラウザの開発者ツール(多くの場合F12)のコンソールに以下を入れると、そのページに含まれるすべてのJSON-LDブロックが正しくパースされるかすぐに分かります。

[...document.querySelectorAll('script[type="application/ld+json"]')]
  .map(s => { try { return JSON.parse(s.textContent); } catch (e) { return "パース失敗: " + e.message; } })

ステップ4: 対象かどうかを確認します

Googleリッチリザルトテスト(search.google.com/test/rich-results)は、そのページがGoogleのどのリッチリザルト機能に対応しているかを教えてくれます。文法そのものだけを見たい場合は、schema.orgのマークアップ検証ツール(validator.schema.org)を使います。2つのツールは見ているものが違います。

問題はステップ1〜2です。プロパティ名と入れ子の構造を毎回ドキュメントから探して書き写さなければならず、カンマと波かっこを手作業で合わせる必要があります。

当社のツールで確認する。 上部のタブでArticle・Product・FAQ・LocalBusinessのいずれかを選び、フォームを埋めるとJSON-LDがリアルタイムで完成します。空欄の項目は結果から自動的に除かれ、<script> タグで囲む設定をオンにすると、そのまま貼り付けられる形で出力されます。

JSON-LD スキーマ ジェネレーター

インストールや会員登録は不要で、ブラウザ内ですぐに生成できます。入力した内容はサーバーに送信されません。

必須プロパティと推奨プロパティは違います

ここがよくずれます。schema.orgの語彙自体には「必須」という表示がありません。 必須プロパティは、検索エンジンが特定のリッチリザルト機能のために別途要求するリストです。

Googleのドキュメントを基準にまとめると次のとおりです。

タイプGoogleが要求する必須プロパティ
Article(記事)なし — 推奨プロパティのみです
Product(商品スニペット)name、およびreview・aggregateRating・offersのいずれか1つ
LocalBusiness(ローカルビジネス)name、address

Articleに必須プロパティがない点は意外に思えるかもしれません。Googleのドキュメントには「必須プロパティはなく、コンテンツに該当するプロパティを入れること」と書かれています。代わりにheadline・image・datePublished・dateModified・authorを推奨プロパティとしています。

反対に商品スニペットは、名前だけでは足りません。レビュー・集計評価・販売情報のうち少なくとも1つが必要で、それで初めて対象になります。

推奨プロパティは多く入れるほどよいように思えますが、Googleのドキュメントはすべての推奨プロパティを手薄に埋めるより、数が少なくても正確に埋めるほうがよいと明記しています。

設定したのにリッチリザルトが表示されない理由

必須プロパティをすべて埋めたのに、検索結果が変わらないことがあります。原因はおおむね次の4つです。

状況どうなるか
機能そのものがなくなったマークアップが有効でも、表示される場所がありません
画面にない内容をマークアップしているポリシー違反であり、対象から外れる可能性があります
必須プロパティが欠けているその機能の対象にすらなりません
対象ではあるが表示されないどのような形で見せるかは検索エンジンが決めます

1行目が実際に起きた例がFAQです。FAQのリッチリザルトは、2023年8月に政府・医療分野のよく知られたサイトへと対象が絞り込まれ、その後2026年5月7日からはGoogle検索に表示されなくなりました。

FAQPageのマークアップ自体は、今も有効なschema.orgのデータです。ただし、Google検索でFAQのアコーディオンとして表示されることはもうありません。

2行目も重要です。Googleのガイドラインは「ページを読む人に見えていない内容をマークアップしないこと」とはっきり定めています。画面にない評価や価格をJSON-LDにだけ書き込むのが、代表的な違反例です。

4行目がこの記事の出発点です。対象かどうかは通過要件であり、表示されるかどうかは検索エンジンの判断です。リッチリザルトテストで対象であると確認できても、実際の検索結果では通常のテキストで表示されることがあります。

まとめ

  • JSON-LDは<script type="application/ld+json">の中に置くJSONデータで、@contextと@typeが必ず必要です。
  • 置き場所は<head>・<body>のどちらでもよく、1つのページに複数のブロックを置くこともできます。
  • 必須プロパティはschema.orgが定めるものではなく、検索エンジンが機能ごとに求めるリストです。Articleには必須プロパティがなく、ローカルビジネスはnameとaddressが必須です。
  • 推奨プロパティは、数を増やすよりも正確に埋めるほうが適しています。
  • マークアップが正しくても、リッチリザルトでの表示は保証されず、FAQのように機能自体がなくなることもあります。
  • 構造化データは検索結果の表示方法に関わるデータであり、順位を上げるための仕組みではありません。
JSON-LD スキーマ ジェネレーター

インストールや会員登録は不要で、ブラウザ内ですぐに生成できます。入力した内容はサーバーに送信されません。

よくある質問

JSON-LDはheadとbodyのどちらに置けばよいですか?

Googleのドキュメントでは、JSON-LDを<head>と<body>要素の中の<script>タグに記述する方法として説明されています。どちらに置いても読み取られます。同じドキュメント内で後からJavaScriptで挿入したJSON-LDも読み取れるとされており、テンプレートを直接編集しにくい環境でも対処する方法があります。

マークアップを入れると検索順位は上がりますか?

構造化データは順位ではなく、検索結果の表示方法に関わるデータです。Googleのドキュメントでは、構造化データに対する手動措置について「リッチリザルトとして表示される対象から外れるだけで、ウェブ検索でのページの順位には影響しない」と説明されています。また、正しくマークアップしてもリッチリザルトでの表示は保証されないとも明記されています。

FAQのマークアップはもう不要ですか?

Google検索のFAQリッチリザルトは、2026年5月7日から表示されません。ただしFAQPageは今も有効なschema.orgのタイプであり、マークアップを残しておいても問題はありません。Google検索でFAQのアコーディオンとして表示されることを期待して入れるのであれば、現時点ではその効果はないと考えてよいでしょう。

フォームに入力した内容はサーバーに送信されますか?

いいえ。このツールのJSON-LD生成はすべてブラウザ内で行われ、入力したタイトル・住所・電話番号などの値がサーバーに送信されたり保存されたりすることはありません。空欄の項目は結果のJSONから自動的に除外されるため、入力した項目だけがそのままコードに残ります。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. ロト6/45 組み合わせ数と固定数字・除外数字の計算方法ロト6/45の全組み合わせ8,145,060通りを数式で確認し、固定数字と除外数字を指定したときに組み合わせが何通りに絞られるかの計算式と、偏りなく番号を選ぶFisher-Yatesシャッフルの仕組みを解説します。
  2. MACアドレスとは?ランダムMACがWi-Fi追跡を防ぐ仕組みMACアドレスは本来、機器ごとに変わらない固有値のため、複数のWi-Fiをまたぐと追跡の手がかりになります。ランダムMACアドレスが接続のたびに別のアドレスを見せる仕組みを解説します。
  3. og:descriptionとメタディスクリプションの違いと確認方法検索結果に出るメタディスクリプションと、SNS共有カードのog:descriptionは別のタグです。3つのタグの役割の違いと、ページソースやツールで実際に確認する方法をまとめました。
  4. パスフレーズとは?エントロピー計算でパスワード強度を比較パスフレーズとは何かを整理し、短く複雑なパスワードと長い単語の組み合わせを実際の数値で比較します。桁数と場合の数を累乗で掛けるエントロピー計算の考え方も解説します。
  5. パスワードは何桁が安全?8桁と12桁は組み合わせが2.6兆倍英小文字8桁で約2,088億通り、大文字・小文字・数字・記号の12桁で約5,403垓通り。総当たり攻撃への強度を計算式で比べ、必要な長さと文字種の目安をまとめました。
  6. 画像のCLS対策、プレースホルダーでレイアウトずれを防ぐ画像が遅れて読み込まれたときに画面が急にずれるCLSの原因と、サイズを先に合わせたプレースホルダー画像でレイアウトのずれを防ぐ方法を説明します。

関連ツール