以下用例说明如何使用工作流中的参数调用工作流。
其目标是使用外部参数从API调用触发工作流。 此工作流将从文件将数据加载到数据库并创建关联受众。 创建受众后,将触发第二个工作流,以发送使用API调用中定义的外部参数个性化的消息。
要执行此用例,您需要执行以下操作:
在配置工作流之前,您需要创建每个活动都带有External signal的工作流1和2。 这样,您就可以在调用工作流时目标这些信号活动。
进行API调用以触发包含参数的Workflow 1。 有关API调用语法的详细信息,请参阅Campaign StandardREST API文档。
在我们的案例中,我们希望使用以下参数调用工作流:
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<TRIGGER_URL>
-H 'Authorization: Bearer <ACCESS_TOKEN>'
-H 'Cache-Control: no-cache'
-H 'X-Api-Key: <API_KEY>'
-H 'Content-Type: application/json;charset=utf-8'
-H 'Content-Length:79'
-i
-d {
-d "source:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }
工作流1的构建如下:
请按照以下步骤配置工作流:
声明已在API调用中定义的参数。 为此,请打开External signal活动,然后添加参数的名称和类型。
添加Transfer file活动以将数据导入活动库。要执行此操作,请拖放,将其打开,然后选择Protocol选项卡。
选择Use a dynamic file path选项,然后使用fileToTarget参数作为要传输的文件:
$(vars/@fileToTarget)
将数据从文件加载到数据库中。
为此,请将Load file活动拖放到工作流中,然后根据需要配置它。
插入数据库并使用导入文件中的数据更新数据库。
要执行此操作,请拖放Update data活动,然后选择Identification选项卡以添加协调条件(在我们的情况下,为email字段)。
选择Fields to update选项卡,然后指定要在数据库中更新的字段(在我们的情况下为firstname和email字段)。
检查是否从文件检索到数据。 为此,请将Test活动拖放到工作流中,然后单击Add an element按钮以添加条件。
命名并定义条件。 在我们的例子中,我们希望测试出站过渡是否包含具有以下语法的数据:
$long(vars/@recCount)>0
如果检索到数据,则将其保存到受众中。 为此,请向活动添加Save audience目标,而不是空过渡,然后打开它。
选择Use a dynamic label选项,然后使用fileToTarget参数作为受众的标签:
$(vars/@fileToTarget)
拖放一个End活动,它将使用参数调用Workflow 2,然后打开它。
选择External signal选项卡,然后指定要触发的工作流及其关联的信号活动。
定义要在工作流2中使用的参数及其关联值。
在我们的情况下,我们希望传递最初在API调用中定义的参数(fileToTarget和discountDesc),以及具有常量值("20% discount")的附加segmentCode参数。
工作流1已配置,您现在可以构建工作流2。 如需详细信息,请参阅此部分。
工作流2将构建如下:
请按照以下步骤配置工作流:
声明已在工作流1中定义的参数。
为此,请打开External signal活动,然后添加在工作流1的End活动中定义的每个参数的名称和类型。
使用已保存在工作流1中的受众。 要执行此操作,请将Read audience活动拖放到工作流中,然后打开它。
选择Use a dynamic audience选项,然后使用fileToTarget参数作为要读取的受众的名称:
$(vars/@fileToTarget)
根据segmentCode参数命名出站过渡。
要执行此操作,请选择Transition选项卡,然后选择Use a dynamic segment code选项。
使用segmentCode参数作为出站过渡的名称:
$(vars/@segmentCode)
拖放Email delivery活动以向受众发送消息。
确定消息中使用的参数,以便使用discountDesc参数对其进行个性化设置。 为此,请打开活动的高级选项,然后添加参数名和值。
您现在可以配置消息。 打开活动,然后选择Recurring email。
选择要使用的模板,然后根据您的需要定义电子邮件属性。
将discountDesc参数用作个性化字段。 要执行此操作,请从“个性化字段”列表中选择它。
您现在可以完成消息的配置,然后照常发送。
构建工作流后,即可执行它们。 在执行API调用之前,请确保已启动两个工作流。