スキーママークアップを編集 – Yext Help

スキーママークアップはページのコードに埋め込まれた構造化データで、検索エンジンやAIシステムがコンテンツを理解するのに役立ちます。サイトの各ページの <head> には、自動的にJSON-LDスキーマが含まれます。スキーマエディタを使用して、生成されたスキーマを確認およびカスタマイズすると、テクニカルSEOをより詳細に制御できます。

スキーマエディタにアクセスする

ページグループのレイアウトエディタに移動します。
ナビゲーション上部の [Pages] をクリックします。
[詳細設定] を選択します。

デフォルトスキーマ

場所ページグループには自動的に LocalBusiness スキーマが含まれます。デフォルトのテンプレートは次のようになります。

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "@id": "[[siteDomain]]/[[path]]",
  "name": "[[name]]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[[address.line1]]",
    "addressLocality": "[[address.city]]",
    "addressRegion": "[[address.region]]",
    "postalCode": "[[address.postalCode]]",
    "addressCountry": "[[address.countryCode]]"
  },
  "openingHours": "[[hours]]",
  "image": "[[photoGallery]]",
  "description": "[[description]]",
  "telephone": "[[mainPhone]]",
  "paymentAccepted": "[[paymentOptions]]",
  "hasOfferCatalog": "[[services]]"
}

ディレクトリおよびロケーターのページグループは、それぞれのページタイプに特有のスキーマを含みます。

スキーマテンプレートを編集する

スキーマテンプレートは、Knowledge Graphのフィールドプレースホルダーを使用して、各ページの構造化データに動的にエンティティ固有の値を挿入します。

フィールドプレースホルダー構文：Knowledge Graphのフィールドを参照するには二重括弧表記を使用します。

"name":"[[name]]",
"telephone":"[[mainPhone]]",
"streetAddress":"[[address.line1]]"

システムはページを生成する際にこれらのプレースホルダーを実際のエンティティ値に置き換えます。

フィールドピッカー：フィールドAPI名を手動で入力する代わりに、エディタのフィールドピッカードロップダウンを使用して、Knowledge Graphで表示される同じ名前のフィールドを参照および挿入します。フィールドを選択したら、正しいAPI名がテンプレートに自動的に挿入されます。

nullフィールド処理：Knowledge Graphフィールドが空またはnullの場合、そのキーと値のペアは最終的なスキーマ出力から自動的に省略されます。手作業による処理は不要です。

テンプレートのカスタマイズ： 必要に応じて、スキーマテンプレートを変更できます。

ビジネスタイプに合わせて @type を変更する
schema.orgのプロパティを追加する
エンティティに適用されないプロパティを削除する

重要：スキーマテンプレートはページグループのすべてのページに適用されます。無効なスキーマは検索結果の表示に影響を与える可能性があるため、変更を公開する前に以下の検証ツールを使用してください。

スキーマの自動追加

システムは各ページに対し、2つの追加のスキーマを自動的に追加します。

BreadcrumbList — ナビゲーション用のページ階層を表示します
AggregateRating — 利用可能な場合、レビューの平均点を表示します

これらの追加内容は最終的なページ出力に含まれますが、現時点ではスキーマエディタには表示されません。今後のアップデートで参照用に表示される予定です。

編集したテンプレートと自動追加された要素は、ページ <head> の @graph 配列に結合されます。

<script type="application/ld+json">
  {
    "@graph": [
      {
        /* Your edited LocalBusiness schema */
      },
      {
        /* Automatic BreadcrumbList schema */
      },
      {
        /* Automatic AggregateRating schema (if applicable) */
      }
    ]
  }
</script>

スキーマの検証と管理

スキーマエディタは、エディタメニューに2つの検証ツールと追加オプションを提供します。

JSON検証：エディタは保存前にJSON構文を検証します。無効なJSON形式のテンプレートは保存できません。

テンプレート / プレビュートグル：生のスキーマテンプレートと、特定のエンティティの実際のエンティティ値が入力されたプレビュー間を切り替えます。公開前にプレビュー機能を使用して、フィールドのプレースホルダーが正しく解決されていることを確認します。

エディタメニューには次の3つのオプションがあります。

Googleリッチリザルトでテスト — Googleのリッチリザルトテストでスキーマを開き、スキーマが有効で、Google検索のリッチリザルトの対象であることを確認します。
スキーマのベストプラクティスを確認 — schema.orgのガイダンスを開くと、スキーマを正しく構成および拡張する方法を確認できます。
デフォルトのスキーマにリセット — このページグループタイプのテンプレートを元のデフォルトに戻します。編集作業でエラーが発生し、最初からやり直したい場合にこれを使用します。

注意：スキーマの変更はローカルに保存され、レイアウトエディタで公開をクリックするまで反映されません。