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