Caso de uso

El caso de uso siguiente muestra cómo invocar al flujo de trabajo con parámetros dentro de los flujos de trabajo.

El objetivo es el déclencheur de un flujo de trabajo desde una llamada a la API con parámetros externos. Este flujo de trabajo carga datos en la base de datos desde un archivo y crea una audiencia asociada. Una vez creada la audiencia, se activa un segundo flujo de trabajo para enviar un mensaje personalizado con los parámetros externos definidos en la llamada de API.

Para realizar este caso de uso, debe realizar las siguientes acciones:

  1. Realizar una llamada de API para almacenar en déclencheur el flujo de trabajo 1 con parámetros externos. Consulte Paso 1: Configuración de la llamada de API.
  2. Generar flujo de trabajo 1: el flujo de trabajo transfiere un archivo y lo carga en la base de datos. Luego comprobará si los datos están vacíos o no y, finalmente, guardará los perfiles en una audiencia. Finalmente, déclencheur el flujo de trabajo 2. Consulte Paso 2: Configuración del flujo de trabajo 1.
  3. Generar flujo de trabajo 2: el flujo de trabajo lee la audiencia que se ha creado en Workflow 1 y, a continuación, envía un mensaje personalizado a los perfiles, con un código de segmento personalizado con los parámetros . Consulte Paso 3: Configuración del flujo de trabajo 2.

Requisitos previos

Antes de configurar los flujos de trabajo, debe crear los flujos de trabajo 1 y 2 con una External signal actividad en cada una de ellas. De este modo, puede dirigirse a estas actividades de señal al llamar a los flujos de trabajo.

Paso 1: Configuración de la llamada de API

Realice una llamada de API al flujo de trabajo de déclencheur 1 con parámetros. Para obtener más información sobre la sintaxis de llamadas a la API, consulte la Documentación de las API de REST del Campaign Standard.

En nuestro caso, queremos llamar al flujo de trabajo con los parámetros siguientes:

  • fileToTarget: el nombre del archivo que desea importar en la base de datos.
  • billetes de descuentoDesc: la descripción que queremos mostrar en la entrega para el descuento.
-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 } 

Paso 2: Configuración del flujo de trabajo 1

El flujo de trabajo 1 se generará de la siguiente manera:

  • External signal actividad: donde los parámetros externos deben declararse para poder utilizarse dentro del flujo de trabajo.
  • Transfer file actividad: importa el archivo con el nombre definido en los parámetros.
  • Load file actividad: carga datos del archivo importado en la base de datos.
  • Update data actividad: inserte o actualice la base de datos con datos del archivo importado.
  • Test actividad: comprueba si hay datos importados.
  • Save audience actividad: si el archivo contiene datos, guarda los perfiles en una audiencia.
  • End activity actividad: llama al flujo de trabajo 2 con los parámetros que desea utilizar en él.

Siga los pasos a continuación para configurar el flujo de trabajo:

  1. Declare los parámetros que se han definido en la llamada de API. Para ello, abra el External signal y, a continuación, añada los nombres y tipos de los parámetros.

  2. Agregue un Transfer file actividad para importar datos en la base de datos. Para ello, arrastre y suelte la actividad, ábrala y seleccione la Protocol pestaña .

  3. Seleccione el Use a dynamic file path y, a continuación, utilice la opción fileToTarget como el archivo que se va a transferir:

    $(vars/@fileToTarget)
    

  4. Cargue los datos del archivo en la base de datos.

    Para ello, arrastre y suelte una Load file actividad en el flujo de trabajo y, a continuación, configúrela según sus necesidades.

  5. Inserte y actualice la base de datos con datos del archivo importado.

    Para ello, arrastre y suelte una Update data actividad y, a continuación, seleccione la Identification para añadir un criterio de reconciliación (en nuestro caso, la pestaña email ).

  6. Seleccione el Fields to update y, a continuación, especifique los campos que desea actualizar en la base de datos (en nuestro caso, la firstname y email campos).

  7. Compruebe si se recuperan datos del archivo. Para ello, arrastre y suelte una Test en el flujo de trabajo y, a continuación, haga clic en la Add an element para añadir una condición.

  8. Asigne un nombre a la condición y defina su definición. En nuestro caso, queremos comprobar si la transición saliente contiene datos con la siguiente sintaxis:

    $long(vars/@recCount)>0
    

  9. Si se recuperan datos, guárdelos en una audiencia. Para ello, agregue una Save audience a la El objetivo no está vacío y, a continuación, ábrala.

  10. Seleccione el Use a dynamic label y, a continuación, utilice la opción fileToTarget como etiqueta de la audiencia:

    $(vars/@fileToTarget)
    

  11. Arrastre y suelte una End actividad que llamará al flujo de trabajo 2 con parámetros y, a continuación, ábrala.

  12. Seleccione el External signal y, a continuación, especifique el flujo de trabajo a déclencheur y su actividad de señal asociada.

  13. Defina los parámetros que desea utilizar en Workflow 2 y sus valores asociados.

    En nuestro caso, queremos pasar los parámetros definidos originalmente en la llamada de API (fileToTarget y billetes de descuentoDesc) y un segmentCode con un valor constante ("20% de descuento").

El flujo de trabajo 1 está configurado, ahora puede crear el flujo de trabajo 2. Para obtener más información, consulte esta sección.

Paso 3: Configuración del flujo de trabajo 2

El flujo de trabajo 2 se generará de la siguiente manera:

  • External signal actividad: donde los parámetros deben declararse para poder utilizarse dentro del flujo de trabajo.
  • Read audience actividad: lee la audiencia guardada en Workflow 1.
  • Email delivery actividad: envía un mensaje recurrente a la audiencia de destino, personalizado con parámetros.

Siga los pasos a continuación para configurar el flujo de trabajo:

  1. Declare los parámetros que se han definido en Workflow 1.

    Para ello, abra el External signal actividad y, a continuación, añada el nombre y el tipo de cada parámetro definido en la variable End actividad del flujo de trabajo 1.

  2. Utilice la audiencia que se ha guardado en el flujo de trabajo 1. Para ello, arrastre y suelte una Read audience actividad en el flujo de trabajo y, a continuación, ábrala.

  3. Seleccione el Use a dynamic audience y, a continuación, utilice la opción fileToTarget como nombre de la audiencia que desea leer:

    $(vars/@fileToTarget)
    

  4. Asigne un nombre a la transición saliente según la variable segmentCode parámetro.

    Para ello, seleccione la Transition y, a continuación, la pestaña Use a dynamic segment code .

  5. Utilice la variable segmentCode como nombre de la transición saliente:

    $(vars/@segmentCode)
    

  6. Arrastre y suelte una Email delivery actividad para enviar un mensaje a la audiencia.

  7. Identifique los parámetros que desea utilizar en el mensaje para personalizarlo con la variable billetes de descuentoDesc parámetro. Para ello, abra las opciones avanzadas de la actividad y añada el nombre y el valor del parámetro .

  8. Ahora puede configurar el mensaje. Abra la actividad y seleccione Recurring email.

  9. Seleccione la plantilla que desea utilizar y, a continuación, defina las propiedades de correo electrónico según sus necesidades.

  10. Utilice la variable billetes de descuentoDesc como campo personalizado. Para ello, selecciónelo en la lista de campos personalizados.

  11. Ahora puede terminar de configurar el mensaje y enviarlo como de costumbre.

Ejecución de los flujos de trabajo

Una vez creados los flujos de trabajo, puede ejecutarlos. Asegúrese de que los dos flujos de trabajo se inician antes de realizar la llamada de API.

En esta página