用例

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

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

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

  1. 使用外部参 数进行API调用以触发工作流1。请参阅步骤1:配置API调用
  2. 构建工作流 1:该工作流将传输文件并将其加载到数据库中。然后,它将测试数据是否为空,并最终将用户档案保存到受众中。 最后,它将触发Workflow 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% discount")的附加​segmentCode​参数。

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

第3步:配置工作流2

工作流2将构建如下:

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

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

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

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

  2. 使用已保存在工作流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调用之前,请确保已启动两个工作流。

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now