跳转到主要内容

将 Skio 与 Omnisend 集成

了解如何将日期从 Skio 同步到 Omnisend

作者:Edgaras Vaninas

Skio 是一个用于定期账单和订阅管理的 Shopify 订阅应用程序。将 Skio 连接到 Omnisend,以根据订阅和账单事件触发电子邮件和 SMS 自动化工作流。

集成还将订阅数据同步到联系档案,以便进行个性化、细分和快速操作。


开始之前

确保:

  • 您在 Shopify 商店中安装了活跃的 Skio 应用。

  • 您可以访问您的 Skio 仪表板。

  • 您可以访问您的 Omnisend 账户。

  • 您的 Skio 集成使用自定义 Webhook 集成。

该集成在所有 Omnisend 计划中均可用。 Skio 通过 Webhook 向 Omnisend 发送支持的事件。

重要的集成更新:

  • 2026年8月17日:扩展了从 Skio 同步的联系人属性,并增加了细分和快速操作支持。

  • 2026年8月26日:添加了四个支持的事件及其相关的特定于事件的联系人属性。本文中的事件名称也已更新以匹配当前格式。

如果您在 最新版本 之前连接了 Skio,请卸载并重新安装集成,配置支持的事件,并发送新的测试事件。如果您不重新连接,事件和联系人的属性可能会以不同的方式处理。

这些更新不会追溯应用,因此在您重新连接之前处理的数据不会自动更新。

好处

通过 Skio 集成,您可以:

  • 触发订阅和账单事件的电子邮件和 SMS 自动化工作流。

  • 将当前订阅信息同步到联系档案。

  • 使用同步的 skio_* 自定义属性细分联系人。

  • 使用订阅详细信息个性化消息。

  • 使用订阅 ID 创建快速操作链接,并在需要时使用快速操作令牌。

  • 在创建、取消、暂停、重新激活、续订、跳过或因账单失败、过期卡、变更账单日期或缺货商品而受到影响时,发送及时消息。

设置 Skio 集成

步骤 1:在 Omnisend 中连接 Skio

  1. 在 Omnisend 中,转到 应用市场

  2. 搜索 Skio

  3. 点击 立即连接

  4. 在 Skio 应用设置页面,复制在 自动化 下显示的 Webhook URL

保持 Webhook URL 可用。 您将在下一步中将其添加到 Skio。

步骤 2:在 Skio 中启用自定义 Webhook 集成

  1. 登录到您的 Skio 仪表板

  2. 转到 集成

  3. 找到 自定义 Webhook 集成

  4. 点击 启用

  5. 在自定义 Webhook 集成设置页面,将 Omnisend 的 Webhook URL 粘贴到此处。

  6. 点击 保存

  7. 确认集成状态显示 已连接

步骤 3:在 Skio 中添加和测试事件

  1. 在 Skio 的 自定义 Webhook 集成 页面,点击 + 添加事件

  2. 选择您要发送到 Omnisend 的事件。

  3. 添加每个事件后点击 发送测试

重要: Omnisend 注册一个自定义事件 仅在收到至少一个事件负载后。为您启用的每个事件发送测试。否则,该事件将不会作为可用触发器出现在 Omnisend 中。

步骤 4:确认 Omnisend 中的连接

  1. 返回 Omnisend 中的 Skio 应用设置页面。

  2. 确保 Skio – 订阅事件 被选中。

  3. 点击 更新设置

  4. 确认状态显示 已连接

事件首次触发后,您可以在 商店设置 API API 日志 中找到它。 事件数据也出现在相关的 联系档案 上。

支持的自定义事件

所有事件在 Omnisend 中以 Skio - 前缀加上事件名称的形式出现。

订阅生命周期事件

事件

触发时间

示例用法

Skio - 订阅创建

一位客户开始了一个新的订阅。

欢迎消息、入职和订阅提示。

Skio - 订阅取消

一位客户取消了他们的订阅。

挽回消息和取消反馈请求。

Skio - 订阅重新激活

一位客户重新激活了一个被取消的订阅。

确认消息和忠诚度优惠。

Skio - 订阅暂停

