[即將推出] 串接 Klaviyo API，遷移 Profile & Segment

本文將說明如何透過「Klaviyo 資料遷移」功能，將 Klaviyo 中的 Profile、Segment 和 List 遷移到 SmartPush，設定方式簡單，且資料遺失的風險低，助您順利將 Klaviyo 資料遷移到 SmartPush。

介紹

SmartPush 支援串接 Klaviyo ，透過授權 Klaviyo Private API Key，自動將 Klaviyo 的 Profile、Segment 和 List 同步到 SmartPush。有效助您：

降低 Klaviyo 的遷移成本
保留既有受眾結構
立即在 SmartPush 中使用這些資料進行行銷活動、自動化及分眾群組

＊注意:

此功能僅支援使用標準版或以上版本的店家使用；免費試用版可在試用期間使用該功能。
如需使用此功能，請聯絡線上顧問開通。

支援的資料類型

目前 SmartPush 支援遷移以下 Klaviyo 資料：

1. Profile（聯絡人）

信箱地址
手機號碼
Profile 屬性（預設屬性及自訂屬性）
訂閱狀態（電子郵件與簡訊，受同步規則限制）

2. Segment & List

Segment 名稱
List 名稱

＊備註：目前暫不支援遷移 Segment 條件、Flow 邏輯、模板、行銷活動、彈窗或自動化流程。

Klaviyo 資料如何整合至 SmartPush

1. Profile

SmartPush 將整合您的 Klaviyo 帳號中所有 Profile 資料，並在 SmartPush 中建立對應的聯絡人。

每位匯入的聯絡人都會被分配一個 SmartPush UID
從 Klaviyo 匯入的聯絡人僅會儲存在 SmartPush 中，不會透過 Open API 同步至主站

2. Profile 屬性對照

SmartPush 將依照以下規則整合 Klaviyo 的 Profile 屬性：

i. 預設屬性

Klaviyo 屬性	SmartPush 屬性	備註
email	email	已加密
phone_number	kla_phone_number	已加密
country	country	已加密
first_name + last_name	name	合併為一個欄位

ii. 自訂屬性

其他 Klaviyo 屬性將以自訂屬性的形式匯入SmartPush，這些自訂屬性都會以 kla_ 為前綴，例如：kla_$source、kla_locale，可用於分眾群組篩選條件、自動化篩選條件、聯絡人列表顯示。

3. Segment

Klaviyo 的 Segment 將以「標籤」的形式遷移到 SmartPush。每個 Segment 名稱都會轉換成為一個標籤，轉換名稱的規則及舉例如下：

以 kla_segment_ 為前綴
全部轉為小寫
空格轉為底線

Klaviyo Segment	SmartPush 標籤
Repeat Purchasers	kla_segment_repeat_purchasers

您可以在建立「分眾群組」時，於新增條件中「其他 > 自訂標籤」找到該標籤。

4. List

Klaviyo 的 List 也會以「標籤」的形式遷移到 SmartPush。每個 List 名稱都會轉換成為一個標籤，轉換名稱的規則及舉例如下：

以 kla_list_ 為前綴

Klaviyo List	SmartPush 標籤
Newsletter	kla_list_newsletter

您可以在建立「分眾群組」時，於新增條件中「其他 > 自訂標籤」找到該標籤。

同步時機與頻率

SmartPush 支援手動同步與自動同步兩種方式：

手動同步：當您手動同步聯絡人時觸發。
自動同步：每天進行一次同步，包含：
- 新增或更新聯絡人
- Segment 與 List 名單更新

如何串接 Klaviyo

步驟一：打開 Klaviyo 資料遷移功能

路徑一：在 SmartPush 後台「聯絡人 > 所有聯絡人」頁面，點選「匯入 > 同步 Klaviyo 聯絡人」。

路徑二：在 SmartPush 後台「應用程式 > 應用程式整合」頁面，於「Klaviyo 資料遷移」列表中點選「串接」。

步驟二：建立 Klaviyo Private API Key

在 Klaviyo 後台「Account > Settings > API Keys」點選「Create Private API Key」，並將 Key 的權限設定開啟：Profiles、Segments、List。

步驟三：在 SmartPush 中輸入 API Key

將 Klaviyo Private API Key 貼入至 SmartPush 彈窗輸入框，再點選「開始同步」，SmartPush 將會驗證 API Key，並開始同步資料。

串接狀態與重新同步

串接狀態

待串接：尚未貼入 API Key。
同步中：已貼入 API Key，資料正在同步中。
同步暫停：
- API Key 失效或過期
- 同步發生錯誤
- 帳戶方案已降為免費版

重新同步

更換為有效的 API Key 時，同步將自動恢復。
升級為標準版或以上方案後，當系統讀取到新增的資料即會恢復同步。

訂閱狀態同步規則

從 Klaviyo 同步聯絡人時，同步規則如下：

已訂閱：SmartPush 的訂閱狀態會被覆蓋。
未訂閱：僅會在 SmartPush 內被管理，不會覆蓋。

SmartPush 會自動處理不同平台的訂閱狀態優先順序，您無需手動管理。

注意事項與限制

Segment 與 List 的條件規則不會被遷移
同步時將自動產生標籤名稱，無法在同步時被重新命名
部分 Klaviyo 屬性因 API 限制為只能讀取或不支援，因此無法同步

常見問題

Q1：同步 Klaviyo 資料會覆蓋現有的 SmartPush 聯絡人嗎？

SmartPush 會透過最新的 ID Mapping 邏輯，安全地整合聯絡人資料。

Q2: 可以停止同步 Klaviyo 資料嗎？

可以。您可以隨時於「應用程式 > 應用程式整合」頁面，點選「取消串接」。

Q3: SmartPush 會把資料同步回 Klaviyo 嗎？

不會。此功能為單向同步，僅會從 Klaviyo 同步至 SmartPush。

目錄

介紹