跳到内容
开发者文档支持 请求演示 登录
Pushwoosh.com

基于 API 的入口

基于 API 的入口允许您在特定业务事件发生时立即启动 Customer Journey。要开始营销活动，您必须发送一个特殊的 API 请求。

以下是基于 API 入口的几个用例：

  • 通知客户产品何时补货
  • 告知用户热门产品已降价
  • 通知订阅者新的播客节目已发布

与常规 Event 不同，所有这些业务事件都可能发生在应用之外。例如，产品的可用性只能在外部数据库中检查。这时，基于 API 的入口就派上用场了：您可以设置在应用外部（例如，在您的外部数据库中）发生某些更改时发送请求以启动 Journey。

Journey 画布上的基于 API 的入口元素

其工作原理如下：

  1. 创建一个基于 API 入口的 Journey。在入口设置中，您将找到启动 Journey 的请求模板。
  2. 使用分段语言向请求添加分段条件。您还可以向请求添加内容占位符，以根据上下文更改消息内容。
  3. 如果需要，可以自动化该请求。例如，有关价格变化的信息可以立即从数据库发送到 webhook。一旦发生这种情况，webhook 应自动发送请求以启动 Journey。如果您不需要自动化，也可以手动发送请求。

您可以无限次发送请求来更改分段条件或消息内容。

有关更多详细信息，请遵循以下说明。

设置基于 API 入口的 Journey

Anchor link to
  1. 创建一个基于 API 入口的 Journey：

  1. 双击基于 API 的入口步骤。入口配置窗口将打开。

  2. 您可以在每次启动 Journey 时使用内容占位符修改推送和电子邮件内容。每个占位符的值都可以在请求中更改。如果您不需要此选项，可以跳过此步骤。

例如，您正在创建一个 Journey，以便在新播客节目发布时通知订阅者。使用内容占位符，您可以在每次启动 Journey 时更改播客标题。

首先，在基于 API 的入口设置窗口中添加占位符名称。您可以使用任何方便您的名称。

在基于 API 的入口设置窗口中添加内容占位符名称

现在，创建一个推送预设或电子邮件内容，并插入占位符来代替您想要修改的文本。根据您的需要，占位符必须采用以下格式之一：

  • {placeholder_name|format_modifier|} – 如果在启动营销活动时未指定占位符值，用户将在其位置看到空白。
  • {placeholder_name|format_modifier} – 如果未指定占位符值且尚未分配给用户（如果您使用 Tag 作为占位符），则不会发送消息。
格式修饰符
  • CapitalizeFirst – 将占位符值中的首字母大写
  • CapitalizeAllFirst – 将占位符值中所有单词的首字母大写
  • UPPERCASE – 将所有字母切换为大写
  • lowercase – 将所有字母切换为小写
  • regular – 完全按照请求中指定的方式插入占位符值
将占位符插入推送预设以实现动态内容

在 Journey 中配置推送或电子邮件元素时，选择创建的预设并打开 使用事件属性个性化消息 选项。

选择您想在启动 Journey 时在请求中修改的占位符。选择 基于 API 的入口 作为来源，并选择占位符名称作为动态属性：

点击 应用 保存更改。

  1. 在入口配置窗口中，复制请求模板以进行修改：
从基于 API 的入口配置窗口复制请求模板
  1. 使用分段语言向 "filter" 参数添加受众筛选器，或从您的分段中复制分段语言。请提前设置必要的 Tags。

例如，要定位将 Socks 项目添加到其 Wishlist 的用户，"filter" 值必须如下所示：

"filter": "A(\"12345-12345\") * "T(\"Wishlist\", EQ, \"Socks\")"

在此示例中，您必须在您的应用中配置一个 Wishlist Tag。

  1. 如果您已设置占位符，请将其值指定为所需内容：
在 API 请求中指定占位符值以启动 Journey
  1. 如果您计划频繁重启营销活动，并且不希望同一用户多次进入 Journey，请设置营销活动入口限制。

例如，您创建了一个营销活动，以通知用户特定产品的降价信息。您希望通过发送几个具有不同受众筛选器的请求来重新启动 Journey 几次。在这种情况下，您可以添加入口限制，这样通知就不会重复发送给匹配多个筛选器的用户。

  1. 如果您希望每当某个业务事件发生时就启动一个 Journey，请使用 webhook 自动化该请求。一旦事件发生，webhook 应自动发送请求以启动 Journey。

如果您不需要自动化，也可以手动发送请求。