Documentación Campaign Documentación de Campaign Standard

Ejemplo de uso use-case

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

Temas:

Creado para:

Intermedio
Desarrollador

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

El objetivo es almacenar en déclencheur un flujo de trabajo desde una llamada de 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:

Realice una llamada de API al flujo de trabajo de déclencheur 1 con parámetros externos. Ver Paso 1: Configuración de la llamada de API.
Generar flujo de trabajo 1: el flujo de trabajo transferirá un archivo y lo cargará en la base de datos. A continuación, se comprueba si los datos están vacíos o no y, finalmente, se guardan los perfiles en una audiencia. Por último, se utilizará el déclencheur Workflow 2. Ver Paso 2: Configuración Del Flujo De Trabajo 1.
Generar flujo de trabajo 2: el flujo de trabajo leerá la audiencia que se ha creado en el flujo de trabajo 1 y, a continuación, enviará 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 prerequisites

Antes de configurar los flujos de trabajo, debe crear los flujos de trabajo 1 y 2 con una actividad External signal en cada uno de ellos. De este modo, podrá segmentar estas actividades de señal al invocar a los flujos de trabajo.

Paso 1: Configuración de la llamada de API step-1--configuring-the-api-call

Realice una llamada de API al flujo de trabajo 1 de déclencheur con parámetros. Para obtener más información sobre la sintaxis de la 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 queremos importar en la base de datos.
discountDesc: la descripción que queremos mostrar en la entrega del 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 step-2--configuring-workflow-1

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

External signal actividad: donde se deben declarar los parámetros externos para poder utilizarse en el 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 los 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 en él.

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

Declare los parámetros que se han definido en la llamada de API. Para ello, abra la actividad External signal y luego agregue los nombres y tipos de los parámetros.
Agregue una actividad Transfer file para importar datos en la base de datos. Para ello, arrastre y suelte la actividad, ábrala y seleccione la pestaña Protocol.

Seleccione la opción Use a dynamic file path y, a continuación, utilice el parámetro fileToTarget como archivo para transferir:

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

Cargue los datos del archivo en la base de datos.

Para ello, arrastre y suelte una actividad Load file en el flujo de trabajo y, a continuación, configúrela según sus necesidades.
Inserte y actualice la base de datos con los datos del archivo importado.

Para ello, arrastre y suelte una actividad Update data y, a continuación, seleccione la pestaña Identification para agregar un criterio de reconciliación (en nuestro caso el campo correo electrónico).
Seleccione la ficha Fields to update y, a continuación, especifique los campos que desea actualizar en la base de datos (en nuestro caso los campos firstname y email).
Compruebe si se recuperan datos del archivo. Para ello, arrastre y suelte una actividad Test en el flujo de trabajo y, a continuación, haga clic en el botón Add an element para agregar una condición.

Nombre y defina la condición. En nuestro caso, queremos probar si la transición saliente contiene datos con la sintaxis siguiente:

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

Si se recuperan datos, guárdelos en una audiencia. Para ello, agregue una actividad Save audience a la transición Target no vacío y ábrala.

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

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

Arrastre y suelte una actividad End que llamará al flujo de trabajo 2 con parámetros y, a continuación, ábrala.
Seleccione la pestaña External signal y, a continuación, especifique el flujo de trabajo de déclencheur y su actividad de señal asociada.
Defina los parámetros que desea utilizar en el flujo de trabajo 2 y sus valores asociados.

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

El flujo de trabajo 1 está configurado y 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 step-3--configuring-workflow-2

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

Actividad External signal: donde se deben declarar los parámetros para poder utilizarse en el flujo de trabajo.
Read audience actividad: lee la audiencia guardada en el flujo de trabajo 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:

Declare los parámetros que se han definido en el flujo de trabajo 1.

Para ello, abra la actividad External signal y luego agregue el nombre y el tipo de cada parámetro definido en la actividad End del flujo de trabajo 1.
Utilice la audiencia que se ha guardado en el flujo de trabajo 1. Para ello, arrastre y suelte una actividad Read audience en el flujo de trabajo y ábrala.

Seleccione la opción Use a dynamic audience y, a continuación, utilice el parámetro fileToTarget como nombre de la audiencia que se va a leer:

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

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

Para ello, seleccione la ficha Transition y luego la opción Use a dynamic segment code.

Use el parámetro segmentCode como nombre de la transición saliente:

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

Arrastre y suelte una actividad Email delivery para enviar un mensaje a la audiencia.
Identifique los parámetros que se usarán en el mensaje para personalizarlo con el parámetro discountDesc. Para ello, abra las opciones avanzadas de la actividad y añada el nombre y el valor del parámetro.
Ahora puede configurar el mensaje. Abra la actividad y seleccione Recurring email.
Seleccione la plantilla que desea utilizar y defina las propiedades de correo electrónico según sus necesidades.
Use el parámetro discountDesc como campo de personalización. Para ello, selecciónelo en la lista de campos personalizados.
Ahora puede finalizar la configuración del mensaje y, a continuación, enviarlo como de costumbre.