使用信号触发编排的营销活动 trigger-signal
您可以通过发送信号而不是按计划运行来触发编排的营销活动。 信号通过来自外部系统或应用程序的API调用发送。 使用信号时,可以传递参数。 然后,它们可在编排的营销活动中作为执行上下文中的事件变量使用 — 用于定位、条件或表达式。
使用信号触发编排营销活动的端到端流程:
orchestrated-campaign.publish)。 查看内置权限。计划由信号触发的营销活动 configure-signal
要将编排的营销活动设置为在信号而不是计划上启动,请执行以下步骤:
-
使用信号打开要触发的已编排营销活动。
-
打开计划配置。 了解如何计划编排的营销活动。
-
选择 由信号 触发,以便营销活动等待信号而不是按计划运行。
{modal="regular"}
添加信号有效负载的参数(可选) parameters
您可以在触发信号中传递参数,并在执行上下文中的促销活动中使用这些参数,例如,在定位、条件或表达式中。 首先在计划设置中定义每个参数,然后在调用触发器API时传递其值。
-
打开活动计划程序并选择添加参数。
-
定义要在信号有效负载中发送的每个参数的名称和数据类型。 您还可以提供在测试模式下触发营销活动时将使用的测试值。 了解如何测试触发的营销活动。
{modal="regular"}
构建和测试活动 build-and-test
在画布上构建营销活动,然后(可选)在发布之前通过API触发信号,以草稿形式测试营销活动。
-
在画布上添加并连接活动(受众、定位、投放)。 了解如何精心策划营销活动
-
如果您在信号中定义了参数,则可以将它们引入画布逻辑(例如,在条件或定位中)。 在此示例中,“channel”参数用作 测试 活动中的条件。
要在表达式编辑器中使用信号参数(例如,在 构建受众 活动中构建查询),请在表达式字段中键入
$(vars/@<parameterName>)。 将<parameterName>替换为调度程序中定义的参数名称,例如$(vars/@channel)。 了解如何使用表达式编辑器。 -
打开活动计划程序,选择复制API请求,然后选择格式(cURL或HTTP请求)。
复制的信息包括编排的营销活动ID、沙盒名称、组织ID以及参数的测试值(如果您已添加某些值)。
在计划配置中
accordion 带参数和测试值的示例cURL请求 code language-bash POST https://platform.adobe.io/ajo/campaign-orchestration/orchestratedCampaigns/1c7529c7-7a8c-491a-a2c6-3d8131d2e17d/trigger Headers: Authorization: Bearer ## Access token ## Content-Type: application/json x-api-key: ## Provide API Key here ## x-api-version: 1 x-gw-ims-org-id: 123456ABCDEFG@LumaOrg x-sandbox-name: prod Body: { "variables": { "channel": "sms" } } -
单击 开始 以开始营销活动。
-
使用您从调度程序复制的示例请求发送触发器API调用。
如果对测试结果满意,发布营销活动。
发布并触发营销活动 publish
在您构建并测试营销活动后,发布该营销活动以便从您的应用程序触发它。
-
在营销活动画布中单击发布。 必须先发布营销策划,然后才能从外部系统触发它。 了解有关启动和监视营销活动的更多信息。
-
打开活动计划程序,选择复制API请求,然后选择格式(cURL或HTTP请求)。
复制的信息包括编排的营销活动ID、沙盒名称、组织ID和参数(如果您已添加某些内容)。
-
从系统中调用触发器API。
note important IMPORTANT 对于实时编排的营销活动,限制护栏强制在两个API触发器执行之间有最小一小时间隔。 如果您在该间隔过去之前再次调用API,则API返回 HTTP 429 错误(请求过多)。 触发草稿版本进行测试时,不应用此护栏。 如果您向信号有效负载添加了参数,则在营销活动运行时,您在API调用中传递的值将显示为营销活动事件变量。 要检查这些活动,请从活动画布工具栏中打开活动日志。 在 任务 选项卡中,识别与信号对应的任务,然后单击铅笔图标以访问相关事件变量。 了解如何访问日志和任务。
{modal="regular"}