一位客户暂停了他们的订阅。

重新参与消息和暂停调查。

Skio - 订阅已恢复

一位客户恢复了一个暂停的订阅。

确认消息和即将发货的信息。

Skio - 订阅续订

订阅成功续订。

续订确认和相关产品推荐。

Skio - 订阅跳过

一位客户跳过了即将到来的订单。

跳过确认和下一个周期的产品推荐。

账单事件

事件

触发时间

示例用法

Skio - 账单尝试失败

账单尝试失败。

付款更新请求和账单恢复消息。

Skio - 卡片即将到期

一位客户的支付卡即将到期。

主动付款方式更新请求。

Skio - 下一个账单日期已更新

订阅的下一个账单日期更改。

账单提醒更新和日程变更确认。

库存事件

事件

当它触发时

示例用法

Skio - 缺货

一个订阅项目缺货。

替代通知和延迟通知。

事件属性

事件属性因事件而异。 它们通常包括:

  • subscriptionId – 唯一的订阅 ID。

  • email – 客户电子邮件地址。

  • status – 订阅状态。

  • domain – 创建订阅的商店域名。

某些事件可能会包含额外的事件特定值:

  • daysUntilExpiration 和paymentMethodLastDigits – 随附的Skio - 卡片即将到期 事件。

  • inventoryPolicy 和allProductsOutOfStock – 随附的Skio - 缺货 事件。

事件属性可在事件触发的 自动化工作流 中用于个性化。

例如:[[ event.subscriptionId ]] [[ event.status ]] [[ event.domain ]]

注意: 事件属性不适用于静态受众细分。请使用同步的skio_* 联系人属性进行细分。

传递给 Omnisend 的联系数据

Skio 发送标准 联系字段联系自定义属性 到 Omnisend。

标准联系字段

字段

描述

电子邮件地址

客户的电子邮件地址和主要标识符。

电话

客户的电话号码(如果提供)。目前未用作联系标识符。

始终最新的联系自定义属性

这些 自定义属性 在接收到支持的事件时更新。它们代表最新事件时订阅的当前状态。

自定义属性

描述

skio_subscriptionId

客户订阅的唯一 ID。

skio_status

当前订阅状态,例如 ACTIVEFAILEDCANCELLED

skio_qaToken

在快速操作身份验证配置需要时使用的快速操作链接的令牌。

skio_nextBillingDate

下一个计划的账单尝试日期。

skio_interval

账单频率单位,例如 WEEKMONTH

skio_intervalCount

账单尝试之间的间隔单位数量。

skio_skipCount

客户跳过订单的次数。

skio_cyclesCompleted

已完成的账单周期数量。

skio_remainingCyclesUntilRenewal

续订前剩余的周期数量(如适用)。

skio_manageSubscriptionUrl

客户管理其订阅的链接。

事件特定的联系属性

这些属性在相关事件发生时设置。 它们在后续事件后仍保留在联系档案中,并且不会被不相关的事件类型覆盖。

这使您能够查看联系人的订阅历史,例如取消后重新激活。

属性

设置时间

描述

skio_lastCancelledSubscriptionId

Skio - 订阅已取消 发生

包含在最新取消期间记录的订阅 ID。

skio_lastCancelledAt

Skio - 订阅已取消 发生。

包含最新取消的时间戳。

skio_lastCancellationReason

Skio - 订阅已取消 发生

包含客户声明的最新取消原因。

skio_lastFinalCancellationReason

Skio - 订阅已取消 发生

包含系统记录的最新取消的最终原因。

skio_lastReactivatedSubscriptionId

Skio - 订阅已重新激活 发生

包含在最新重新激活期间记录的订阅 ID。

skio_lastPausedSubscriptionId

Skio - 订阅已暂停 发生

包含在最新暂停期间记录的订阅 ID。

skio_daysTemporarilyPaused

Skio - 订阅已暂停 发生

包含订阅暂停的天数。

skio_lastBillingErrorCode

Skio - 账单尝试失败 发生

包含最新账单失败的错误代码。

skio_lastBillingErrorMessage

Skio - 账单尝试失败 发生

