用例

以下用例说明如何使用工作流中的参数调用工作流。

其目标是使用外部参数从API调用触发工作流。 此工作流将从文件将数据加载到数据库并创建关联受众。 创建受众后,将触发第二个工作流以发送个性化的消息,该消息使用在API调用中定义的外部参数。

要执行此用例,您需要执行以下操作:

  1. 进行API调 用以触发具有外部参数的工作流1。请参阅步骤1:配置API调用
  2. 构建工作流1:该工作流将传输一个文件并将其加载到数据库中。然后,它将测试数据是否为空,并最终将用户档案保存到受众中。 最后,它将触发工作流2。 请参阅步骤2:配置工作流1
  3. 构建工作流2:该工作流将读取在工作流1中创建的受众,然后向用户档案发送个性化消息,并使用参数自定义的段代码。请参阅步骤3:配置工作流2

先决条件

在配置工作流之前,您需要创建每个活动都带有​External signal​的工作流1和2。 这样,您就能够在调用目标时工作流这些信号活动。

第1步:配置API调用

进行API调用以触发包含参数的Workflow 1。 有关API调用语法的详细信息,请参阅Campaign StandardREST API文档

在本例中,我们要使用以下参数调用工作流:

  • fileToTarget:要导入到数据库的文件的名称。
  • 折扣设计:要在投放中显示的折扣描述。
-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 } 

第2步:配置工作流1

工作流1将按如下方式构建:

  • External signal 活动:其中必须声明外部参数才能在工作流中使用。
  • Transfer file 活动:导入具有参数中定义的名称的文件。
  • Load file 活动:将数据从导入的文件加载到数据库。
  • Update data 活动:插入或更新导入文件中的数据。
  • Test 活动:检查是否导入了数据。
  • Save audience 活动:如果文件包含用户档案,则将数据保存到受众中。
  • End activity 活动:调用工作流2,其中包含您要使用的参数。

请按照以下步骤配置工作流:

  1. 声明在API调用中定义的参数。 为此,请打开​External signal​活动,然后添加参数的名称和类型。

  2. 添加​Transfer file​活动以将数据导入活动库。要执行此操作,请拖放,打开它,然后选择​Protocol​选项卡。

  3. 选择​Use a dynamic file path​选项,然后使用​fileToTarget​参数作为要传输的文件:

    $(vars/@fileToTarget)
    

  4. 将数据从文件加载到数据库。

    为此,请将​Load file​活动拖放到工作流中,然后根据您的需要配置它。

  5. 插入数据库并用导入文件中的数据更新数据库。

    为此,请拖放​Update data​活动,然后选择​Identification​选项卡以添加协调条件(在我们的情况下为​email​字段)。

  6. 选择​Fields to update​选项卡,然后指定要在数据库中更新的字段(在我们的例子中为​firstname​和​email​字段)。

  7. 检查是否从文件检索数据。 为此,请将​Test​活动拖放到工作流中,然后单击​Add an element​按钮以添加条件。

  8. 命名并定义条件。 在本例中,我们要测试出站过渡是否包含具有以下语法的数据:

    $long(vars/@recCount)>0
    

  9. 如果检索到数据,则将其保存到受众中。 为此,请将​Save audience​活动添加到​目标中(不为空​过渡),然后打开它。

  10. 选择​Use a dynamic label​选项,然后使用​fileToTarget​参数作为受众的标签:

    $(vars/@fileToTarget)
    

  11. 拖放一个​End​活动,它将用参数调用Workflow 2,然后打开它。

  12. 选择​External signal​选项卡,然后指定要触发的工作流及其关联的信号活动。

  13. 定义要在工作流2中使用的参数及其关联值。

    在我们的情况下,我们希望传递最初在API调用中定义的参数(fileToTarget​和​discountDesc),以及一个额外的具有常量值(“20%折扣”)的​segmentCode​参数。

工作流1已配置,您现在可以构建工作流2。 如需详细信息,请参阅此部分

第3步:配置工作流2

工作流2将按如下方式构建:

  • External signal 活动:其中必须声明参数才能在工作流中使用。
  • Read audience 活动:读取在工作流1中保存的受众。
  • Email delivery 活动:向目标受众发送重复消息,并使用参数进行个性化。

请按照以下步骤配置工作流:

  1. 声明已在工作流1中定义的参数。

    为此,请打开​External signal​活动,然后添加在Workflow 1的​End​活动中定义的每个参数的名称和类型。

  2. 使用已保存在Workflow 1中的受众。 为此,请将​Read audience​活动拖放到工作流中,然后打开它。

  3. 选择​Use a dynamic audience​选项,然后使用​fileToTarget​参数作为要读取的受众的名称:

    $(vars/@fileToTarget)
    

  4. 根据​segmentCode​参数命名出站过渡。

    为此,请选择​Transition​选项卡,然后选择​Use a dynamic segment code​选项。

  5. 使用​segmentCode​参数作为出站过渡的名称:

    $(vars/@segmentCode)
    

  6. 拖放​Email delivery​活动以向受众发送消息。

  7. 确定消息中使用的参数,以使用​discountDesc​参数对其进行个性化设置。 为此,请打开活动的高级选项,然后添加参数名称和值。

  8. 您现在可以配置消息。 打开活动,然后选择​Recurring email

  9. 选择要使用的模板,然后根据您的需要定义电子邮件属性。

  10. 将​discountDesc​参数用作个性化字段。 为此,请从个性化字段列表中选择它。

  11. 您现在可以完成消息的配置,然后照常发送。

执行工作流

构建工作流后,即可执行它们。 在执行API调用之前,请确保已启动两个工作流。

在此页面上