Agentic Commerce Guides

Agentic Commerce Product Feedとは

更新日

Agentic Commerce Product Feed(商品フィード)は、ECサイトの商品情報をAIに渡すためのデータです。1行(JSONL では1レコード)が1商品で、商品ID・商品名・価格・在庫状態などを決められた列名と形式で書きます。ここでは OpenAI が公開している Product Feed 仕様(Stable) をもとに説明します。

ファイル形式

  • CSV・TSV・JSONL を UTF-8 で作成します。gzip 圧縮(.gz)も使えます。
  • OpenAI は配信形式として Parquet も推奨しています。
  • 列名は仕様の英語名をそのまま使います。日本語の列名や綴り違いは、正しく取り込まれない原因になります。

すべての商品で必須の9項目

列名内容
item_id商品ID
title商品名
description商品説明
url商品ページURL
brandブランド
seller_name販売者名
image_urlメイン画像URL
availability在庫状態
price販売価格

つまずきやすいポイント

  • price は「金額+半角スペース+ISO 4217 の通貨コード」で書きます(例:12800 JPY)。¥12,800 や通貨なしの 12800 は不正です。
  • availability は in_stock / out_of_stock / pre_order / backorder / unknown のいずれかです。在庫あり や stock などは使えません。
  • item_id はフィード内で重複させません。色・サイズ違いは variant ごとに1行にし、group_id・listing_has_variations・variant_dict で同じ商品のバリエーションであることを示します。
  • url・image_url は https:// から始まる絶対URLにします。
  • 必須項目を N/A や null などの仮の値で埋めても、入力したことにはなりません。

仕様に適合していることは、ChatGPT への掲載や推薦を保証するものではありません。仕様は更新されることがあるため、作成時は最新の公式リファレンスも確認してください。

フィードを検証する

ACP Product Feed Validator は、上記を含む仕様のルールでフィードを検証し、商品ごとに「現在の値」「期待する値」「修正方法」を日本語で表示します。ファイルはブラウザ内で解析し、サーバーへは送信しません。

Guides 一覧 →