スコープ別の JSON-LD の例

JSON-LD ルールは、ページのメタタグがサポートする任意の範囲で作成できます。各スコープは、異なるデータを${...}トークンに公開します。引用符を囲まずにトークンを入力します。B2C Commerce では、解決された各値が JSON 文字列としてクォートされます。各スコープで使用できるオブジェクトと演算子の完全なリストについては、「メタタグの構文」を参照してください。

これらの例では、いくつかの商品、カテゴリ、コンテンツ、およびサイト属性を含む一般的な Schema.org タイプを使用しています。カタログとコンテンツに合わせて属性を調整し、出力を検証します。

商品詳細ページ

ページ上の商品の商品を発行します。

{
    "@context": "https://schema.org",
    "@type":"Product",
    "name": ${Product.name},
    "brand": ${Product.brand},
    "offers": {
        "@type":"Offer",
        "price": ${ProductPrice.min},
        "priceCurrency": ${ProductPrice.currency}
    }
}

商品一覧ページ

カテゴリのCollectionPageを出力します。ルールは 1 つのオブジェクトに対して解決されるため、ページに各商品をリストするのではなく、カテゴリを記述します。

{
    "@context": "https://schema.org",
    "@type":"CollectionPage",
    "name": ${Category.displayName},
    "url": ${OriginalRequestURL}
}

コンテンツ詳細ページ

ページ上のコンテンツアセットに対して記事、または別の適切なタイプを出力します。

{
    "@context": "https://schema.org",
    "@type":"Article",
    "headline": ${Content.name},
    "url": ${OriginalRequestURL}
}

コンテンツ一覧ページ

コンテンツ フォルダーのCollectionPageを出力します。

{
    "@context": "https://schema.org",
    "@type":"CollectionPage",
    "name": ${Folder.displayName},
    "url": ${OriginalRequestURL}
}

ホームページ

ストアフロントのWeb サイトを出力します。

{
    "@context": "https://schema.org",
    "@type":"WebSite",
    "name": ${Site.displayName},
    "url": ${OriginalRequestURL}
}

演算子によるフォールバック

解決されたコンテンツが有効な JSON でない場合、B2C Commerce ではブロック全体が省略されます。ELSE演算子を使用して、トークンが空で解決できるときに常に存在する値にフォールバックします。商品のローカライズされた名前は、一部の地域情報では空にすることができますが、その ID は常に設定されるため、名前の安全なフォールバックProduct.ID。

{
    "@context": "https://schema.org",
    "@type":"Product",
    "name": ${Product.name ELSE Product.ID},
    "offers": {
        "@type":"Offer",
        "price": ${ProductPrice.min},
        "priceCurrency": ${ProductPrice.currency}
    }
}

正確なデータのフォールバックを選択します。すべてのケースで正しいことが確実でない限り、定数のブランド名などのプレースホルダーを置き換えないでください。演算子は値を置換しますが、"key": 値行とその末尾のコンマ全体を削除するわけではないため、純粋に省略可能なフィールドの場合は、値を作成するのではなく、テンプレートから除外します。