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
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

价格

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

后续步骤