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

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

开始之前

确保：

您在 Shopify 商店中安装了活跃的 Skio 应用。
您可以访问您的 Skio 仪表板。
您可以访问您的 Omnisend 账户。
您的 Skio 集成使用自定义 Webhook 集成。

该集成在所有 Omnisend 计划中均可用。 Skio 通过网络hooks将支持的事件发送到 Omnisend。

重要的集成更新：

2026年8月17日：扩展了从 Skio 同步的联系人属性，并增加了细分和快速操作支持。
2026年8月26日：添加了四个支持的事件及其相关的特定于事件的联系人属性。本文中的事件名称也已更新以匹配当前格式。
2026年10月14日：添加了Skio - 重新入库 和Skio - 账单提醒 事件，添加了新的电话和续订相关联系人属性，改善了下一个账单日期同步，并更改了allProductsOutOfStock 为仅事件数据。

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

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

好处

通过 Skio 集成，您可以：

触发订阅和账单事件的电子邮件和短信自动化工作流程。
将当前订阅信息同步到联系人资料。
使用同步的 skio_* 自定义属性细分联系人。
使用订阅详细信息个性化消息。
使用订阅 ID 创建快速操作链接，并在需要时使用快速操作令牌。
在创建、取消、暂停、重新激活、续订、跳过或因失败的账单尝试、即将到期的卡片、变更账单日期、即将续订、缺货商品或商品重新入库而受到影响时发送及时消息。

设置 Skio 集成

步骤 1：在 Omnisend 中连接 Skio

在 Omnisend 中，转到 应用市场。
搜索 Skio。
点击 立即连接。
在 Skio 应用设置页面，复制在 自动化 下显示的 Webhook URL。

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

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

登录到您的 Skio 仪表盘。
转到集成。
找到 自定义 Webhook 集成。
点击启用。
在自定义 Webhook 集成设置页面，粘贴来自 Omnisend 的 Webhook URL。
点击保存。
确认集成状态显示为 已连接。

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

在 Skio 的 自定义 Webhook 集成 页面，点击 + 添加事件。
选择您想要发送到 Omnisend 的事件。
添加每个事件后点击 发送测试。

重要： Omnisend 注册一个自定义事件 仅在接收到至少一个事件有效载荷后才会注册。对于每个启用的事件，请发送一个测试。否则，该事件将不会在 Omnisend 中显示为可用的触发器。

当您点击发送测试时，Skio 会将示例事件有效负载发送到 Omnisend。在 Omnisend 接收到事件后，您可以在商店设置 → API → API 日志中找到它。该事件随后作为自动化工作流触发器可用。

步骤 4：在 Omnisend 中确认连接

返回到 Omnisend 中的 Skio 应用设置页面。
确保选择了 Skio – 订阅事件。
点击 更新设置。
确认状态显示为 已连接。

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

支持的自定义事件

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

订阅生命周期事件

事件	触发时	示例用法
`Skio - 订阅创建`	客户开始新的订阅。	欢迎消息、入门和订阅提示。
`Skio - 订阅取消`	客户取消他们的订阅。	挽回消息和取消反馈请求。
`Skio - 订阅重新激活`	客户重新激活已取消的订阅。	确认消息和忠诚度优惠。
`Skio - 订阅暂停`	客户暂停他们的订阅。	重新参与消息和暂停调查。
`Skio - 订阅恢复`	客户恢复已暂停的订阅。	确认消息和即将发货的信息。
`Skio - 订阅续订`	订阅成功续订。	续订确认和相关产品推荐。
`Skio - 订阅跳过`	客户跳过即将到来的订单。	跳过确认和下一个周期的产品推荐。

账单事件

事件	触发时	示例用法
`Skio - 账单尝试失败`	账单尝试失败。	付款更新请求和账单恢复消息。
`Skio - 卡片即将到期`	客户的支付卡即将到期。	主动付款方式更新请求。
`Skio - 下一个账单日期更新`	订阅的下一个账单日期更改。	日程变更确认。
`Skio - 账单提醒`	订阅即将到期。	即将到来的续订提醒。

注意：账单提醒 在即将到来的订阅续订之前触发。下一个账单日期已更新 在订阅的账单日期更改时触发。

库存事件

事件	触发时	示例用法
`Skio - 缺货`	订阅项目缺货。	替代通知和延迟通知。
`Skio - 重新有货`	之前缺货的订阅项目再次可用。	可用性和发货通知。

事件属性

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

subscriptionId – 唯一的订阅 ID。
email – 客户电子邮件地址。
status – 订阅状态。
domain – 创建订阅的商店域名。

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

到期天数和paymentMethodLastDigits – 包含在Skio - 卡片即将到期 事件。
inventoryPolicy 和
backInStockItems – 包含在
skioSubscriptionDaysUntilRenewal,

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

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

注意： 事件属性在静态受众细分中不可用。使用同步的skio_* 联系人属性用于细分。

传递给 Omnisend 的联系人数据

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

标准联系人字段

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

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

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

自定义属性	描述
`skio_subscriptionId`	客户订阅的唯一 ID。
`skio_status`	当前订阅状态，例如 `ACTIVE`、`FAILED` 或 `CANCELLED`。
`skio_qaToken`	用于快速操作链接的令牌，当快速操作身份验证配置需要时。
`skio_nextBillingDate`	下一个计划账单尝试的日期。集成使用 `nextRenewalDate`（如果可用）并将 `nextBillingDate` 作为备用。
`skio_interval`	账单频率单位，例如 `WEEK` 或 `MONTH`。
`skio_intervalCount`	账单尝试之间的间隔单位数量。
`skio_skipCount`	客户跳过订单的次数。
`skio_cyclesCompleted`	已完成的账单周期数量。
`skio_remainingCyclesUntilRenewal`	到期前剩余的周期数（如适用）。
`skio_manageSubscriptionUrl`	客户管理其订阅的链接。
skio_phone	Skio 提供的电话号码。这被存储为自定义属性，并不会更新 Omnisend 的原生电话或 SMS 同意字段。
`skio_daysUntilRenewal`	距离即将续订的天数。
`skio_willRenewAt`	即将到来的续订时间已调整为订阅的时区。
`skio_paymentMethodBrand`	用于订阅的支付方式品牌。
`skio_paymentMethodInstrumentType`	用于订阅的支付工具类型。

事件特定联系属性

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

这允许您查看联系人的订阅历史，例如取消后重新激活。

属性	设置时间	描述
`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 - 缺货发生。	包含受影响的订阅行的商店库存政策。

在 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_daysUntilRenewal

例如，您可以创建一个联系人细分，其 skio_status 为 ACTIVE，或一个具有一个或多个失败账单尝试的联系人细分。

使用快速操作

快速操作链接需要订阅 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。

常见问题

是否在联系人资料上存储 allProductsOutOfStock？

否 allProductsOutOfStock 作为 Skio - 缺货 事件的事件属性可用。它不会作为永久联系人属性存储，也不能用于细分。

Skio 事件何时出现在 Omnisend 中？

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

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

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

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

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

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

从 Omnisend 卸载现有的 Skio 集成。
按照本文中的设置步骤重新连接 Skio。
在 Omnisend 中启用 Skio – 订阅事件。
在 Skio 中添加支持的事件。
为每个事件发送测试。
激活使用 Skio 事件的自动化工作流。

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

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

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

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

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

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

如果您没有找到问题的答案，请通过应用内聊天或联系 [email protected] 的支持团队。我们的团队全天候 24/7 可用。

将 Skio 与 Omnisend 集成