> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 変更履歴

> SFRA カートリッジのリリース履歴

## 26.04.0 — 2026-04-28

**破壊的変更：**

* リテーラーの識別が、リクエストホストではなく、新しい**必須**の `kleepRetailerUUID` サイト設定に依存するようになりました。アップグレード後、**BM > Site Preferences > Kleep** で設定してください — 設定しないと、トラッキング、レコメンデーション機能、および iframe が機能しません。

**機能強化：**

* マーケットごとのレコメンデーションのパーソナライゼーションのために、`/recommend` ペイロードにマーケット/ロケールコンテキストを追加しました。
* `isKleepSessionEnabled` 設定を削除しました — セッション UUID ロジックが常に有効になりました。

**修正：**

* 注文 CSV エクスポートから顧客 PII を削除しました。
* 商品 CSV エクスポートの余分な空列を削除し、エクスポート形式を SFTP データ構造仕様に合わせました。

## 25.09.0 — 2025-09-22

* セッションベースの KPI のためのセッションごとの一意なセッション UUID を持つ新しいセッションロジック。内部/外部トラッキングの調整のために iFrame と共有。
* 複数カテゴリのサポート：靴、キッズ、ランジェリー。
* ドメインハンドラーの統一化。
* 2 つの新しいカスタム設定：サイトマーケット（マーケット別 KPI/フローのパーソナライゼーション）とセッションロジックイネーブラー。
* postMessage ベースのトリガーによるトラッキングの信頼性向上。

## 24.11.2 — 2024-11-12

**修正：**

* エクスポートステータスのクエリの不整合を修正する新しい `isKleepExported` ブール属性。
* カスタム属性の文字列化された空オブジェクトを修正（現在は空文字列）。

**機能強化：**

* カスタムジョブタイムアウトパラメーター（デフォルト：900 秒）。
* 最大注文制限パラメーター（デフォルト：1000 件/実行）。
* 再エクスポートのための新しい注文リセットジョブ。
* 注文は常にデルタモードでエクスポートされ、残りの注文は次回の実行で続行されます。

## 24.11.1 — 2024-11-08

* ローカライズされた PDP CTA：FR、JA、ES、PT（PT/BR）、IT、KO、DE（DE/BE）、NL。
* PDP CTA ロゴを削除しました。

## 24.11.0 — 2024-11-06

**修正：**

* エクスポートの `SFCC_custom_attributes` 列データの欠落を修正しました。
* KleepExportOrdersCSV の Full エクスポートオプションを修正しました。

**機能強化：**

* 1000 件の注文エクスポート制限を削除しました。
* 両エクスポートジョブのログを強化しました。
* 失敗した注文に対する KleepExportOrdersCSV の再試行機能。

## 24.10.2 — 2024-10-23

* レコメンデーションモーダル URL を更新しました。

## 24.10.1 — 2024-10-21

**機能強化：**

* 少なくとも 1 つがカテゴリ分けされている場合、すべてのバリアント/バリエーショングループを含むエクスポート。クォータ：マスター 20,000 件。
* 新しい `SFCC_Product_VariationGroups_ID` CSV 列。
* ジョブステップの未使用の `[BRAND]` 設定を削除しました。
* 注文エクスポートを「エクスポート済み」ステータスのみにフィルタリング。
* PDP のどこでも複数の Kleep CTA をサポート。CTA 読み込みスピナーを削除。
* 商品を提案する前のリアルタイム在庫チェック。新しい `button_clicked` イベント。

**修正：**

* メモ付き注文での KleepExportOrdersCSV のクラッシュを修正しました。

## 24.10.0 — 2024-10-07

**機能強化：**

* レコメンデーションモーダル URL の API 21.2 互換性。
* エクスポートチャンクサイズを 1000 → 100 に変更、空/重複行のクリーニング、ログの改善、`MainViewType` の自動トリム。

**新機能：**

* CustomObject を削除せずに `ExportType` パラメーター（デルタ/フル）。
* 商品エクスポートにカテゴリ名/ID を追加。

**修正：**

* バックエンドで「ERROR」なのに BM では「OK」と表示されるジョブステータスの問題。
* ジョブエラー時の `KleepExportDateTracker` 作成バグ。
* マスターがカテゴリ未分類の場合のバリエーショングループからのバリアントのエクスポート。

## 24.9.0 — 2024-09-25

**修正：** ポップアップからのカートへの追加；メタデータの `kleepLastExported` の欠落。

**機能強化：** SFCC API 21.2 との KleepExportProductsCSV 互換性。

## 24.8.0 — 2024-08-30

**修正：** PDP コンソールエラーを解決しました。

**機能強化：** レコメンデーション機能でマスターの代わりに VariationGroups を使用。

## 24.7.0 — 2024-07-03

**機能強化：** `lastModified` 日付によるデルタエクスポート。トラッキングの絶対画像 URL。API 呼び出しの最適化。

**新機能：** イベントトラッキング：`product_added_to_cart`、`checkout_completed`、`checkout_validated`。

**修正：** フロントエンドのコンパイル。カスタムオブジェクトの欠落によるジョブエクスポートのクラッシュ。

## 24.6.0 — 2024-06-10

初回リリース。