Klaviyo 数据传输简介

您可以使用适用于 Klaviyo 的 BigQuery Data Transfer Service 连接器将数据从 Klaviyo 加载到 BigQuery。借助 BigQuery Data Transfer Service，您可以安排周期性转移作业，以将 Klaviyo 中的最新数据添加到 BigQuery。

如需了解如何安排 Klaviyo 转移作业，请参阅将 Klaviyo 数据加载到 BigQuery 中。

数据注入选项

以下部分介绍了设置 Klaviyo 数据传输作业时可用的数据注入选项。

完整转移或增量转移

在设置 Klaviyo 转移作业时，您可以在转移作业配置中选择完整或增量写入偏好设置，以指定数据加载到 BigQuery 的方式。预览版支持增量转移。

您可以配置完整数据传输，以便在每次数据传输时传输 Klaviyo 数据集中的所有数据。

或者，您也可以配置增量数据传输（预览版），以仅传输自上次数据传输以来更改的数据，而不是在每次数据传输时都加载整个数据集。如果您为数据传输选择增量，则必须指定附加或 upsert 写入模式，以定义在增量数据传输期间如何将数据写入 BigQuery。以下各部分介绍了可用的写入模式。

附加写入模式

“附加”写入模式只会向目标表中插入新行。此选项会严格附加转移的数据，而不检查是否存在现有记录，因此这种模式可能会导致目标表中的数据重复。

选择附加模式时，您必须选择水位线列。Klaviyo 连接器需要一个水位线列来跟踪源表中的更改。

对于 Klaviyo 转移作业，我们建议选择仅在创建记录时更新的列，且该列不会随后续更新而变化，例如 CREATED_AT 列。

Upsert 写入模式

upsert 写入模式会通过检查主键来更新目标表中的行或在其中插入新行。您可以指定主键，以便 Klaviyo 连接器确定需要进行哪些更改才能使目标表与源表保持同步。如果在数据传输期间，指定的主键存在于目标 BigQuery 表中，则 Klaviyo 连接器会使用源表中的新数据更新该行。如果在数据传输期间不存在主键，则 Klaviyo 连接器会插入新行。

选择 upsert 模式时，您必须选择水位线列和主键：

  • Klaviyo 连接器需要一个水位线列来跟踪源表中的更改。
    • 选择一个每次修改行时都会更新的水位线列。我们建议使用与 UPDATED_AT 或 LAST_MODIFIED 列类似的列。

  • 主键可以是表中的一列或多列，Klaviyo 连接器需要使用这些列来确定是否需要插入或更新行。

    选择包含非 null 值且在表的所有行中都唯一的列。我们建议使用包含系统生成的标识符、唯一参考代码（例如自动递增的 ID）或不可变、基于时间的序列 ID 的列。

    为防止潜在的数据丢失或数据损坏，您选择的主键列必须具有唯一值。如果您对所选主键列的唯一性有疑问，建议您改用附加写入模式。

数据类型映射

下表将 Klaviyo 数据类型映射到相应的 BigQuery 数据类型：

Klaviyo 数据类型 BigQuery 数据类型
String STRING
Text STRING
Integer INTEGER
Float FLOAT
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY
JSON JSON
Record RECORD

价格

将 Klaviyo 数据转移到 BigQuery 的功能处于预览版阶段时，您无需付费即可使用此功能。

后续步骤