Il caso d’uso seguente mostra come chiamare un flusso di lavoro con parametri all’interno dei flussi di lavoro.
L’obiettivo è quello di attivare un flusso di lavoro da una chiamata API con parametri esterni. Questo flusso di lavoro carica i dati nel database da un file e crea un pubblico associato. Una volta creato il pubblico, viene attivato un secondo flusso di lavoro per inviare un messaggio personalizzato con i parametri esterni definiti nella chiamata API.
Per eseguire questo caso d’uso, è necessario eseguire le azioni seguenti:
Prima di configurare i flussi di lavoro, è necessario creare i flussi di lavoro 1 e 2 con un External signal attività in ciascuno di essi. In questo modo, potrai eseguire il targeting di queste attività di segnale durante la chiamata ai flussi di lavoro.
Effettua una chiamata API per attivare il flusso di lavoro 1 con parametri. Per ulteriori informazioni sulla sintassi della chiamata API, consulta Documentazione API REST di Campaign Standard.
Nel nostro caso, vogliamo chiamare il flusso di lavoro con i parametri seguenti:
-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 }
Il flusso di lavoro 1 verrà creato come segue:
Per configurare il flusso di lavoro, segui i passaggi seguenti:
Dichiara i parametri definiti nella chiamata API. Per eseguire questa operazione, apri la External signal , quindi aggiungi i nomi e i tipi dei parametri.
Aggiungi un Transfer file per importare i dati nel database.A questo scopo, trascina e rilascia l’attività, aprila, quindi seleziona la Protocol scheda.
Seleziona la Use a dynamic file path , quindi utilizza fileToTarget parametro come file da trasferire:
$(vars/@fileToTarget)
Carica i dati dal file nel database.
A questo scopo, trascina e rilascia una Load file attività nel flusso di lavoro, quindi configuralo in base alle tue esigenze.
Inserire e aggiornare il database con i dati del file importato.
A questo scopo, trascina e rilascia una Update data attività, quindi seleziona la Identification per aggiungere un criterio di riconciliazione (nel nostro caso, il email ).
Seleziona la Fields to update , quindi specificare i campi da aggiornare nel database (nel nostro caso il campo nome e email campi).
Verifica se i dati vengono recuperati dal file. A questo scopo, trascina e rilascia una Test attività nel flusso di lavoro, quindi fai clic sul pulsante Add an element per aggiungere una condizione.
Denomina e definisci la condizione. Nel nostro caso, vogliamo verificare se la transizione in uscita contiene dati con la sintassi seguente:
$long(vars/@recCount)>0
Se i dati vengono recuperati, salvali in un pubblico. Per eseguire questa operazione, aggiungi un Save audience attività al Destinazione non vuota e aprirla.
Seleziona la Use a dynamic label , quindi utilizza fileToTarget parametro come etichetta del pubblico:
$(vars/@fileToTarget)
Trascina e rilascia una End attività che chiamerà il flusso di lavoro 2 con parametri, quindi lo aprirà.
Seleziona la External signal , quindi specifica il flusso di lavoro da attivare e la relativa attività di segnale associata.
Definire i parametri che si desidera utilizzare all'interno di Workflow 2 e i relativi valori associati.
Nel nostro caso, vogliamo trasmettere i parametri originariamente definiti nella chiamata API (fileToTarget e discountDesc) e un'ulteriore segmentCode con un valore costante ("sconto del 20%").
Il flusso di lavoro 1 è configurato, ora puoi generare il flusso di lavoro 2. Per ulteriori informazioni al riguardo, consulta questa sezione.
Il flusso di lavoro 2 sarà creato come segue:
Per configurare il flusso di lavoro, segui i passaggi seguenti:
Dichiara i parametri definiti nel flusso di lavoro 1.
Per eseguire questa operazione, apri la External signal , quindi aggiungi il nome e il tipo di ciascun parametro definito nell' End attività del flusso di lavoro 1.
Utilizza il pubblico salvato nel flusso di lavoro 1. A questo scopo, trascina e rilascia una Read audience attività nel flusso di lavoro, quindi aprirlo.
Seleziona la Use a dynamic audience , quindi utilizza fileToTarget parametro come nome del pubblico da leggere:
$(vars/@fileToTarget)
Denomina la transizione in uscita in base al segmentCode parametro.
A questo scopo, seleziona la Transition , quindi la scheda Use a dynamic segment code opzione.
Utilizza il segmentCode parametro come nome della transizione in uscita:
$(vars/@segmentCode)
Trascina e rilascia una Email delivery per inviare un messaggio al pubblico.
Identifica i parametri da utilizzare nel messaggio per personalizzarlo con discountDesc parametro. A questo scopo, apri le opzioni avanzate dell’attività, quindi aggiungi il nome e il valore del parametro.
Ora puoi configurare il messaggio. Apri l’attività, quindi seleziona Recurring email.
Seleziona il modello da utilizzare, quindi definisci le proprietà dell’e-mail in base alle tue esigenze.
Utilizza il discountDesc come campo di personalizzazione. A questo scopo, selezionala dall’elenco dei campi di personalizzazione.
Ora puoi completare la configurazione del messaggio, quindi inviarlo come di consueto.
Una volta creati i flussi di lavoro, puoi eseguirli. Assicurati che i due flussi di lavoro siano avviati prima di eseguire la chiamata API.