Klaviyo 資料移轉作業簡介

您可以使用 BigQuery 資料移轉服務的 Klaviyo 連接器，將資料從 Klaviyo 載入 BigQuery。透過 BigQuery 資料移轉服務，您可以排定週期性移轉作業，將 Klaviyo 的最新資料新增至 BigQuery。

如要瞭解如何排定 Klaviyo 移轉作業，請參閱「將 Klaviyo 資料載入 BigQuery」。

資料擷取選項

以下各節說明設定 Klaviyo 資料移轉作業時，可用的資料擷取選項。

完整或增量轉移

設定 Klaviyo 移轉作業時，您可以在移轉設定中選取「Full」(完整) 或「Incremental」(增量) 寫入偏好設定，指定資料載入 BigQuery 的方式。預先發布版支援增量移轉。

您可以設定完整資料移轉作業，在每次移轉時，從 Klaviyo 資料集移轉所有資料。

或者，您也可以設定增量資料移轉 (預先發布版)，只移轉上次資料移轉後變更的資料，而不是每次資料移轉時都載入整個資料集。如果選取「Incremental」(增量) 做為資料移轉模式，則必須指定「Append」(附加) 或「Upsert」(新增或更新) 寫入模式，定義在增量資料移轉期間，資料寫入 BigQuery 的方式。以下各節將說明可用的寫入模式。

附加寫入模式

附加寫入模式只會將新資料列插入目的地資料表。這個選項會嚴格附加轉移的資料，不會檢查現有記錄，因此這個模式可能會導致目的地資料表中的資料重複。

選取附加模式時，必須選取浮水印欄。Klaviyo 連接器必須有基準資料欄，才能追蹤來源資料表的變更。

如果是 Klaviyo 轉移作業，建議選取只在記錄建立時更新的欄位，後續更新不會變更該欄位，例如「CREATED_AT」欄。

更新插入寫入模式

透過 upsert 寫入模式，系統會檢查主鍵，藉此更新資料列或在目的地資料表中插入新資料列。您可以指定主鍵，讓 Klaviyo 連接器判斷需要進行哪些變更，確保目的地資料表與來源資料表保持最新。如果在資料移轉期間，指定的 主鍵出現在目的地 BigQuery 資料表中，Klaviyo 連接器就會使用來源資料表中的新資料更新該資料列。如果在資料移轉期間沒有主鍵，Klaviyo 連接器就會插入新資料列。

選取「新增或更新」模式時，必須選取浮水印欄和主鍵：

  • Klaviyo 連接器需要基準欄，才能追蹤來源資料表的變更。
    • 選取每次修改資料列時都會更新的水印欄。建議使用與 UPDATED_AT 或 LAST_MODIFIED 欄類似的資料欄。

  • 主鍵可以是資料表中的一或多個資料欄，Klaviyo 連接器需要這些資料欄，才能判斷是否需要插入或更新資料列。

    選取包含非空值且在資料表所有列中都是唯一值的資料欄。建議您使用包含系統產生的 ID、專屬參照代碼 (例如自動遞增 ID) 或不可變動的時間序列 ID 的資料欄。

    為避免資料遺失或損毀，您選取的主鍵資料欄必須包含不重複的值。如果您不確定所選主鍵欄是否不重複，建議改用附加寫入模式。

資料類型對應

下表將 Klaviyo 資料類型對應至相應的 BigQuery 資料類型：

Klaviyo 資料類型 BigQuery 資料類型
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

定價

這項功能處於預先發布版階段時，將 Klaviyo 資料移轉至 BigQuery 無須付費。

後續步驟