了解 Shopify 与 Brevo 的数据同步

Tajo 通过受管控的同步规则将数据从你的数据源移动到 Brevo：人工批准、单向、按计划运行，并全程记录。本文将解释这在实践中意味着什么，以及它不包括什么。

快速检查 本文假设你已经连接了 Shopify 和 Brevo，并至少发布了一条同步规则。如果还没有，请从将 Tajo 连接到 Shopify开始。

同步的构成

Tajo 中的每个同步都是一条同步规则：一个经过审查、批准的定义，精确规定了迁移什么以及如何迁移。规则包含四个部分，你可以在 Connectors > Syncs 下的规则页面中查看：

数据单向流动：从你的数据源进入 Brevo。Tajo 不会将数据写回 Shopify。

数据何时同步

同步运行以计划批次进行，或在你从规则页面触发时按需运行。Tajo 不是实时管道：Shopify 中的更改会在下一次运行时到达 Brevo，而不是在几秒钟内。这是刻意设计的，批次运行正是让每次写入都可审查、有预算约束，并能在审计跟踪中追溯到具体某次运行的原因。

每次运行都会读取自 cursor 以来新增和更改的记录，应用过滤条件，映射字段，并写入 Brevo。运行记录会精确显示读取、写入和失败的记录数。

治理保障

同意失败即拒绝写入

同步规则如果没有同意政策就无法发布，运行时没有可证明同意的记录不会被写入。当无法确认同意时，Tajo 会拒绝写入，而不是去猜测。失败模式始终是“过于谨慎”，而不是“过度发送”。

运行是幂等的

每次写入都带有一个从源记录派生的溯源键（其构建方式对个人信息是安全的），因此无论是因失败、暂停还是手动原因而重新运行同步，都不会产生重复写入。再次运行规则始终是安全的。

一切都会被审计

规则的发布、每一次带有书面理由的批准决定，以及每一次运行，都会被记录在审计跟踪中。授权发布的批准与所审查的确切规则版本绑定，编辑规则会使该批准失效，因此审计跟踪始终准确反映实际被授权的内容。

失败会暂停规则

如果连续多次运行失败，熔断器会自动暂停规则，并在规则页面上显示最近一次的错误。修复原因后，重新发布即可恢复。部分失败的运行会报告其失败记录数，让你能准确看到哪些内容没有写入成功。

退订如何被尊重

Tajo 将 Brevo 视为电子邮件同意的权威来源：

• 当联系人通过 Brevo 邮件页脚链接退订时，该退订会被记录在该联系人名下，Brevo 会将其排除在后续营销活动之外。
• 在 Brevo 中被列入黑名单的联系人将保持被排除状态，下游发送不会让他们“复活”。
• Tajo 不会将退订状态写回 Shopify。如果你也在 Shopify 中收集邮件同意，请在那里单独进行管理，不要假设两个系统会互相镜像。

有哪些数据可用

同步的内容取决于你的数据源可用的模板。对于 Shopify，典型的形态是客户记录：身份字段，以及订单派生的属性（例如总消费和订单数），并映射为 Brevo 联系人属性，供你在细分和营销活动中使用。你的 workspace 的确切映射并不隐藏在某个描述里：打开同步规则，阅读字段映射表。那张表才是“同步了什么”这个问题的权威答案。

Tajo 目前不做的事

明确边界比罗列一长串功能更重要：

• 不支持双向同步。 没有任何内容会写回 Shopify，无论是退订状态、标签，还是互动分数。
• 不支持实时同步。 运行是计划性或手动触发的批次，不是亚分钟级的流式处理。
• 不支持库存跟踪。 不监控产品库存水平，也没有补货提醒触发器。

如果这些边界中的某一项阻碍了你的某个使用场景，请告诉团队，early access 阶段的优先级正是由这类反馈塑造的。

在哪里查看你的数据

• 在 Tajo 中：在 Connectors > Syncs 下打开同步规则，查看运行历史、cursor 位置和每次运行的记录数。审计跟踪会记录发布和批准情况。
• 在 Brevo 中：打开 Contacts，检查任意联系人的属性，确认映射字段已被填充。基于这些属性构建细分以进行定向。

故障排查

• 联系人未出现在 Brevo 中：检查规则最近一次运行是否有失败，以及其状态（已暂停的规则不会运行）。请参见Brevo 中联系人缺失。
• 运行反复失败：熔断器会暂停规则并显示最近一次的错误。请参见数据未同步。
• 重复联系人：写入按源记录是幂等的，但 Brevo 中已存在的重复项会保留。请参见重复联系人。

常见问题

我能让同步更快吗？ 你可以随时从同步规则页面按需触发一次运行。没有实时模式。

如果一次运行中途失败会怎样？ 该次运行会报告其失败记录数，cursor 只会推进到已处理的部分，下一次运行会安全地重新覆盖剩余部分，幂等键可防止出现重复。

我能更改同步的内容吗？ 可以，编辑规则的字段映射或过滤条件。编辑会产生一个新版本，该版本必须重新通过发布批准后才会生效。

我的规则为什么会自动暂停？ 连续多次运行失败会触发熔断器。规则页面会显示失败次数和最近一次错误，修复问题后重新发布即可。

相关文章

• 将 Tajo 连接到 Shopify
• 细分基础
• 故障排查：数据未同步
• 故障排查：Brevo 中联系人缺失

获取帮助

• 在线聊天：可在 Tajo 仪表板中使用（右下角）
• 邮件支持：[email protected]
• 文档：docs.tajo.io