Klaviyo 是一個專為電商企業打造的電子郵件和簡訊行銷自動化平台。它基於商家的客戶和產品數據，提供個人化的行銷流程，例如歡迎郵件、購物車遺棄提醒、到貨通知和降價通知。 Klaviyo 的原生整合涵蓋 Shopify、WooCommerce、BigCommerce、Magento、PrestaShop、Salesforce Commerce Cloud、Spree、Square、Wix、Mi9 和 Shift4Shop 等平台。對於其他平台，或希望更嚴格控制哪些資料進入 Klaviyo 的商家，該平台可以透過自訂目錄 Feed 或 Catalogs API 匯入產品目錄，而 Feedance 正是為此而生。
Klaviyo 的推薦和自動化引擎只有在擁有最新產品目錄的情況下才能正常運作。產品目錄同步後，Klaviyo 會將您的產品資料與網站和電子郵件行為（瀏覽過的產品、添加到購物車事件、開始結帳事件和購買歷史記錄）相結合，從而建立個人化推薦模組，在庫存補貨時觸發到貨通知，並在購物車遺棄郵件和瀏覽放棄郵件中顯示顧客瀏覽過的具體產品。 Klaviyo 指出，缺少關鍵數據（例如圖片）的產品會自動從推薦中排除，已購買或缺貨的商品也會從推薦模組中過濾掉，因此，產品資訊的完整性和準確性直接決定了這些流程的運作效果。
自訂目錄同步完成後，Klaviyo 允許行銷人員將產品模組拖入流程或行銷郵件中，並動態填充內容，無需編寫 HTML 程式碼，因為 Klaviyo 的文件明確指出「產品模組不支援任何自訂 HTML」。這些模組可以提取最近瀏覽過的產品（基於「已瀏覽產品」指標）、與客戶瀏覽或訂購的產品類似的商品、已添加到購物車的商品（來自「加入購物車」或「開始結帳」事件），以及經典的暢銷商品清單和靜態清單。對於更高級的用例，例如專有推薦引擎，Klaviyo 還支援目錄查找標籤，這些標籤可以在範本中透過唯一的商品 ID 引用特定商品。所有這些都依賴於包含完整、清晰且帶有正確識別碼的商品記錄的目錄來源。
Klaviyo 支援兩種同步外部目錄的途徑：託管的自訂目錄來源，或透過目錄 API 直接整合。
對於託管資料來源，Klaviyo 接受JSON 或 XML 格式，不支援 CSV 格式。資料來源必須可透過 HTTPS 公開訪問，且 Klaviyo 會按固定時間表而非按需拉取資料來源。 Klaviyo 的指南明確指出，資料來源中的資料「只能嵌套一層節點，不能是嵌套的 JSON 或 XML」（Google Merchant 資料來源是唯一例外），資料來源中的第一個條目必須包含您計劃映射的所有字段，以便 Klaviyo 可以檢測架構，並且所有必填欄位都不能留空－Klaviyo 建議對不可用的數位使用文字），而不是使用文字/a 字欄位都不能省略該欄位，Klaviyo 建議不可用的數位文字」。資料來源檔案最大可達 100MB，但 Klaviyo 建議保持在 50MB 以下以確保可靠的處理，較大的目錄可以拆分成多個文件，然後匯總到一個目錄中。
或者，需要即時或事件驅動更新的系統可以直接透過 Klaviyo 的 Catalogs API 推送項目，該 API 使用資源 ID 格式。 {integration_type}:::{catalog_type}:::{external_id} - 例如 $custom:::$default:::3829918373-TShirt-1Klaviyo目前僅支援 $custom 整合類型與 $default 目錄類型。
| 屬性 | 資訊欄位/API金鑰 | 需要？ | 產品說明 |
|---|---|---|---|
| 商品編號 | $id （自訂資訊流）/ external_id （API） | 必填 | 物品或變體的唯一識別碼；可以是文字、數字或字母數字組合，但必須符合 Klaviyo 規範的唯一性要求。 |
| 稱謂 | $title / title | 必填 | 產品名稱 |
| 產品說明 | $description / description | 必填 | 物品的文字描述 |
| 產品網址 | $link / url | 必填 | 客戶可以在您的網站上查看商品的網址 |
| 圖片網址 | $image_link / image_full_url | 必填（自訂資料來源）/ 可選（API） | 必須使用 HTTPS；沒有圖片的商品將不會被 Klaviyo 的建議清單屏蔽。 |
| 價格 | $price / price | 選配 | 不含貨幣符號的數位商品價格；用於電子郵件商品模組，可觸發降價流程。 |
| 庫存數量 | $inventory_quantity / inventory_quantity | 總體上是可選的，但啟用“重新上架”功能需要此設定。 | 當前庫存數量（以數字表示）；Klaviyo 的「補貨指南」要求每個商品都填寫此欄位。 |
| 庫存政策 | $inventory_policy | 選配 | 值 1 表示缺貨時隱藏商品，值 2 表示在資訊流中始終顯示商品。 |
| 分類 | categories | 選配 | 以逗號分隔的類別、標籤或收藏列表，該物品屬於 |
| 自訂元數據 | custom_metadata （限目錄 API） | 選配 | 用於儲存額外產品資料的扁平化 JSON 資料塊，大小上限為 100KB |
Feedance 產生 Klaviyo 期望的託管 JSON 或 XML 目錄來源，並逐字段映射到 Klaviyo 的架構，因此您不必手動建立扁平的單節點來源或自行維護自訂 API 整合。
Klaviyo 以固定的6 小時週期拉取自定義目錄資料來源。如果您的資料來源位於快取層之後，Klaviyo 的文件警告您，當底層資料變更時，您必須停用快取或手動刷新緩存，否則即使您的資料來源已更新，Klaviyo 仍會繼續拉取過時的快取資料。除了資料來源同步本身之外，Klaviyo 的建議模型也需要額外的訓練時間：該平台表示，其係統通常需要 2 天到 1 週的時間來訓練新的目錄，並且推薦模型通常根據使用情況每 2-7 天重新訓練一次。 Feedance 能夠按照 Klaviyo 的 6 小時週期可靠地刷新您的資料來源，從而確保價格、庫存和新品變更能夠以 Klaviyo 自身架構允許的最快速度流入訓練循環。
Klaviyo 的同步和故障排除文件列出了幾個導致目錄同步失敗的常見原因：
每次同步時，請確保商品 ID 保持不變——Klaviyo 會根據此值匹配商品，因此 ID 的更改會導致 Klaviyo 將現有商品視為全新商品，並重置其所有累積的推薦和庫存歷史記錄。請填寫 Klaviyo 可用於自動化的所有可選字段，尤其是 $price 和 $inventory_quantity，因為庫存資料是啟用「重新上架」流程和價格資料饋送降價活動所必需的。請確保每個商品都有有效的 HTTPS 圖片 URL，因為 Klaviyo 會默默地從推薦模組中移除沒有圖片的商品，而不是報錯。如果您管理的目錄資料超過約 50MB，請將其拆分到指向相同目錄的多個 feed 檔案中，而不是推送過大的檔案。如果您的目錄接近 Klaviyo 官方記錄的 250,000 萬件商品、500,000 萬個變體或 2,500 個類別的上限，或者您的 feed 將超過 1 萬件商品，請根據 Klaviyo 的指導，在設置之前聯繫 Klaviyo 支援團隊。
Klaviyo 是否接受 CSV 格式的資料來源？
不。 Klaviyo 的自訂目錄訂閱源同步僅接受 JSON 或 XML 格式；不支援 CSV 格式。
自訂目錄資料來源與目錄 API 有何不同？
自訂目錄資料來源是託管文件，Klaviyo 會按照其自身的 6 小時定時拉取更新。目錄 API 可讓您直接推送商品建立、更新和刪除操作，這非常適合那些需要比輪詢資料來源更快或更依賴事件驅動的更新的商家。
為什麼我的Klaviyo目錄沒有更新？
Klaviyo 文件出現問題的最常見原因是快取層提供過時的資料、來源 URL 無法存取或受保護，或來源結構格式錯誤/嵌套，不符合 Klaviyo 的單節點深度要求。
我的訂閱源需要包含哪些內容才能啟用到貨提醒？
Klaviyo 的「重新上架」指南要求自訂目錄資料來源中的每個商品都必須包含 $inventory_quantity 欄位；否則，Klaviyo 將無法收到庫存訊號來觸發補貨通知。
我可以在Klaviyo的產品推薦模組中使用自訂HTML嗎？
不。 Klaviyo 的文檔指出產品模組不支援自訂 HTML；進階格式需要使用文字區塊或目錄尋找標籤中的 Source 選項。
