詳細情報:
Google の商品フィードフィールドリファレンス
必須フィールド、オプションフィールド、B2C Commerce 属性へのデフォルトのマッピングなど、Google で使用される商品フィードフィールドの参照情報。
デフォルトマッピングの仕組み
Google の商品フィードは、データ駆動型のマッピングシステムを使用して、B2C Commerce の商品データを Google が必要とする形式に変換します。B2C Commerce で標準の B2C Commerce 属性を使用して値を導き出すことができる場合、値の導き方を指定するデフォルトのマッピングが作成されます。
- フィールドマッピング :1 つの B2C Commerce 商品属性 ( 名前、ブランド、価格など) に直接マッピングします。
- 派生マッピング :複数の属性から値を計算するか、説明から HTML を削除したり、通貨コードで価格を書式設定したりするなどの変換を適用します。
- 定数マッピング :すべての商品に固定値を使用します。
- フォールバックマッピング :最初に主要属性にマッピングし、その商品の主要属性が空の場合は別の属性にフォールバックします。たとえば、titleはnameを使用し、nameが空白の場合はmasterProductNameにフォールバックします。
上書き可能としてマークされたフィールドをカスタマイズできます。Business Manager ではい。上書き可能としてマークされたフィールド:いいえはシステムで管理され、フィールド マッピング テーブルに表示されますが、マッピングを変更することはできません。
フィールドの自動書式設定
B2C Commerce では、フィールド値がフィードに書き込まれる前に、自動書式設定が適用されます。この書式設定は、デフォルトのマッピングを保持するか、別の属性で上書きするかに関係なく行われます。デフォルトのマッピングを上書きする場合、カタログデータを Google の形式に合わせる必要はなく、B2C Commerce によって変換が処理されます。
書式設定は次のように適用されます。
- 開催期間 :日付と日時の値は ISO 8601 にフォーマットされています。無効な日付はフィードから省略されます。
-
ブール値 :値は
trueまたはfalseに変換されます。 - 数字 :数値は、必要な精度に書式設定されます (たとえば、小数点のない整数や、価格の場合は小数点以下 2 桁など)。無効な値または null 値は省略されます。
- 料金 :正の値は小数点以下 2 桁まで書式設定され、通貨コードと連結されます。
- 説明:HTML タグはテキストから取り除かれます。
- 列挙型 :入手可能性やage_groupなどの値は、事前定義された許容値に対して検証されます。
バリアントのカスタム属性の継承
カスタム属性を Google フィールドにマッピングすると、B2C Commerce では以下の継承チェーンを使用してバリアント商品の属性値が自動的に解決されます。
- バリアント商品 :B2C Commerce では、まずバリアント商品の属性値がチェックされます。
- バリエーショングループ :バリアントに属性値がない場合は、バリエーショングループがチェックされます (該当する場合)。
- マスター製品 :バリエーショングループにこの値がない場合は、マスター商品がチェックされます。
この継承チェーンにより、マスターレベルまたはバリエーショングループレベルで定義されたカスタム属性が、重複したデータ入力を必要とせずにバリアントによって自動的に継承されます。
対象商品
次の 2 つのレイヤーによって、フィードに表示される商品が制御されます。
- 商品フィルタールール :設定可能な含めるルールと除外するルールで、どの商品を Google に送信するかを決定します。デフォルトでは、ルールはオンラインで検索可能な商品と一致しますが、調整できます。商品フィードの商品フィルタールールを参照してください。
-
自動除外:フィルタールールにかかわらず、B2C Commerce では常に次の商品がフィードから除外されます。
- マスター商品 (代わりにバリアントがエクスポートされます)
- バリエーショングループ (代わりにバリアントはエクスポートされます)
- 商品セット。固定コンポーネントを含むバンドルはサポートされており、スタンドアロン商品として Google に送信されます。
商品がフィードに追加された後は、included_destination、excluded_destination、一時停止の各フィールドをマッピングすることで、Google での商品の表示場所をさらに制御できます。たとえば、excluded_destinationを使用すると、商品を無料リスティングに送信しながら、ショッピング広告に表示されないようにすることができます。「オプション フィールド」の表を参照してください。
定価導出
価格フィールドは、商品の通常 (定価) にマッピングされます。B2C Commerce には「定価」という概念は組み込まれていません。ストアフロントチームは、さまざまな価格表戦略を使用して定価を実装します。このような多様性に対応するため、B2C Commerce ではフィードの定価が 2 つのステップで導き出されます。
- 選択されたリスト価格表。全般設定タブの定価表で価格表を選択すると、B2C Commerce はその価格表の価格を使用します。ドロップダウンには、フィードの通貨で価格が設定されているアクティブな価格表のみが含まれます。選択した価格表を後で非アクティブにする場合は、別の価格表を指すようにリスト価格表を再構成します。
-
セール価格表の経路。定価表を選択しない場合、B2C Commerce は、B2C Commerce 価格エンジンが商品に対して選択するセール価格表から定価を導き出します。価格エンジンでは、アクティブな価格表だけでなく、商品に適用可能なすべての価格表が評価され、最適な (最低の) 価格とソースの価格表が返されます。B2C Commerce では、そのセール価格表から、以下の 2 つのルールのいずれかが適用されます。
- セール価格表に上位価格表がある場合、B2C Commerce は親チェーンをルートまでたどり、ルート価格表から価格を返します。これは、SFRA および SiteGenesis ストアフロントのデフォルト動作と一致します。
- セール価格表に上位価格表がない場合、B2C Commerce は商品に該当するすべての価格表の最高価格を返します。これは、PWA Kit ストアフロントの既定の動作と一致します。
全般設定タブで定価を設定することは、フィードの定価をストアフロントで買い物客に表示される価格と一致させるための最も信頼性の高い方法です (特に、カスタム価格ロジック、ゾーンベースの価格設定、または複数通貨の価格表を使用するストアフロントの場合)。
販売価格の導出
sale_priceフィールドは、B2C Commerce のsalePrice属性に構成された通貨を加算したものにマッピングされます。salePriceの値は 1 つの価格表から取得されません。価格表の階層や階層が構成されているかどうかにかかわらず、B2C Commerce 価格エンジンによって、商品に適用可能なすべての価格表の中から最適な (最低の) 価格が選択されます。
ストアフロントに表示される価格は同じエンジンによって入力されるため、Google に送信されるsale_price値は、サイトで買い物客に表示される値と一致します。
解決済みのセール価格が解決済みの定価 ( 価格フィールド) と等しい場合、B2C Commerce はその商品のフィードエントリからsale_priceを省略します。これにより、セールになっていない商品に取り消し線が付いた価格が Google に表示されるのを回避できます。定価誘導を参照してください。
ストアフロントでカスタム価格設定ロジック (ゾーンベースまたは地域ベースの価格表の選択など) を使用している場合、デフォルトのセール価格の計算が買い物客に表示される価格と一致しないことがあります。このような場合に、全般設定タブで定価表を設定することが、フィードをストアフロントに合わせる最も確実な方法です。
必須フィールド
有効な商品フィードエントリには、以下のフィールドが必須です。必須フィールドが欠落している商品はフィードに含まれますが、Google はそれらの個々の行を拒否する場合があります。商品フィードのプレビューを使用して、必須フィールドが欠落している商品を特定して修正してから、毎日のフィードの同期を有効にします。「商品フィードのプレビュー」を参照してください。
| グーグルフィールド | タイプ | デフォルトのSFCCマッピング | 説明 | オーバーライド可能 |
|---|---|---|---|---|
| id | string | id (商品 ID) | 一意の商品識別子(SKU)。B2C Commerce が管理します。フィードの更新を安定させます。 | なし |
| title | string | name、空白の場合はmasterProductNameにフォールバックします。 | 商品名。宣伝文は避けてください。 | あり |
| description | string | longDescription、空白の場合はshortDescription (HTML ストリップ) にフォールバック | 完全な製品説明。HTML タグは自動的に削除されます。 | あり |
| link | string | productUrl (生成済み) | 商品詳細ページ URL。Einstein 設定のホスト名を使用して生成されます。PWA Kit ストアフロントとヘッドレスストアフロントでは、URL パターンを別々に設定します。「商品フィードの URL パターンを構成する」を参照してください。 | あり |
| image_link | string | 選択した画像の表示タイプ、またはデフォルトの表示タイプのルックアップ | メインの商品画像の URL。「全般設定」タブの「画像の表示タイプ」で表示タイプを選択すると、B2C Commerce ではその表示タイプが使用されます。それ以外の場合、B2C Commerce は「large」表示タイプを試行し、最初に使用可能な表示タイプにフォールバックします。フォールバックでは不適切な表示タイプ (スウォッチビューなど) が選択される可能性があるため、Salesforce では特定の表示タイプを選択することをお勧めします。プロモーション用のオーバーレイのない高解像度の画像を使用します。 | あり |
| 入手可能性 | string | 入手可能性 (派生) | 在庫状況。B2C Commerce の在庫レベルを Google の入手可能性の値にマッピングして得られた値: in_stock、out_of_stock、予約販売、取り寄せ。システムによって管理されます。 |
なし |
| price | number | 価格と通貨の組み合わせ (選択されたリスト価格表、または sale-price-book 経路) | 通貨コード付きの通常 (リスト) 商品価格 (例: "15.00 USD")。全般設定タブの定価表で価格表を選択すると、B2C Commerce ではその価格表が使用されます。それ以外の場合、B2C Commerce は B2C Commerce 価格エンジンによって選択されたセール価格表から定価を導き出します。定価誘導を参照してください。正の値のみが含まれます。 | あり |
省略可能なフィールド
以下のフィールドは任意であり、Google での商品リスティングを充実させることができます。オプションのフィールドは、マッピングされた属性または定数値が空白の場合、フィードから省略されます。デフォルトのマッピングを持つフィールドは、その値を自動的に導出します。デフォルトマッピングのないフィールド(「(なし)」と表示)は、属性をマッピングするか、定数値またはパターンを設定した場合にのみ入力されます。
| グーグルフィールド | タイプ | デフォルトのSFCCマッピング | 説明 | オーバーライド可能 |
|---|---|---|---|---|
| sale_price | number | セール価格がアクティブな場合は、salePriceと通貨を組み合わせます | 「10.00 USD」などの通貨コードを使用した割引価格。解決済みのセール価格が解決済みの価格と等しい場合、B2C Commerce ではこのフィールドが省略されます。販売価格の誘導を参照してください。 | あり |
| sale_price_effective_date | 日付 | salePriceStartとsalePriceEndを組み合わせます。 | 「2016-02-24T11:07+0100/2016-02-29T23:07+0100」などの ISO 8601 形式のセール価格の日付範囲。 | あり |
| availability_date | 日付 | inStockDate (在庫日) | 予約販売商品が入手可能になる日付 (例: "2016-02-24T11:07+0100")。 | あり |
| expiration_date | 日付 | onlineTo (onlineTo) | 商品がフィードに表示されなくなる日付 (例: "2016-07-11T11:07+0100")。 | あり |
| brand | string | brand | ブランド名。 | あり |
| gtin | string | ean、EAN が使用できない場合はupcにフォールバックします。 | 国際取引商品番号 (UPC/EAN)。製品のマッチングを改善します。 | あり |
| MPNの | string | MPNの | メーカー部品番号。 | あり |
| identifier_exists | ブール値 | 商品に標準識別子 (EAN、UPC、MPN、またはブランド) があるかどうかから計算されます。 | 商品に標準識別子があるかどうかを示します。 | あり |
| is_bundle | ブール値 | bundleProductIdsが入力されるとtrueと評価されます |
商品がバンドルかどうかを示します。B2C Commerce が管理します。 | なし |
| item_group_id | string | masterProductId (マスター商品 ID) | "AB12345" など、同じマスター商品を共有する商品バリアントをグループ化します。 | あり |
| product_type | string | categoryPath (フルパス) | マーチャントが定義した商品カテゴリ (例: "Home > Women > Dresses > Maxi Dresses")。 | あり |
| google_product_category | string | (なし) | Google が定義した商品カテゴリ(例: 「アパレル & アクセサリー > 衣料品 > アウターウェア > コート & ジャケット」など)。 | あり |
| additional_image_link | string | 追加イメージリンク | よりリッチなプレゼンテーションのための追加の画像 URL。 | あり |
| lifestyle_image_link | string | (なし) | ライフスタイル画像の URL。 | あり |
| mobile_link | string | (なし) | モバイル向けに最適化されたランディング ページ URL。 | あり |
| virtual_model_link | string | (なし) | 仮想モデル(3D)アセットの URL。 | あり |
| ads_redirect | string | (なし) | 広告トラフィックのリダイレクトに使用される URL(トラッキング パラメーターを含む URL など)。 | あり |
| color | string | (なし) | 製品の色。 | あり |
| 素材 | string | (なし) | 「皮革」などの一次製品材料。 | あり |
| pattern | string | (なし) | 商品パターン (例: "水玉模様")。 | あり |
| size | string | (なし) | 商品サイズ (例: "XL")。 | あり |
| size_system | string | (なし) | サイズ システム("US" など)。 | あり |
| size_type | string | (なし) | 「レギュラー」などのサイズタイプ。 | あり |
| gender | string | (なし) | 対象とする性別(「男性」、「女性」、「ユニセックス」など)。 | あり |
| age_group | string | (なし) | 対象年齢層。値: 新生児、乳児、幼児、子供、大人。 |
あり |
| アダルト | ブール値 | (なし) | 商品が成人向けかどうかを示します。 | あり |
| コンディション | string | (なし) | 「新品」、「中古」、「再生品」などの商品の状態。 | あり |
| マルチパック | number | (なし) | マーチャントが定義したマルチパックに含まれる同一商品の数。 | あり |
| product_highlight | string | (なし) | 「何千ものアプリをサポート」などの主要な製品のハイライト。 | あり |
| short_title | string | (なし) | 「ポロシャツ」など、制約された配置で使用される短いタイトル。 | あり |
| structured_title | string | (なし) | AI 生成コンテンツ用の構造化されたタイトル (タイトルの出所を含む)。 | あり |
| structured_description | string | (なし) | AI が生成したコンテンツのための、説明の出所を含む構造化された説明。 | あり |
| custom_label_0–custom_label_4 | string | (なし) | 「季節限定」、「在庫一掃セール」、「ベストセラー」など、レポートと入札のために商品をセグメント化するために使用されるカスタムラベル。 | あり |
| product_length、product_width、product_height | number | (なし) | 単位付きの商品寸法 (例: "20 in")。 | あり |
| product_weight | number | (なし) | 商品重量 (単位付き) (「3.5ポンド」など)。 | あり |
| unit_pricing_measure | string | unitQuantity と unitMeasureを組み合わせます。 | 販売時の商品の寸法と寸法 (「1.5kg」など)。 | あり |
| unit_pricing_base_measure | string | (なし) | 価格設定の商品の基本メジャー ("100g" など)。 | あり |
| energy_efficiency_class | string | (なし) | エネルギー効率クラス (「A+」など)。 | あり |
| min_energy_efficiency_class | string | (なし) | 製品のラベルに記載されている最も低いエネルギー効率クラス(「A ++」など)。 | あり |
| max_energy_efficiency_class | string | (なし) | 製品のラベルに記載されている最高のエネルギー効率クラス(「D」など)。 | あり |
| 認証 | string | (なし) | 「EC:EPREL:123456」などの製品認証。 | あり |
| consumer_notice | string | (なし) | プロポジション 65 の警告などの消費者への通知。 | あり |
| cost_of_goods_sold | number | (なし) | 「8.00 USD」などの通貨コードを使用した売上原価。 | あり |
| auto_pricing_min_price | number | (なし) | 「15.00 USD」などの自動割引の最低価格。 | あり |
| maximum_retail_price | number | (なし) | 「15.00 INR」など、最大小売価格(インドなど一部の地域で使用)。 | あり |
| 分割払い | string | (なし) | 分割払いの詳細 (例: "6:30 EUR:199 EUR")。 | あり |
| subscription_cost | string | (なし) | サブスクリプションの費用の詳細 (例: "month:12:35.00USD")。 | あり |
| loyalty_program | string | (なし) | ロイヤルティプログラムの特典 (例: "my_loyalty_program:silver:10 USD::10::free_member_shipping)。 | あり |
| promotion_id | string | (なし) | プロモーション識別子 ("ABC123" など)。 | あり |
| shipping | string | (なし) | 「US:CA:Overnight:16.00 USD」などの配送料の詳細。 | あり |
| free_shipping_threshold | string | (なし) | 送料無料の最小注文金額 (例: "US:16.00 USD")。 | あり |
| carrier_shipping | string | (なし) | 配送業者が計算した配送料 (例: "US:80302:USPS_MEDIA_MAIL:1:3:2:5")。 | あり |
| shipping_label | string | (なし) | 配送ルールの割り当てに使用するラベル (例: "生鮮食品")。 | あり |
| shipping_length、shipping_width、shipping_height | number | (なし) | 配送料の計算に使用されるパッケージの寸法 (例: "22 in")。 | あり |
| shipping_weight | number | (なし) | 配送料の計算に使用されるパッケージの重量 (例: "3 kg")。 | あり |
| min_handling_time | number | (なし) | 最小商品出荷作業日数 (例: "1")。 | あり |
| max_handling_time | number | (なし) | 商品処理時間の上限 (例: "3")。 | あり |
| shipping_handling_business_days | string | (なし) | 「US:Mon-Sat」など、注文が処理される営業日。 | あり |
| shipping_transit_business_days | string | (なし) | 注文が輸送中の営業日 (例: "US:Mon-Sat")。 | あり |
| ships_from_country | string | (なし) | 商品の発送元の国。2 文字の ISO 3166 国コード ("US" など) を使用します。 | あり |
| return_policy_label | string | (なし) | 返品ポリシーの割り当てに使用するラベル (例: "90 日")。 | あり |
| included_destination | string | (なし) | 商品を含める必要がある宛先 ("Shopping_ads" など)。 | あり |
| excluded_destination | string | (なし) | 商品を除外する宛先 (例: "Shopping_ads)。 | あり |
| shopping_ads_excluded_country | string | (なし) | ショッピング広告から除外される国(「DE」など)。 | あり |
| ポーズ | string | (なし) | 「広告」などのリンク先で項目を一時停止します。 | あり |
| native_commerce | ブール値 | (なし) | 商品がネイティブ コマース(ストアフロントではなく Google の画面内で直接行われる購入体験)の対象かどうかを示します。このブール値を商品ごとに設定して、利用資格をコントロールします。このフィールドにはデフォルトのマッピングがないため、マッピングしない限り、商品に対象としてフラグが付けられることはありません。 | あり |
| external_seller_id | string | (なし) | 「SellerPublicName1991」など、複数の販売者アカウントの販売者識別子。 | あり |
| merchant_item_id | string | (なし) | マーチャント提供の注文手続きアイテム識別子 ("some_checkout_item_id_1" など)。 | あり |
追加のオプションフィールド (商品詳細)
[フィールド マッピング] 表の [ 追加のオプション フィールド ] セクションを使用して、技術仕様やその他の属性を Google のproduct_detailフィールドに送信します。各エントリについて、B2C Commerce 属性をマッピングし、オプションでセクション名を指定して、関連する詳細をグループ化します。「属性を追加」をクリックして、別の商品詳細を追加します。
product_detailフィールドは、他のフィールドではカバーされていない商品の側面について、読みやすく構造化された情報を買い物客に提供し、Google が検索や AI を活用したエクスペリエンス全体で商品を表示するのに役立ちます。使用できる属性とフォーマット要件の完全なリストについては、Google Merchant Center ヘルプの商品詳細 [product_detail]をご覧ください。
