基于 API 的入口
工作原理
Anchor link to基于 API 的入口允许您在特定业务事件发生时立即启动客户旅程。要开始一个营销活动，您必须发送一个特殊的 API 请求。
以下是基于 API 的入口的一些用例：
- 通知客户产品何时补货
- 告诉用户热门产品的价格已下降
- 通知订阅者新的播客剧集已发布
与常规事件不同，所有这些业务事件都可能发生在应用之外。例如，产品的可用性只能在外部数据库中检查。这时，基于 API 的入口就派上用场了：您可以设置在应用外部发生某些变化时（例如，在您的外部数据库中）发送请求以启动旅程。
其工作方式如下：
- 创建一个带有基于 API 的入口的旅程。在入口设置中，您将找到启动旅程的请求模板。
- 使用 细分语言 向请求添加细分条件。您还可以向请求添加内容占位符，以根据上下文更改消息内容。
- 如果需要，可以自动化该请求。例如，有关价格变化的信息可以立即从数据库发送到 webhook。一旦发生这种情况，webhook 应自动发送请求以启动旅程。如果您不需要自动化，也可以手动发送请求。
您可以无限次地发送请求来更改细分条件或消息内容。
有关更多详细信息，请遵循以下说明。
设置带有基于 API 的入口的旅程
Anchor link to- 创建一个带有基于 API 的入口的旅程：
-
双击基于 API 的入口步骤。入口配置窗口将打开。
-
您可以通过使用内容占位符，在每次启动旅程时修改推送和电子邮件内容。每个占位符的值都可以在请求中更改。如果您不需要此选项，可以跳过此步骤。
例如，您正在创建一个旅程，以在新的播客剧集发布时通知订阅者。使用内容占位符，您可以在每次启动旅程时更改播客标题。
首先，在基于 API 的入口设置窗口中添加占位符名称。您可以使用任何方便您的名称。
现在，创建一个推送预设或电子邮件内容，并将占位符插入到您想要修改的文本位置。根据您的需求，占位符必须是以下格式之一：
{placeholder_name|format_modifier|}– 如果在启动营销活动时未指定占位符的值，用户将在其位置看到空白。{placeholder_name|format_modifier}– 如果未指定占位符的值，并且之前也未分配给用户（如果您使用标签作为占位符），则不会发送消息。
格式修饰符
- CapitalizeFirst – 将占位符值中的第一个字母大写
- CapitalizeAllFirst – 将占位符值中所有单词的首字母大写
- UPPERCASE – 将所有字母切换为大写
- lowercase – 将所有字母切换为小写
- regular – 完全按照请求中指定的方式插入占位符值
在您的旅程中配置推送或电子邮件元素时，选择创建的预设并打开 使用事件属性个性化消息 选项。
选择您想在启动旅程时在请求中修改的占位符。选择 基于 API 的入口 作为来源，并选择占位符名称作为动态属性：
单击 应用 以保存更改。
- 在入口配置窗口中，复制请求模板以进行修改：
例如，要定位将 Socks 商品添加到其 Wishlist 的用户，"filter" 值必须如下所示：
"filter": "A(\"12345-12345\") * "T(\"Wishlist\", EQ, \"Socks\")"
在此示例中，您必须在您的应用中配置一个 Wishlist 标签。
- 如果您设置了占位符，请将所需内容指定为其值：
- 如果您计划频繁重启您的营销活动，并且不希望同一用户多次进入旅程，请设置营销活动入口限制。
例如，您创建了一个营销活动，以通知用户特定产品的降价信息。您希望通过发送几个具有不同受众过滤器的请求来重新启动几次旅程。在这种情况下，您可以添加营销活动入口限制，这样通知就不会重复发送给匹配多个过滤器的用户。
- 如果您希望每当某个业务事件发生时就启动一个旅程，请使用 webhook 自动化请求。一旦事件发生，webhook 应自动发送请求以启动旅程。
如果您不需要自动化，也可以手动发送请求。