Il caso d’uso seguente mostra come chiamare il flusso di lavoro con i 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 caricherà i dati nel database da un file e creerà 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, devi eseguire le azioni seguenti:
Prima di configurare i flussi di lavoro, devi 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 dei flussi di lavoro.
Effettua una chiamata API per attivare il flusso di lavoro 1 con i parametri . Per ulteriori informazioni sulla sintassi della chiamata API, consulta Documentazione sulle 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à generato come segue:
Per configurare il flusso di lavoro, effettua le seguenti operazioni:
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 attività per importare 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 l’ fileToTarget come file da trasferire:
$(vars/@fileToTarget)
Carica i dati dal file nel database.
A questo scopo, trascina e rilascia una Load file 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 , quindi seleziona la Identification per aggiungere un criterio di riconciliazione (nel nostro caso, la email (campo).
Seleziona la Fields to update , quindi specifica i campi da aggiornare nel database (nel nostro caso il nome e email campi).
Controlla se i dati vengono recuperati dal file. A questo scopo, trascina e rilascia una Test 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, salvarli in un pubblico. A questo scopo, aggiungi un Save audience attività Target non vuoto , quindi aprilo.
Seleziona la Use a dynamic label , quindi utilizza l’ fileToTarget come etichetta del pubblico:
$(vars/@fileToTarget)
Trascina e rilascia una End attività che chiamerà il Flusso di lavoro 2 con i parametri, quindi aprilo.
Seleziona la External signal , quindi specifica il flusso di lavoro da attivare e l’attività del segnale associata.
Definisci i parametri da utilizzare all’interno del flusso di lavoro 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 valore costante ("20% di sconto").
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 verrà generato come segue:
Per configurare il flusso di lavoro, effettua le seguenti operazioni:
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 ogni parametro definito nella 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 nel flusso di lavoro, quindi aprilo.
Seleziona la Use a dynamic audience , quindi utilizza l’ fileToTarget come nome del pubblico da leggere:
$(vars/@fileToTarget)
Denomina la transizione in uscita in base alla segmentCode parametro .
A questo scopo, seleziona la Transition , quindi la Use a dynamic segment code opzione .
Utilizza la segmentCode 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 il 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 la discountDesc come campo di personalizzazione. A questo scopo, selezionalo dall’elenco dei campi di personalizzazione.
Ora puoi completare la configurazione del messaggio, quindi inviarlo come di consueto.
Una volta generati i flussi di lavoro, puoi eseguirli. Assicurati che i due flussi di lavoro siano avviati prima di eseguire la chiamata API.