Show Menu
TEMAS×

Invocación de un flujo de trabajo con parámetros externos

Campaign Standard le permite llamar a un flujo de trabajo con parámetros (un nombre de audiencia para el objetivo, un nombre de archivo para importar, una parte del contenido del mensaje, etc.). De este modo, puede integrar fácilmente las automatizaciones de su campaña con su sistema externo.
Veamos el siguiente ejemplo, donde queremos enviar correos electrónicos directamente desde un CMS. En ese caso, puede configurar el sistema para que seleccione la audiencia y el contenido del correo electrónico en el CMS. Al hacer clic en Enviar, se llamará a un flujo de trabajo de campaña con estos parámetros, lo que le permitirá utilizarlos en el flujo de trabajo para definir la audiencia y el contenido URL que se utilizarán en la entrega.
El proceso para llamar a un flujo de trabajo con parámetros es el siguiente:
  1. Declare los parámetros de la External signal actividad. Consulte Declaración de los parámetros en la actividad de señal externa.
  2. Configure la actividad End o la llamada de API para definir los parámetros y activar la External signal actividad de flujo de trabajo.
Una vez activado el flujo de trabajo, los parámetros se ingieren en las variables de eventos del flujo de trabajo y se pueden utilizar dentro del mismo. Consulte Personalización de un flujo de trabajo con parámetros externos.

Declaración de los parámetros en la actividad de señal externa

El primer paso para llamar a un flujo de trabajo con parámetros es declararlos en una External signal actividad.
  1. Abra la External signal actividad y seleccione la Parameters ficha.
  2. Haga clic en el Create element botón y luego especifique el nombre y el tipo de cada parámetro.
    Asegúrese de que el nombre y el número de parámetros son idénticos a los definidos al llamar al flujo de trabajo (consulte Definición de parámetros al llamar al flujo de trabajo ). Además, los tipos de parámetros deben ser coherentes con los valores esperados.
  3. Una vez declarados los parámetros, finalice la configuración del flujo de trabajo y, a continuación, ejecútela.

Definición de los parámetros al llamar al flujo de trabajo

En esta sección se explica cómo definir parámetros al llamar a un flujo de trabajo. Para obtener más información sobre cómo realizar esta operación desde una llamada de API, consulte la documentación de las API de REST.
Antes de definir los parámetros, asegúrese de que:
Para configurar la End actividad, siga los pasos a continuación:
  1. Abra la End actividad y seleccione la External signal ficha.
  2. Seleccione el flujo de trabajo y la actividad de señal externa que desea llamar.
  3. Haga clic en el Create element botón para agregar un parámetro y luego complete su nombre y valor.
    Asegúrese de que todos los parámetros se han declarado en la External signal actividad. De lo contrario, se producirá un error al ejecutar la actividad.
  4. Una vez definidos los parámetros, confirme la actividad y guarde el flujo de trabajo.

Monitoreo de las variables de eventos

Es posible supervisar las variables de eventos disponibles en el flujo de trabajo, incluidos los parámetros externos declarados. Para realizar esto, siga los pasos a continuación:
  1. Seleccione la actividad que sigue a la External signal actividad y haga clic en el Log and tasks botón.
  2. En la Tasks ficha, haga clic en .
  3. Se muestra el contexto de ejecución de la tarea (ID, estado, duración, etc.), incluidas todas las variables de eventos que ahora están disponibles para su uso en el flujo de trabajo.

Customizing a workflow with external parameters

Una vez activado el flujo de trabajo, los parámetros se ingieren en las variables de eventos y se pueden utilizar para personalizar las actividades del flujo de trabajo.
Pueden, por ejemplo, utilizarse para definir qué audiencia leer en la Read audience actividad, el nombre del archivo que se va a transferir en la Transfer file actividad, etc.
Las actividades que se pueden personalizar con variables de eventos se detallan en esta sección .

Uso de variables de eventos

