执行API触发的营销活动 execute

激活营销活动后,您需要检索生成的示例cURL请求,并将其用于API中以构建有效负载并触发营销活动。

必读 must-read

  • 促销活动开始/结束日期 — 如果您在创建促销活动时配置了特定的开始和/或结束日期,则不会在这些日期之外执行,并且API调用将失败。

  • 调用超时 — 对交互式消息执行REST API的调用超时60秒。 但是,如果意外超时,则进行内部重试以确保投放。

触发活动 trigger

  1. 打开营销活动,然后从​ cURL请求 ​部分复制并粘贴有效负载请求。 此有效负载包含消息中使用的所有个性化(用户档案和上下文)变量。 活动开始后,即可使用该功能。

    note important
    IMPORTANT
    cURL部分中的端点在标准和高吞吐量营销活动之间有所不同。
  2. 将此cURL请求用到API中以构建有效负载并触发营销活动。 有关详细信息,请参阅交互式消息执行API文档,其中列出了标准和高吞吐量营销活动的所有端点。

    此页面上也提供了API调用示例。

故障排除 troubleshooting

Azure Cosmos DB身份验证错误(500内部服务器错误) cosmosdb-auth-errors

如果您在触发API触发的营销活动时遇到​500内部服务器错误,并且系统日志显示来自Azure Cosmos DB的​ 403 Forbidden ​错误,并显示一条消息,例如:

“由于Azure Cosmos DB服务无法获取帐户默认身份的AAD身份验证令牌,因此对您帐户的访问当前被撤销”

此错误通常发生在Cosmos DB身份验证所需的Azure服务主体已禁用、删除或配置错误时。

如何解决此问题
  1. 验证您的Azure服务主体 — 确保您的Azure服务主体或托管标识已启用,并且尚未在Azure Active Directory中禁用或删除。

  2. 检查权限 — 确认服务主体具有访问Azure Key Vault和Cosmos DB资源的必要权限。 服务主体必须具有适当的角色分配,才能通过Azure Cosmos DB进行身份验证。

  3. 查看Azure Cosmos DB CMK配置 — 如果您使用的是客户管理的密钥(CMK),请查阅Azure Cosmos DB CMK疑难解答指南,以了解恢复AAD令牌获取的详细步骤。

  4. 重新启用并测试 — 更正配置后,重新启用服务主体(如果已禁用),并重新测试事务性营销活动API调用,以确认身份验证成功且消息已投放。

note note
NOTE
此问题通常是由错误配置或意外禁用Cosmos DB身份验证所需的Azure服务主体导致的。 保持服务主体已启用且配置正确将防止将来出现此错误。
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76