调用工作流的用例 | 51黑料不打烊 Campaign

文档 Campaign Campaign Standard 文档

用例 use-case

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

中级
开发人员

以下用例展示了如何使用工作流中的参数调用工作流。

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

要执行此用例，您需要执行以下操作：

进行础笔滨调用 ?以使用外部参数触发工作流1。请参阅步骤1：配置础笔滨调用。
生成工作流1：工作流将传输文件并将其加载到数据库中。然后，它将测试数据是否为空，并最终将用户档案保存到受众。最后，它会触发工作流2。请参阅步骤2：配置工作流1。
生成工作流2：工作流将读取在工作流1中创建的受众，然后向用户档案发送个性化消息，并使用参数自定义区段代码。请参阅步骤3：配置工作流2。

先决条件 prerequisites

在配置工作流之前，您需要创建工作流1和2，其中每个工作流1和2均具有? External signal ?活动。这样，您就可以在调用工作流时定位这些信号活动。

步骤1：配置础笔滨调用 step-1--configuring-the-api-call

进行础笔滨调用以通过参数触发工作流1。有关API调用语法的详细信息，请参阅Campaign StandardREST API文档。

在本例中，我们希望使用以下参数调用工作流：

fileToTarget：要导入数据库的文件的名称。
discountDesc：我们要在投放中显示折扣的说明。

-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 step-2--configuring-workflow-1

工作流1将构建如下：

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

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

声明已在API调用中定义的参数。为此，请打开? External signal ?活动，然后添加参数的名称和类型。
添加? Transfer file ?活动以将数据导入数据库。为此，请拖放该活动，将其打开，然后选择? Protocol ?选项卡。

选择? Use a dynamic file path ?选项，然后使用? fileToTarget ?参数作为要传输的文件：

code language-none
`$(vars/@fileToTarget)`

将数据从文件加载到数据库中。

为此，请将? Load file ?活动拖放到工作流中，然后根据您的需要进行配置。
使用导入文件中的数据插入并更新数据库。

为此，请拖放? Update data ?活动，然后选择? Identification ?选项卡以添加协调条件（在我们的示例中为? 电子邮件 ?字段）。
选择? Fields to update ?选项卡，然后指定要在数据库中更新的字段（在我们的示例中为? firstname ?和? email ?字段）。
检查是否从文件检索数据。为此，请将? Test ?活动拖放到工作流中，然后单击? Add an element ?按钮以添加条件。

命名并定义条件。在本例中，我们希望测试叫客过渡是否包含使用以下语法的数据：

code language-none
`$long(vars/@recCount)>0`

如果检索到数据，则将其保存到受众中。为此，请将? Save audience ?活动添加到? Target not empty ?过渡，然后打开它。

选择? Use a dynamic label ?选项，然后使用? fileToTarget ?参数作为受众的标签：

code language-none
`$(vars/@fileToTarget)`

拖放将使用参数调用工作流2的? End ?活动，然后将其打开。
选择? External signal ?选项卡，然后指定要触发的工作流及其关联的信号活动。
定义要在工作流2中使用的参数及其关联值。

在本例中，我们希望传递最初在础笔滨调用中定义的参数（fileToTarget ?和? discountDesc），以及带有常量值（“20%折扣”）的附加? segmentCode ?参数。