初めてクライアントサイトにスキーママークアップを追加したとき、私は手入力で a Product テーマヘッダーにブロックし、展開し、賢い気分で移動しました。 2週間後、リッチ結果テストでは、オファーオブジェクトが欠落していると報告されました @type、価格はgoogleが文字列を望んでいた数字で、迷走した末尾のカンマがブロック全体を静かに無効化していました Googleは、ずっとそれを無視していました それは誰も構造化データで警告しないことです: 無効なJSON-LDはエラーを投げたり、赤くしたりすることはなく、ただ黙って何もしないだけで、数ヶ月後にあなたが期待していた豊かな結果が決して表示されないときにわかります。
語彙自体は、で公開されています schema.org、そしてGoogleが実際に豊富な結果を示すのは、その中のより狭いリストです 構造化データドキュメント。
私は生活のためのツールを構築します - Toolz.dev、WP Adminifyプラグイン、LaravelとReactアプリのスタック - そして構造化データは、私が手でそれをやって再送するのに十分な頻度で、毎回正確なプロパティ名を忘れるほどめったにないタスクの1 つだったので、構築しました スキーマ マークアップ ジェネレーター 最もコストがかかった 2 つの障害モード、つまり間違ったネストとサイレント無効を削除するには。このガイドでは、スキーマ マークアップが実際に何を行うのか、ジェネレーターがどのようにマークアップを構築するのか、有効に見えるマークアップが豊富な結果を得るのを妨げる特定の間違いについて説明します。
tl;dr: スキーママークアップは、検索エンジンにページの内容を正確に伝える構造化データ (schema.orgの語彙を使用) であり、FAQアコーディオン、製品価格、パンくずなどの豊富な結果の対象となります。 GoogleはJSON-LD形式を推奨しています - 自己完結型
<script type="application/ld+json">ブロック。ジェネレーターは、9 つの一般的なタイプに対して有効な JSON-LD を構築し、次のようなサブオブジェクトをネストしますPostalAddressあんどOffer正しく、必須フィールドと推奨フィールドが欠落しているフラグを立て、ブラウザで 100% 実行されるため、入力した内容はアップロードされません。
スキーママークアップとは何ですか?なぜそれが重要なのでしょうか?
スキーママークアップは、ページの内容を標準化して記述する方法で、レンダリングするだけでなく、マシンがそれを理解できるようにするものです。 vocabulary は、Google、Microsoft、Yahoo、Yandex が支援する共有プロジェクトである schema.org から取得されます。 page を としてマークアップすると、 Article、あなたは、検索エンジン"を伝えている; これは、ニュースやブログの記事です, ここにその見出しです, ここが誰がそれを書きました, ここが公開されたとき." その構造化された説明は、豊富な結果のためのページに適格なものです - 星評価で強化されたリスト, 価格, FAQドロップダウン, イベントの日, そして、ブレッドクラムのトレイルは、より多くのスペースを取り、プレーンブルーのリンクよりも多くのクリックを獲得します。
重要な理由はここ数年で変わりました.以前は純粋にGoogleでの豊富な結果に関するものでした.今では構造化データはAIアンサーエンジンやGoogle' s AIの概要にもフィードします.ChatGPT、Perplexity、またはGeminiがあなたのビジネスが何をしているか、またはどの製品がクエリに一致しているかを要約しようとすると、クリーンな構造化データは、彼らが事実を正しく理解するのに役立つ信号の一つであると明確に宣言するページです Organization 名前、ロゴ、ソーシャル プロファイルを使用すると、HTML に暗黙的にすべてを残すマシンよりも、どのマシンでも推論するのがはるかに簡単です。
キャッチは構造化データが容赦ないことです.それはコードであり,コードは正確に正しくなければなりません.綴られたプロパティ datePublish 代わりに datePublished は単に無視される。 an Offer without an @type はオファーとして認識されません。 そして、これらの間違いはどれも目に見えるページを壊さないため、無期限に本番環境に隠れます。それがジェネレーターが埋めるギャップです。概念を書くのではなく、構文と構造を毎回正しく理解します。
なぜMicrodataやRDFaではなくJSON-LDなのか?
schema.org データをページに追加するには 3 つの方法があり、ジェネレーターがそれらのうちの 1 つだけを生成する理由を理解するのに役立ちます。
マイクロデータ あんど RDFa 追加の属性を使用して、構造化データを目に見える HTML に直接織り込みます - itemscope、 itemprop、 property、 などなど。 あなたの <div> 製品レビューの場合、目に見えるテキストの各部分にラベルを付ける属性が得られます。これは機能しますが、マークアップとページ構造が密接に結合されます。レイアウトを変更すると、スキーマが壊れる危険があります。冗長で読みにくいです。
JSON-LD 逆のアプローチをとります 構造化されたデータをすべて 単一の自己完結型に <script type="application/ld+json"> ブロック、通常は <head>、目に見えるHTMLから完全に分離します。 googleは、まさにこの分離のためにjson-ldを何年も推奨してきました: あなたはそれを追加したり、更新したり、テンプレートに触れることなくタグマネージャを介して注入したり、すべての現代のスキーマチュートリアルが教える形式であり、それはジェネレータが出力するものです。
| フォーマット | 住んでいる場所 | メンテナンスの容易さ | Google'sスタンス |
|---|---|---|---|
| JSON-LD | シングル <script> ブロック、HTMLとは別 |
最も簡単 - 1 ブロックを編集します | おすすめ |
| マイクロデータ | 見えるHTMLの中の属性 | より硬い - レイアウトに結合されています | 対応 |
| RDFa | 見えるHTMLの中の属性 | より硬い - レイアウトに結合されています | 対応 |
WordPress で作業している場合、JSON-LD はほとんどの SEO プラグインが挿入するものでもあり、WP Adminify のようなツールがクリーンに並んでいるものでもあります。スタンドアロン ブロックであるため、ここで生成して、フレームワーク固有の体操を行わずにカスタム HTML フィールド、タグ マネージャー、または Laravel Blade レイアウトに貼り付けることができます。
スキーママークアップジェネレーターはどのように使用すればよいですか?
ワークフローは、タイプを選択して短いフォームに記入することを中心に構築されており、ライブ プレビューを使用して、入力時に JSON-LD アセンブリを確認できます。
ステップ 1 - スキーマ タイプを選択します。 組織、localbusiness、website、記事、製品、faqpage、breadcrumblist、人物、またはイベントから選択します。フォームはすぐにニーズを入力するフィールドに切り替わります。これら 9 つは、中小規模のサイトが実際にマークアップを必要とする圧倒的多数をカバーしています。
ステップ 2 - フィールドに入力します。 必須フィールドにはアスタリスクが付いています。入力すると、ツールは JSON-LD を組み立て、空白のままにしたフィールドをドロップするため、空になることはありません "" 出力を汚染するプロパティ。 localbusiness や Event などのアドレスベースのタイプの場合、個々のアドレス フィールドは適切に型付けされたものに折りたたまれます PostalAddress オブジェクト 自動的に.
ステップ 3 - 検証を確認します。 ジェネレータは2 種類の問題にフラグを立てます エラー (必須フィールドがない、URLが正しく形成されていない) はクリーンな結果をブロックし、赤で表示されます 警告 (Googleが推奨するフィールドがないなど) image や datePublished、またはプレースホルダーが欠落している検索 URL テンプレートが琥珀色で表示されます - マークアップはまだ有効ですが、テーブル上にリッチ結果の可能性を残しています。
ステップ4 - コピーして展開します. 満員切替 <script> タグ (すぐに貼り付けられます) <head>)と生のJSON(タグマネージャとCMSフィールドの場合)。 script出力は、そうでなければ迷走させる文字をエスケープします </script> データでページを壊します。その後、google's リッチ結果テストでライブ ページを検証します。
すべてがクライアント側で実行されるため、これは未公開の製品ページ、ステージング環境、およびNDAの下でのクライアント作業で安全に使用できます。 価格、イベントの詳細、内部URLはブラウザから離れることはありません - サイト上のすべてのツールの背後にある同じプライバシースタンスについて、私はそれについて書きました データ プライバシー ガイド。
実際に使うべきスキーマタイプは?
すべてのページにマークアップが必要なわけではなく、サポートできないタイプを積み重ねることは、何もしないことよりも悪いことです。ジェネレーターがカバーする 9 つについて私が考える方法は次のとおりです。
組織 あなたのホームページまたは約ページに属します。これはナレッジ パネルをフィードし、Google があなたのブランドをソーシャル プロファイルに接続するのに役立つスキーマです sameAs。 ウェブサイト それとペアになり、a を通じて Sitelinks 検索ボックスを宣言できます SearchAction、ユーザーが結果ページからサイトを直接検索できるようにします。 ローカルビジネス 物理的な場所がある場合は不可欠です。住所、電話、価格帯、営業時間が記載されており、ローカル パックと地図の結果を支えています。
条項 (ジェネレーターが一緒に放出するもの) Article type は、ブログ投稿にも同様に有効で、編集コンテンツに見出し、著者、発行者、発行日をマークアップします。 製品 ネストされた販売中のものについて説明します Offer 運送価格、通貨、可用性 - これが価格と可用性の断片を強化するものです。 イベント カンファレンスからウェビナーまで、日付と場所を含むあらゆるものをカバーします。
FAQページ あんど パン粉リスト "thing." についてではなく構造的です。 FAQPage は質疑応答のコンテンツをマークアップします。Google は FAQ の豊富な結果を権威ある政府サイトや健康サイトに絞り込んだことに注意してください。ただし、マークアップは他の検索エンジンや AI 回答エンジンがあなたの Q&A を解析するのに役立ちます。 BreadcrumbList は、あなたのタイトルの下に表示されるパンくずの痕跡を結果に生成するため、URL 構造の読み取り方法が改善されます。 人物 著者、創設者、著名人などの個人をマークアップし、著者の経歴や EEAT シグナルに役立ちます。
私が従うルール: ページが本当に何であるかをマークアップし、ページに実際に表示されるコンテンツを反映するプロパティのみを主張します。 Google' のガイドラインでは、構造化データは実際の目に見えるコンテンツを記述する必要があることが明示されています。ページに表示されない価格をマークアップすることは違反であり、ショートカットではありません。
ジェネレータはどのようにマークアップを有効に保ちますか?
値は、手で間違えやすい詳細にあります。 呼び出す価値のあるいくつか。
との正しいネスト @type。 JSON-LD では、ネストされたオブジェクトは単純なサブオブジェクトではなく、それぞれに独自のサブオブジェクトが必要です @type。 アドレスは a です PostalAddress、 オファー は 、 Offer、記事& #39; sの著者はaです Person、その発行者は、 Organization ロゴは です ImageObject。ジェネレーターはこれらすべてを適切な型で構築するため、パーサーはそれらを匿名の BLOB として扱うのではなく認識します。
剪定が空になります. フィールドを空白のままにすると、プロパティは削除されるはずで、emit は削除されません "telephone": ""。空の文字列と空の配列は出力から自動的に削除されるため、コピーしたものは常にクリーンになります。
スクリプトセーフなエスケープ. インライン JSON-LD の最も危険な文字は a です < ー具体的にはシーケンス </script> データの中に表示され (たとえば、説明文で) 、 スクリプトブロックを早期に終了させ、ページを壊すことになります ジェネレータはエスケープします <、 >、そして & unicode エスケープを使用したスクリプト タグ出力では、まさに Google' 自身の例がそれを行います。
必須および推奨される認識. 各タイプには、Google が必要とするものと推奨するものの独自のリストが含まれています。記事は本当に欲しいものです image あんど datePublished;製品はaを望んでいます price;イベントには a が必要です startDate.ツールは、ハード要件を区別 (それはエラーとして扱う) 勧告 (警告), だから、あなたは間の違いを知っています " これは動作しません " と " これは、より良い動作することができます."
より広範な技術ワークフローを組み立てている場合、スキーマ ジェネレーターは他の SEO ユーティリティ (the) と自然に並んで配置されます メタ タグ ジェネレーター タイトル、説明、Open Graph タグ、および XML サイトマップ ジェネレーター URL を送信するため。これらはページ上のテクニカル SEO サーフェスの大部分をカバーしており、そのために URL をグループ化しました web開発者ツールキットの概要。
構造化データをテストしてデプロイするにはどうすればよいですか?
有効な JSON-LD を生成することは仕事の半分です。残りの半分は、Google が意図したとおりに JSON-LD を読み取ることを確認することです。
Google'sから始めます リッチ 結果 テスト、URLをフェッチするか、またはページが修飾される豊富な結果タイプ、加えて、任意のエラーや警告をレポート貼り付けられたコードとレポートを受け入れる。 その後、を通じて同じマークアップを実行します スキーママークアップ バリデータ google's rich-result の要件ではなく、schema.org の語彙自体への適合性をチェックする validator.schema.org では、この 2 つは異なる点を捉えます。 rich Results Test では、特定の Google 機能の対象となるかどうかが示され、validator ではマークアップが構造的に健全な schema.org であるかどうかが示されます。
ページがライブになると、機能強化がレポートされます Google 検索 コンソール 時間の経過とともにパフォーマンスを追跡し、クロール中に Google が見つけたエラーにフラグを立てます。ここで、大規模な場合にのみ表示される問題をキャッチします。たとえば、パンくずの位置が重複して表示されるテンプレートや、必要なフィールドが時折省略される製品フィードなどです。
展開するには、 を貼り付けます <script> ブロックインザ <head> 説明されている特定のページのうち。 すべてのページで実行されるグローバルテンプレートに単一のProductブロックを入れないでください - マークアップは、それが住んでいるページと一致する必要があります.CMSでは、プラットフォームが与えるカスタムHTMLまたはSEOフィールドを使用してください.タグマネージャでは、カスタムHTMLタグを使用してJSONをコピーします.ReactまたはLaravelアプリでは、ブロックサーバー側を挿入して、クローラーが水分補給後ではなく最初のHTMLでブロックを確認できるようにします。
よくある間違いは今でも目にします
いくつかのエラーが何度も表示され、どれも正常に見えるが何も行わないマークアップを生成します。
クラシック は 目に見えないコンテンツのマーキング ー ページのどこにも表示されないレビュー評価や価格を追加する Googleはこれを明示的に禁止しており、それに対して手動のアクションを発行することができます。 2 つ目は ネストされたオブジェクトで間違った型、 通常は行方不明 @type 住所やオファーについてです 3つ目は 類似したタイプを混同する、 使用 ように Product 単一の商品ではなく、カテゴリーリストページにマークアップします。 そして4つ目は、私の個人的な宿敵です 手編集による構文エラー - ブロック全体を無効にする末尾のカンマまたはエスケープされていない引用符。
これらの1 つすべてが、ジェネレータがそのキープを獲得する理由です。 あなたの価格がページ上に表示されているかどうかを知ることはできません - それはあなたにあります - しかし、それは後続のコンマ、欠落を決して発しません @type、または空のプロパティ。 それだけで、構造化データがサイレントに失敗する方法のほとんどが削除されます。この種のツールに関する開発者ワークフローの背景をより深くするには、 コーディング ツール ガイド 良い相棒です。
よくある質問
スキーママークアップとは何ですか?
スキーママークアップは、共有スキーマ.org語彙を使用して検索エンジンにpage& #39; sのコンテンツを記述する構造化データです。これを追加すると、FAQアコーディオン、製品価格、レビュースター、パンくずなどの豊富な結果の対象となるページを作成できます。このツールが生成する形式である JSON-LD は、表示されている HTML とは別の単一のスクリプト タグに住んでいるため、Google が推奨する構文です。
JSON-LD、Microdata、RDFA の違いは何ですか?
3 つすべてが、Schema.org 構造化データをページに追加する方法です。 マイクロデータと RDFA は、目に見える HTML に織り込まれた属性であり、JSON-LD はスクリプト タグ内の JSON の自己完結型ブロックです。 JSON-LD の方がページのマークアップからの追加、更新、分離を簡単にするため、Google が推奨しています。 このツールは、そのため JSON-LD を出力します。
生成された JSON-LD はどこに置くのですか?
まるまる貼り付けます <script type="application/ld+json"> タグを付けて <head> 説明されているページ、またはページ内のどこか <body> ー Googleはどちらの場所でも読みます Google Tag Managerを使う場合は JSONをコピーして Custom HTMLタグを通して追加します マークアップは必ずどこにでも適用するテンプレートではなく、その内容が記述されている同じページに置きます。
スキーマ マークアップを追加すると、豊富な結果が保証されますか?
いやー 有効な構造化データにより、ページは豊富な結果に対応できますが、品質、関連性、および独自のガイドラインに基づいて、それらを表示するかどうかが Google によって決定されます。 マークアップには、ページに実際に表示されるコンテンツも反映する必要があります。 スキーマは、リッチな結果の要件であり、それらをオンにするスイッチではなく、必要なものと考えてください。
構造化データをテストするにはどうすればよいですか?
生成されたマークアップをGoogle& #39; s リッチ結果テストとスキーママークアップバリデータ (schema.org& #39; s validator) を通じて実行します。 json-ldを解析し、必須フィールドまたは構文エラーの欠落を報告します。ページがライブになった後、Google Search Consoleの機能強化レポートは、構造化データが時間の経過とともにどのように実行されるかを追跡します。
タイプごとに必要なフィールドは何ですか?
要件はタイプによって異なります。記事には見出しが必要、製品には名前が必要、イベントには名前と開始日が必要、FAQPage には少なくとも 1 つの質問と回答が必要です。 このツールは、必須フィールドをマークし、入力がいっぱいになるまでブロック出力をブロックします。また、リッチな結果を得る可能性を高める推奨フィールドについても警告します。
自分のページの FAQ スキーマを生成できますか?
はい。 FAQPage タイプを選択し、各質問にその答えを追加すると、ツールは、質問と回答オブジェクトのメイン エンティティ配列を自動的に構築します。 Google Now では、主に権威ある政府や健康サイトで FAQ が豊富に表示されますが、マークアップは引き続き有効で、他の検索エンジンや AI 回答エンジンにも有効であることに注意してください。
私のデータは非公開ですか?
はい。 JSON-LD は、プレーンな JavaScript を使用して完全にブラウザで組み立てられます。未公開の価格、イベントの詳細、プライベート URL など、入力したものは送信、ログ記録、保存されず、一度ロードされると、ジェネレーターはネットワーク接続なしで動作し続けます。
