For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション

商品チェックアウトのコンバージョン仕様

商品チェックアウト用プラグインを ChatGPT のコンバージョンフローに統合するための仕様。

ChatGPT の商品チェックアウト用コンバージョンプラグインは現在ベータ版で、 承認済みのパートナーとテストを行っています。利用を申請するには、フォームに入力してください

こちら

目的

商品チェックアウトなど、ユーザーの利用意図が明確なユースケースで、ChatGPT がパートナーのプラグインを直接呼び出せるようにすることを目指しています。

パートナーから検索用の商品フィードをご提供いただくと、その MCP サーバーに接続し、購買プロセスの最終段階でコンバージョンにつながるアクションを実行できます。そのため、パートナーのプラグインは、ウィジェット名、ツール名、ツール入力について標準化された仕様に従う必要があります。

この仕様に準拠したプラグインを構築する場合は、 ChatGPT 販売者向けフォームから利用を申請してください。

ユーザー体験

ユーザーが商品を検索すると、商品情報のサイドバーに販売者ごとの 開くボタンを表示できます。 販売者がプラグインを提供している場合、ChatGPT は外部のウェブサイトに移動する代わりに、 そのプラグインをインラインで開いてチェックアウトを進められます。

必須仕様(現時点)

  • ウィジェット名:ui://widget/checkout-session.html
  • ツール名:checkout_session

checkout_session では、次の設定が必須です。

_meta.ui.resourceUri = "ui://widget/checkout-session.html";

ウィジェットから直接呼び出すツールでは、すべて次の設定が必須です。

_meta["openai/widgetAccessible"] = true;

checkout_session の入力

チェックアウトの各商品で必須なのは idquantity のみです。 選択した販売者のオファーに関する offerId とメタデータは省略可能です。

{
  "checkout_session": {
    "items": [
      {
        "id": "string",
        "quantity": 1,
        "offerId": "string",
        "name": "Wireless headphones",
        "description": "Wireless headphones with noise cancellation.",
        "images": [
          "https://merchant.example.com/images/headphones.jpg",
          "https://merchant.example.com/images/headphones-side.jpg"
        ],
        "url": "https://merchant.example.com/products/headphones",
        "merchant_name": "Example Merchant",
        "price": "$24.99"
      }
    ]
  }
}

商品の次のフィールドは省略可能です。

フィールド説明
offerId選択した販売者のオファーの識別子。
name選択したオファーの商品名。
description販売者自身のフィードに含まれる説明。
images販売者のフィードに含まれる画像 URL の順序付きリスト。最初の URL がメイン画像です。
url選択した販売者のオファーの URL。
merchant_name選択した販売者の名前。
price表示されているオファー価格を表す文字列。

images には、選択した販売者のフィードから取得した URL が 0 個以上含まれます。 URL がある場合、最初の URL の画像がメイン画像として表示されます。 ChatGPT は、値を取得できない省略可能なフィールドを省略します。 説明を生成したり、別の販売者の説明や画像を使用したりすることはありません。 これらの商品フィールドはツールの入力スキーマで省略可能として宣言し、 チェックアウトの商品 ID とオファー ID を使用して、自社のカタログから正規の商品情報、在庫情報、価格情報を取得してください。

ネストされたチェックアウトセッションは、 こちらに記載されている Commerce のチェックアウトセッションの構造に準拠しています。