Las variables events se utilizan dentro de una expresión que debe respetar la sintaxis Sintaxis estándar estándar.
La sintaxis para utilizar variables de eventos debe seguir el formato siguiente y utilizar el nombre del parámetro que se ha definido en la External signal actividad (consulte Declaración de parámetros en la actividad de señal externa):
$(vars/@parameterName)

En esta sintaxis, la función $ devuelve el tipo de datos de cadena . Si desea especificar otro tipo de datos, utilice las siguientes funciones:
  • $long : número entero.
  • $float : número decimal.
  • $boolean : true/false.
  • $datetime : timestamp.
Cuando se utiliza una variable en una actividad, la interfaz proporciona ayuda para llamarla.
  • :: seleccione la variable events entre todas las variables disponibles en el flujo de trabajo (consulte ).
  • :: editar expresiones combinando variables y funciones. For more on the Expression editor, refer to this section .
Temas relacionados:

Personalización de actividades con variables de eventos

Las variables de eventos se pueden utilizar para personalizar varias actividades, enumeradas en la sección siguiente. Para obtener más información sobre cómo llamar a una variable desde una actividad, consulte esta sección .
Read audience actividad: defina la audiencia a la que se dirigirá en función de las variables de eventos.
For more on how to use the activity, refer to the dedicated section .
Test actividad: generar condiciones basadas en variables de eventos.
For more on how to use the activity, refer to the dedicated section .
Transfer file actividad: personalice el archivo que se va a transferir en función de las variables de eventos.
For more on how to use the activity, refer to the dedicated section .
Query actividad: se puede hacer referencia a los parámetros en una consulta, mediante expresiones que combinan variables y funciones de eventos. Para ello, agregue una regla y haga clic en el Advanced mode vínculo para acceder a la ventana de edición de expresiones (consulte Edición de expresiones avanzadas).
For more on how to use the activity, refer to the dedicated section .
Channels actividades: personalice los envíos en función de las variables de eventos.
Los valores de los parámetros de entrega se recuperan cada vez que se prepara la entrega.
La preparación de entregas recurrentes se basa en el período de agregación de envíos. Por ejemplo, si el período de agregación es "por día", la entrega se volverá a preparar sólo una vez al día. Si el valor de un parámetro de entrega se modifica durante el día, no se actualizará en la entrega, ya que ya se ha preparado una vez.
Si planea llamar al flujo de trabajo varias veces al día, utilice la No aggregation opción para que los parámetros de envío se actualicen cada vez. Para obtener más información sobre la configuración de envíos recurrentes, consulte esta sección .
Para personalizar una entrega según las variables de eventos, primero debe declarar en la actividad de entrega las variables que desee utilizar:
  1. Seleccione la actividad y, a continuación, haga clic en el botón para acceder a la configuración.
  2. Seleccione la General ficha y, a continuación, agregue las variables de eventos que estarán disponibles como campos de personalización en la entrega.
  3. Haga clic en el botón .Confirm
Las variables de eventos declarados ya están disponibles en la lista de campos de personalización. Puede utilizarlos en la entrega para realizar las acciones siguientes:
  • Defina el nombre de la plantilla que se va a utilizar para la entrega.
    Esta acción solo está disponible para entregas recurrentes .
  • Personalice la entrega: al seleccionar un campo de personalización para configurar una entrega, las variables events están disponibles en el Workflow parameters elemento . Puede utilizarlos como cualquier campo de personalización, por ejemplo para definir el asunto de entrega, el remitente, etc.
    La personalización de la entrega se detalla en esta sección .
Códigos de segmento: defina el código de segmento en función de las variables de eventos.
Esta acción se puede realizar desde cualquier actividad que le permita definir un código de segmento como, por ejemplo, Query o Segmentation actividades.
Etiqueta de envío: defina la etiqueta de entrega en función de las variables events.

Ejemplo de uso

