Tajo 通过两种方式将 Shopify 数据移动到 Brevo。Tajo Shopify 应用在 Shopify webhook 到达时即时处理。同步规则经人工批准、单向、按批次运行，并全程记录。本文将解释这两种方式、它们不包括什么，以及 Tajo Shopify 应用会写回 Shopify 的少数内容。
快速检查 本文假设你已经连接了 Shopify 和 Brevo，并至少发布了一条同步规则。如果还没有，请从将 Tajo 连接到 Shopify开始。
事件发生时：Tajo Shopify 应用
Tajo Shopify 应用订阅 Shopify webhook，并在每个 webhook 到达时立即处理。客户和商品的更改会先等待约四秒。客户、订单、结账、商品、集合和库存水平都通过这种方式到达 Brevo，同时还有 order_paid 和 cart_abandoned 等事件。Shopify 集成指南列出了每个主题及其写入 Brevo 的内容。
同步规则的构成
同步规则是一个经过审查、批准的定义，精确规定了迁移什么以及如何迁移。代理根据你的描述构建规则，由人工批准。规则包含四个部分，你可以在 Connections > Syncs and mappings 下的规则页面中查看：
| 部分 | 作用 |
|---|---|
| 字段映射 | 每个源字段、它写入的 Brevo 字段，以及中间的任何转换 |
| 过滤表达式 | 按每条记录进行求值，不匹配的记录会被跳过 |
| Cursor | 跟踪同步已推进到的位置，以便每次运行都从上一次停止的地方继续 |
| 运行历史 | 每次运行的读取、写入和失败记录数，以及运行时长和状态 |
同步规则单向移动数据：从你的数据源进入 Brevo。它从不写入 Shopify。Tajo Shopify 应用会向 Shopify 写回少数内容，例如同意状态退订和会员等级标签。Shopify 权限说明列出了每一次写入及其发生时机。
同步规则何时运行
同步规则以批次运行。联系人同步规则默认每 15 分钟运行一次。处于活动状态且已发布的 Shopify orders → Brevo orders 规则同样每 15 分钟运行一次，但前提是使用模板自带的买家营销同意过滤条件。过滤条件被编辑过的规则只有在你启动它时才会运行。订单规则的首次计划运行在那一刻的几分钟前开始，不会发送更早的订单。之后的每次运行发送自上次运行以来更新的订单。过往订单只有在你亲自运行该规则时才会进入 Brevo。处于活动状态的规则页面上有 Test run (1 batch) 按钮，你提出要求时，Sync Operator 代理也会运行处于活动状态的规则。批次运行正是让每次写入都可审查、有预算约束，并能追溯到具体某次运行的原因。
每次运行都会读取自 cursor 以来新增和更改的记录，应用过滤条件，映射字段，并写入 Brevo。运行记录会精确显示读取、写入和失败的记录数。
治理保障
同意失败即拒绝写入
向 Brevo 写入个人数据的规则，如果没有同意和屏蔽过滤条件就无法发布。运行时，没有可证明同意而要写入营销受众的联系人会被拒绝。当无法确认同意时，Tajo 会拒绝写入，而不是去猜测。失败模式始终是“过于谨慎”，而不是“过度发送”。
运行是幂等的
每次写入都带有一个从源记录派生的键。该键是一个哈希值，因此不包含任何个人数据。对相同的记录重新运行同步，无论是在失败或暂停之后，还是手动运行，都不会产生重复写入。
一切都会被审计
规则的发布、失效的批准和自动暂停都会记录在 Activity 下。每个批准决定都附有书面理由。每次运行都记录在规则的运行历史中。授权发布的批准与所预览的确切规则的摘要绑定。编辑规则会使其回到草稿状态并使批准失效，因此实际运行的始终是被授权的内容。
失败会暂停规则
如果连续五次运行失败，熔断器会自动暂停规则，并在规则页面上显示最近一次的错误。修复原因后，重新发布即可恢复。部分失败的运行会报告其失败记录数，让你能准确看到哪些内容没有写入成功。
退订如何被尊重
- 当联系人通过 Brevo 邮件页脚链接退订时，该退订会被记录在该联系人名下，Brevo 会将其排除在后续营销活动之外。
- 在批量客户同步中，Tajo Shopify 应用会比较 Shopify 同意的时间和 Brevo 退订的时间，并保留较晚的那一个。
- 以 webhook 形式从 Shopify 到达的同意变更，会按 Shopify 报告的状态写入 Brevo。
- 如果该联系人在 Shopify 中是已订阅状态，Tajo Shopify 应用也会在 Shopify 中将其标记为已退订。Brevo 事件只会让客户从已订阅变为已退订。它从不会让任何人订阅，因此在 Brevo 中订阅不会改变 Shopify。
有哪些数据可用
Tajo Shopify 应用发送联系人、订单、订单和购物车事件、商品目录以及库存。同步规则发送什么取决于其字段映射。对于 Shopify 客户，模板会将身份字段、总消费、订单数、标签和选择加入状态映射为 Brevo 联系人属性，供你在细分和营销活动中使用。你的 workspace 的确切映射并不隐藏在某个描述里：打开同步规则，阅读字段映射表。那张表才是“同步了什么”这个问题的权威答案。
Tajo 目前不做的事
明确边界比罗列一长串功能更重要：
- 没有双向同步规则。 同步规则只会写入 Brevo。Shopify 应用自己对 Shopify 的写入（同意状态退订、Brevo 互动和忠诚度 metafields、会员等级标签）列在 Shopify 权限说明中。
- 没有实时同步规则。 同步规则以批次运行。只有 Tajo Shopify 应用的 webhook 同步会在事件到达时即时运行。
- 没有到货通知按钮。 应用会让 Brevo 中的商品库存保持最新，并向请求到货通知的顾客发送
back_in_stock事件。该请求必须来自你的店面：应用不会在你的主题中添加“Notify me”按钮。
如果这些边界中的某一项阻碍了你的某个使用场景，请告诉团队，early access 阶段的优先级正是由这类反馈塑造的。
在哪里查看你的数据
- 在 Tajo 中：在 Connections > Syncs and mappings 下打开同步规则，查看运行历史、cursor 位置和每次运行的记录数。Activity 会记录发布和自动暂停。
- 在 Brevo 中：打开 Contacts，检查任意联系人的属性，确认映射字段已被填充。基于这些属性构建细分以进行定向。
故障排查
- 联系人未出现在 Brevo 中：检查规则最近一次运行是否有失败，以及其状态（已暂停的规则不会运行）。请参见Brevo 中联系人缺失。
- 运行反复失败：熔断器会暂停规则并显示最近一次的错误。请参见数据未同步。
- 重复联系人：写入按源记录是幂等的，但 Brevo 中已存在的重复项会保留。请参见重复联系人。
常见问题
我能让同步更快吗？ 处于活动状态的规则页面上有 Test run (1 batch) 按钮。对于实时发生的更改，Tajo Shopify 应用的 webhook 同步已经覆盖客户、订单、结账、商品和库存。
如果一次运行中途失败会怎样？ 该次运行会报告其失败记录数，cursor 只会推进到已处理的部分，下一次运行会安全地重新覆盖剩余部分，幂等键可防止出现重复。
我能更改同步的内容吗？ 可以。请代理修改规则的字段映射或过滤条件。编辑会使规则回到草稿状态，必须重新经过预览和批准才能再次运行。
我的规则为什么会自动暂停？ 连续多次运行失败会触发熔断器。规则页面会显示失败次数和最近一次错误，修复问题后重新发布即可。
相关文章
获取帮助
联系团队。