包含最新账单失败的人类可读消息。

skio_numberOfFailedAttempts

Skio - 账单尝试失败 发生

包含失败的账单尝试次数。

skio_daysUntilExpiration

Skio - 卡片即将到期 发生

包含支付卡到期前剩余的天数。

skio_paymentMethodLastDigits

Skio - 卡片即将到期 发生。

包含即将到期的支付方式的最后四位数字。

skio_inventoryPolicy

Skio - 缺货 发生。

包含受影响的订阅行的商店库存政策。

skio_allProductsOutOfStock

Skio - 缺货 发生。

指示订阅上的所有产品是否缺货。当值为 true 时,仅填充此属性。

在 Omnisend 中使用 Skio 数据

使用联系属性进行个性化

自定义联系属性使用以下语法:

[[contact.custom_properties.property_name]]

例如:

[[contact.custom_properties.skio_subscriptionId]] [[contact.custom_properties.skio_status]] [[contact.custom_properties.skio_nextBillingDate]]

您可以使用 个性化标签 菜单将这些属性插入到电子邮件、短信和推送消息中。

使用 Skio 数据进行细分

您可以使用任何同步的 skio_* 联系属性创建细分,包括:

  • skio_status

  • skio_interval

  • skio_intervalCount

  • skio_skipCount

  • skio_cyclesCompleted

  • skio_lastCancellationReason

  • skio_lastBillingErrorCode

  • skio_numberOfFailedAttempts

  • skio_daysUntilExpiration

  • skio_inventoryPolicy

  • skio_allProductsOutOfStock

例如,您可以创建一个联系人细分,其 skio_statusACTIVE,或一个包含一个或多个失败账单尝试的联系人细分。

使用快速操作

快速操作链接需要订阅 ID。 根据您的快速操作身份验证配置,该链接可能还需要 qaToken

集成将这些值存储为联系人属性:

  • skio_subscriptionId

  • skio_qaToken

在您的快速操作链接模板中使用联系人属性个性化语法。

仅限订阅 ID:

<your-quick-action-url>?subscriptionId=[[contact.custom_properties.skio_subscriptionId]]

带有快速操作令牌的订阅 ID:

<your-quick-action-url>?subscriptionId=[[contact.custom_properties.skio_subscriptionId]]&qaToken=[[contact.custom_properties.skio_qaToken]]

用您的快速操作配置提供的快速操作 URL 替换 。 仅在您的身份验证配置需要时包含 qaToken

常见问题

Skio 事件何时出现在 Omnisend 中?

Skio 通过 Webhook 实时将支持的事件发送到 Omnisend。 事件首次触发后,它会出现在 商店设置 API API 日志 和相关的联系人资料中。

所有 Skio 事件都会出现在 Omnisend 中吗?

否 Omnisend 仅处理包含有效电子邮件地址的事件。 没有电子邮件地址的事件会被跳过。

为什么我的 Skio 事件没有填充新的联系人属性?

最新的 Skio 集成更新仅在集成重新连接后可用。

如果您现有的 Skio 集成没有显示新的联系人属性或支持的事件:

  1. 从 Omnisend 卸载现有的 Skio 集成。

  2. 通过遵循本文中的设置步骤重新连接 Skio。

  3. 在 Omnisend 中启用 Skio – 订阅事件

  4. 在 Skio 中添加支持的事件。

  5. 为每个事件发送测试。

  6. 激活使用 Skio 事件的自动化工作流。

在重新连接的集成接收事件数据后,新的联系人属性和支持的事件将变得可用。之前的事件和属性不会自动填充。

我可以使用 Skio 事件属性进行细分吗?

否 事件属性仅在事件触发的自动化中可用于个性化。

您可以使用完整的同步 skio_* 联系人属性集对联系人进行细分,包括始终最新和特定于事件的属性。

Skio 会发送历史订阅数据吗?

否 Skio 发送在集成启用和配置后发生的事件。 历史订阅不会自动填充。


如果您没有找到问题的答案,请通过应用内聊天或联系 [email protected] 的支持团队。 我们的团队全天候提供服务。

这是否解答了您的问题?