El siguiente caso de uso muestra cómo llamar al flujo de trabajo con parámetros dentro de los flujos de trabajo.
El objetivo es activar un flujo de trabajo desde una llamada de API con parámetros externos. Este flujo de trabajo cargará datos en la base de datos desde un archivo y creará una audiencia asociada. Una vez creada la audiencia, se activará 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 acciones siguientes:
  1. Realice una llamada de API para activar Workflow 1 con parámetros externos. Consulte el paso 1: Configuración de la llamada de API.
  2. Generar flujo de trabajo 1 : el flujo de trabajo transferirá un archivo y lo cargará 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, activará Workflow 2. Consulte el paso 2: Configuración del flujo de trabajo 1 .
  3. Generar flujo de trabajo 2 : el flujo de trabajo leerá la audiencia que se ha creado en Workflow 1 y, a continuación, enviará un mensaje personalizado a los perfiles, con un código de segmento personalizado con los parámetros. Consulte el 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 uno de ellos. De este modo, podrá dirigir 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 para activar Workflow 1 con parámetros. Para obtener más información sobre la sintaxis de llamada de API, consulte la documentación de las API de REST de Campaign Standard.
En nuestro caso, queremos llamar al flujo de trabajo con los parámetros siguientes:
  • fileToTarget : el nombre del archivo que desea importar a la base de datos.
  • descuentosDesc : 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: insertar o actualizar 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 usar dentro de é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 la External signal actividad y, a continuación, agregue los nombres y tipos de los parámetros.
  2. Agregue una Transfer file actividad para importar datos en la base de datos.Para ello, arrastre y suelte la actividad, ábrala y seleccione la Protocol ficha.
  3. Seleccione la Use a dynamic file path opción y, a continuación, utilice el parámetro fileToTarget como archivo para 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 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 ficha para agregar un criterio de reconciliación (en nuestro caso, el campo de correo electrónico ).
  6. Seleccione la Fields to update ficha y, a continuación, especifique los campos que desea actualizar en la base de datos (en nuestro caso, los campos first name y email ).
  7. Compruebe si los datos se recuperan del archivo. Para ello, arrastre y suelte una Test actividad en el flujo de trabajo y, a continuación, haga clic en el Add an element botón para agregar una condición.
  8. Asigne un nombre y defina la condición. En nuestro caso, queremos probar si la transición saliente contiene datos con la sintaxis siguiente:
    $long(vars/@recCount)>0
    
    
  9. Si se recuperan datos, guárdelos en una audiencia. Para ello, agregue una Save audience actividad a Target que no esté vacía y, a continuación, ábrala.
  10. Seleccione la Use a dynamic label opción y, a continuación, utilice el parámetro fileToTarget como etiqueta de la audiencia:
    $(vars/@fileToTarget)
    
    
  11. Arrastre y suelte una End actividad que llamará a Workflow 2 con parámetros y, a continuación, ábrala.
  12. Seleccione la External signal ficha y, a continuación, especifique el flujo de trabajo que se activará y su actividad de señal asociada.
  13. Defina los parámetros que desee 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 descuentosDesc ), y un parámetro segmentCode adicional 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 definidos en Workflow 1.
    Para ello, abra la External signal actividad y, a continuación, agregue el nombre y el tipo de cada parámetro definido en la End actividad de Workflow 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 la Use a dynamic audience opción y, a continuación, utilice el parámetro fileToTarget como nombre de la audiencia para leer:
    $(vars/@fileToTarget)
    
    
  4. Asigne un nombre a la transición de salida según el parámetro segmentCode .
    Para ello, seleccione la Transition ficha y, a continuación, la Use a dynamic segment code opción.
  5. Utilice el parámetro segmentCode como nombre de la transición de salida:
    $(vars/@segmentCode)
    
    
  6. Arrastre y suelte una Email delivery actividad para enviar un mensaje a la audiencia.
  7. Identifique los parámetros que se utilizarán en el mensaje para personalizarlo con el parámetro descuentosDesc . Para ello, abra las opciones avanzadas de la actividad y, a continuación, agregue 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 desee utilizar y defina las propiedades de correo electrónico según sus necesidades.
  10. Utilice el parámetro descuentosDesc como campo de personalización. Para ello, selecciónelo en la lista de campos de personalización.
  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.