ReferralCandy 是一个为电子商务品牌打造的推荐营销平台。它让您运行 "推荐朋友" 计划，客户通过引入新买家来赚取奖励。
通过将 ReferralCandy 与 Omnisend 连接，您可以将推荐计划活动转化为联系人事件 – 这样您就可以触发自动邮件或短信（SMS），并根据推荐计划内部发生的事情构建细分。
在本文中，您将学习如何将 ReferralCandy 连接到 Omnisend，启用三种可用的自动化，并使用它们发送的数据。
开始之前
您需要一个 活跃的 Omnisend 账户。
您需要一个活跃的 ReferralCandy 账户，并且正在进行的推荐营销活动（Campaign）。
您的 ReferralCandy API 凭证 （API 访问 ID 和 API 密钥）是验证连接所必需的。您可以在您的 ReferralCandy 仪表盘中找到它们，路径为 账户 API 令牌。
好处
自动化您的推荐计划沟通： 在倡导者注册、推荐购买确认或奖励获得的瞬间触发电子邮件或短信（SMS）。
立即发放奖励： 奖励获得事件有效载荷包括优惠券代码、描述和到期日期 - 这样您就可以直接从自动化流程（Automation）发送奖励。
构建目标细分：识别已经获得奖励的倡导者、至少推荐过一个朋友的联系人，或尚未推动任何购买的倡导者。
它是如何工作的
集成每12小时（从您启用每个自动化流程的时间开始）轮询ReferralCandy，并将新活动作为自定义事件发送到Omnisend。每个事件都与 Omnisend 中相关的联系人（倡导者）关联。
以下事件已从 ReferralCandy 同步到 Omnisend：
Omnisend中的事件名称 | 火灾发生时 |
| 推荐朋友的购买归因于一位倡导者 |
| 一位新的倡导者加入了推荐计划 |
| 一名倡导者获得奖励 |
事件将在 Omnisend 中显示，最多在活动发生后 12 小时 内出现在 ReferralCandy 中。只有在您启用自动化流程后发生的活动会流通；过去的推荐历史不会被填充。
设置过程
步骤 1.获取您的 ReferralCandy API 凭证
登录到您的 ReferralCandy 账户。
前往 账户 API 令牌.
复制您的 API 访问 ID 和 API 密钥。
步骤 2.将 ReferralCandy 连接到 Omnisend
登录到您的 Omnisend 账户并转到 应用。
搜索 ReferralCandy 并打开应用程序。
在相应的字段中输入您的 API 访问 ID 和 API 密钥，然后点击 连接。
Omnisend 将会验证您的凭据与 ReferralCandy。一旦确认，您将看到应用名称旁边有一个 已连接 徽章。
步骤 3.启用自动化
连接后，您将看到一个 自动化 部分，里面有三个切换开关。打开您想要使用的选项：
ReferralCandy - 推荐完成 →Omnisend
ReferralCandy - 倡导者已注册 →Omnisend
ReferralCandy - 获得的奖励→Omnisend
每个自动化流程都是独立的 – 仅启用与您的设置相关的流程。一旦开启，自动化流程每12小时开始轮询ReferralCandy。
就是这样！ReferralCandy 现在将自动将新的推荐事件发送到 Omnisend。
传递了什么数据
每个自动化流程向Omnisend发送一个带有一组属性的自定义事件。每个事件包括以下内容：
ReferralCandy - 倡导者已注册
当新的倡导者加入您的推荐计划时触发。该事件与 Omnisend 中的 倡导者 联系人关联。
财产 | 描述 |
| Advocate的ReferralCandy ID |
| 律师的电子邮件（Email）地址 |
| 倡导者的名字 |
| 律师的姓氏 |
| 倡导者是否进行了购买 ( |
| 倡导者购买的数组 |
| ReferralCandy 对该联系人的退订标志 ( |
示例有效负载：
{ "id": 430711176, "first_name": "first", "last_name": "last", "email": "[email protected]", "purchase_made": false, "purchases": [], "unsubscribed": false }
ReferralCandy - 推荐完成
当推荐的朋友的购买被归因于倡导者时触发。该事件与 倡导者 的联系人关联 – 这样当他们推荐的联系人进行购买时，您可以给他们发送消息。
财产 | 描述 |
| 律师的电子邮件（Email）地址 |
| 被推荐朋友的电子邮件（Email）地址 |
| 推荐发生的时间（Unix 时间戳） |
| 推荐营销活动（Campaign）ID |
| ReferralCandy 对此推荐的审核期是否已结束（ |
| 所提及购买的店铺订单ID |
示例有效负载：
{ "campaignId": 125143, "external_reference_id": "1480", "referral_email": "[email protected]", "referral_timestamp": 1781607304, "referring_email": "[email protected]", "review_period_over": true }
ReferralCandy - 奖励已获得
在推荐人的审核期结束后，当倡导者获得奖励时触发。该事件与 倡导者 的联系人关联。
属性 | 描述 |
| 倡导者的电子邮件（Email）地址 |
| 倡导者的姓名 |
| 奖励类型（例如） |
| 人类可读的奖励描述（例如，"€50 折扣"） |
| 奖励优惠券代码 |
| 优惠券过期日期（Unix 时间戳） |
| 优惠券是否已被兑换（ |
| 奖励状态（例如） |
| 奖励获得的时间（Unix 时间戳） |
| 奖励 ID |
| 链接到基础的 Shopify 折扣 |
示例有效负载：
{ "advocate_email": "[email protected]", "advocate_name": "Advocate Name", "coupon_code": "THANKS-XXXXXX", "coupon_code_data": { "shopify_graphql_discount_code_id": "gid://shopify/DiscountCodeNode/0000000000" }, "coupon_code_expiry_timestamp": 1786792518, "coupon_used": false, "created_at": 1781608518, "description": "a €50 discount", "id": 7427724, "status": "delivered", "type": "coupon" }注意： 每个事件使用不同的字段名称来表示倡导者的电子邮件（Email）地址。当构建跨多个事件的细分或工作流时，请为每个事件使用正确的字段。
事件 | 倡导者电子邮件（Email）字段 |
倡导者注册 |
|
推荐完成 |
|
奖励已获得 |
|
被推荐朋友的电子邮件（Email）(referral_email) 仅在 推荐完成 事件中可用。
构建自动化工作流程
一旦集成激活，请在Omnisend自动化流程中使用自定义事件作为触发器：
已注册倡导者 → 发送一封欢迎电子邮件（Email），解释推荐计划的运作方式，并分享倡导者的推荐链接。
推荐完成 通知倡导者，他们推荐的联系人刚刚进行了购买，从而强化该行为。
奖励已获得 → 电子邮件（Email）通知倡导者他们的奖励。事件有效负载包括优惠券代码（
优惠券代码），描述（描述），和过期日期（优惠券过期时间戳）。
您还可以使用这些事件进行 联系人细分 – 例如，"获得至少一个奖励的支持者" 或 "尚未完成推荐的支持者" 用于重新参与营销活动（Campaign）。
注意事项
事件不是即时的。 集成每12小时轮询一次ReferralCandy。预计事件将在ReferralCandy中发生活动后的12小时内出现在Omnisend中。
没有历史回填。 启用自动化不会重播过去的推荐活动。只有在启用后发生的事件会流入Omnisend。
没有重复事件。 每个推荐、奖励和倡导者注册仅发送一次到Omnisend。集成跟踪已经同步的内容。
未获得市场营销同意许可。 通过此集成创建的联系人被设置为默认情况下为未订阅。在通过Omnisend 订阅表单（Signup Form）选择加入之前，他们将不会收到营销电子邮件或短信（SMS）。
奖励时机。 奖励已获得事件仅在 ReferralCandy 的审核期结束后触发。这意味着奖励已获得将始终在同一推荐的推荐完成之后到达。
只读。 集成从ReferralCandy读取数据。它不会将任何内容写回到ReferralCandy。
故障排除
事件未在 Omnisend 中显示
查看此订单：
ReferralCandy 记录了吗？ 转到在您的 ReferralCandy 账户中查看 购买与推荐 并确认推荐是否已归属或奖励是否存在。如果没有，问题出在 ReferralCandy 方面。
是否已经运行了轮询？ 事件在下一个 12 小时轮询后出现。在假设有问题之前，请等待完整的间隔。
自动化已启用吗？ 确认相关的自动化在Omnisend中已开启。
凭证仍然有效吗？ 如果您的 API 访问 ID 或 API 密钥在 ReferralCandy 中被更换，请使用新凭证更新 Omnisend 中的连接。
奖励尚未到达，但推荐已完成
这是预期的。奖励已获得仅在 ReferralCandy 的审核期结束后触发。从推荐完成到奖励获得之间的延迟是正常的。
常见问题
新联系人会获得什么订阅状态？
通过此集成创建的联系人默认设置为未订阅。在通过Omnisend 订阅表单（Signup Form）选择加入之前，他们将不会收到营销电子邮件或短信（SMS）。
我可以只运行三项自动化中的某些吗？
可以。每个自动化流程都是独立的。仅启用您需要的选项，其他选项保持关闭。
我可以在自动化流程中使用推荐朋友的电子邮件吗？
被推荐朋友的电子邮件（Email） (referral_email) 包含在推荐完成事件的有效负载中。然而，该事件与 倡导者 的联系人关联 – 而不是朋友的。要直接给朋友发送消息，您需要单独为他们创建一个联系人。
集成是否同步历史推荐数据？
否 在您启用自动化后发生的唯一活动会发送到Omnisend。过去的推荐和奖励不会被回填。
在我的店铺发生了推荐，但在 Omnisend 中没有收到任何事件。我应该检查什么？
首先，检查 ReferralCandy 是否将推荐归因于某个倡导者。如果ReferralCandy的欺诈检测阻止了归因（例如，自我推荐），则不会向Omnisend发送任何事件——该结果完全由ReferralCandy决定。
我可以在电子邮件（Email）活动中使用这些事件吗？
这些事件被设计为自动化工作流程的触发器。要发送一次性营销活动（Campaign），请根据自定义事件创建一个细分（Segment）（例如，具有 ReferralCandy - Reward Earned 事件的联系人），并向该细分（Segment）发送营销活动（Campaign）。
卡住了或不确定接下来该做什么？ 随时通过应用内聊天或在联系到我们的支持团队。[email protected]。有关 ReferralCandy 特定问题，请联系ReferralCandy支持