Rijoy文档集成
集成Klaviyo
作者: Rijoy 团队
功能说明
「集成Klaviyo」用于将Rijoy会员忠诚度系统与Klaviyo营销自动化平台无缝连接，实现用户数据和行为事件的双向同步，是构建全渠道会员营销体系的关键环节。
通过该集成，您可以：
- 精准细分会员群体，实现个性化营销触达
- 基于会员积分、等级、推荐行为等数据创建自动化营销流程
- 在Klaviyo中监控会员忠诚度行为，优化营销策略
- 结合购买行为与忠诚度数据，提升复购率和客户生命周期价值
生效逻辑说明
- 当Rijoy与Klaviyo成功连接后，系统会自动在Klaviyo创建会员细分组
- 用户资料字段会实时同步到Klaviyo平台
- 选择性同步用户行为事件到Klaviyo，支持自定义选择需要同步的事件类型
- 所有同步数据遵循用户隐私合规要求，确保数据安全
操作路径
- 点击【Integrations】菜单
- 进入"Integrations"页面
- 点击"Klaviyo"，进入配置页面
- 点击"Connect with Klaviyo"按钮，进行Rijoy和Klaviyo的连接
- 点击"Allow"按钮
- 在Klaviyo网站，点击"Integrations"菜单，如果列表中显示"Rijoy App"，则表示连接成功
配置项说明
1. 用户细分（自动创建）
Rijoy会在连接成功后，自动在Klaviyo创建以下用户细分组：
| 用户细分 | 说明 |
|---|---|
| Rijoy - VIP Tier | 1. 已创建的VIP等级 2. 按等级自动生成多组 |
| Rijoy - Members | 1. 店铺中已是会员的用户 |
| Rijoy - Has birthday | 1. 已经设置好生日的用户 |
| Rijoy - Referred Customers | 1. 邀请过新用户成功下单的用户 |
2. 同步的用户资料字段
Rijoy会将以下会员数据字段同步到Klaviyo用户档案：
| 字段名 | 说明 |
|---|---|
| rijoy_points_available | 当前可用积分 |
| rijoy_points_pending | 即将到账的积分（例如已经完成下单，但是要在订单发货后积分才会真正到账，在发货前的状态，积分都处于Pending状态） |
| rijoy_points_lifetime_earned | 历史总获得积分 |
| rijoy_points_lifetime_spent | 历史总消耗积分 |
| rijoy_vip_tier | 当前VIP等级名称（Bronze / Silver / Gold等） |
| rijoy_vip_progress_current | 当前距离下一等级的进度（如积分、订单金额等） |
| rijoy_vip_progress_required | 升级到下一个等级所需的总进度 |
| rijoy_vip_upgrade_at | 最近一次升级时间 |
| rijoy_vip_next_tier | 下一等级（如Gold → Platinum） |
| rijoy_referral_url | 用户推荐专属链接 |
| rijoy_referral_registration_count | 累计成功邀请注册数量 |
| rijoy_referral_first_order_count | 累计成功邀请下单数量 |
| rijoy_referred_by | 被谁推荐（推荐人email） |
3. 事件同步配置
在Rijoy的Klaviyo集成配置页，可选择需要同步到Klaviyo的用户行为事件：
配置步骤：
- 返回"Rijoy Loyalty"的"Klaviyo Integration"配置页面
- 勾选需要同步到Klaviyo的事件类型
- 点击"Save"按钮保存配置
- 用户触发所选事件时，系统会自动将事件同步到Klaviyo
支持同步的事件类型：
| 事件名称 | 触发条件 | 同步内容 |
|---|---|---|
| rijoy_points_earned_order_pending | 顾客下单后，积分进入锁定状态Pending | 1. 积分数、订单号、预计到账日 |
| rijoy_points_earned_order | 订单满足条件（发货/X天）→积分到账 | 1. 积分数、订单号、预计到账日 2. 积分、订单号 |
| rijoy_points_earned_signup | 顾客注册成功获积分 | 奖励积分、注册时间 |
| rijoy_points_earned_manual | 手动增加积分数量 | 增加积分、操作原因、积分数量 |
| rijoy_points_earned_birthday | 顾客生日触发奖励积分 | 1. 增加积分、操作原因、积分数量 2. 奖励积分 |
| rijoy_points_earned_campaign_bonus | 活动期间，订单获得倍数奖励积分 | 1. 奖励积分 2. 倍数系数、活动名称、积分 |
| rijoy_points_canceled | 订单取消→Pending积分被取消 | 1. 倍数系数、活动名称、积分 2. 取消积分数、订单号 |
| rijoy_points_deducted_manual | 手动扣除积分数量 | 扣除积分、操作原因、剩余积分 |
| rijoy_points_deducted | 订单退款→已到账积分扣减 | 1. 扣除积分、操作原因、剩余积分 2. 扣减积分、比例、剩余积分 |
| rijoy_points_redeemed_discount | 顾客用积分兑换折扣码 | 1. 扣减积分、比例、剩余积分 2. 折扣码、消耗积分、有效期 |
| rijoy_reward_discount_used | 用户使用兑换的折扣码成功下单 | 1. 折扣码、消耗积分、有效期 2. 订单号、折扣金额、券码 |
| rijoy_vip_upgraded | 顾客升级 | 1. 订单号、折扣金额、券码 2. 新等级、旧等级、等级权益 |
| rijoy_vip_downgraded | 顾客降级 | 1. 新等级、旧等级、等级权益 2. 新等级、旧等级、下周期条件、降级原因 |
| rijoy_vip_progress_update | 等级周期中分数变化（如差多少升级） | 1. 新等级、旧等级、下周期条件、降级原因 2. 当前Tier、升级差额 |
| rijoy_referral_invitee_registered | 被邀请人成功注册 | 邀请人ID、奖励 |
| rijoy_referral_invitee_first_order | 被邀请人完成首单 | 1. 邀请人ID、奖励 2. 奖励积分、订单号 |
4. 管理特定事件同步
如需停止特定事件的数据同步：
- 进入"Rijoy Loyalty"的"Klaviyo Integration"配置页面
- 取消勾选不需要同步的事件类型
- 点击"Save"按钮保存配置
- 保存后，用户再次触发该事件时，将不再同步到Klaviyo
注意：
- 此操作仅停止未来事件的同步，不会删除历史已同步数据
- 如需恢复同步，只需重新勾选该事件并保存配置即可
- 建议定期审核同步的事件类型，确保只同步当前营销活动所需的必要数据
管理集成连接
断开连接
如需停止与Klaviyo的集成：
- 在Rijoy的Klaviyo集成配置页面
- 点击"Disconnect"按钮
- 确认后将会停止事件推送
注意：断开连接后，Klaviyo会保留过去的数据，不会进行自动删除。
💡 注意事项
- 每个Rijoy账户只能连接一个Klaviyo账户
- 集成成功后，用户细分组会自动创建，无需手动配置
- 事件同步遵循选择性原则，仅同步勾选的事件类型
- 建议根据营销需求，合理选择需要同步的事件，避免数据冗余
- 用户资料字段同步是实时的，确保Klaviyo中的用户画像保持最新状态