Caso d’uso use-case
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:
- Effettuare una chiamata API per attivare Workflow 1 con parametri esterni. Consulta Passaggio 1: configurazione della chiamata API.
- Crea flusso di lavoro 1: il flusso di lavoro trasferisce un file e lo carica nel database. Verificherà quindi se i dati sono vuoti o meno e alla fine salverà i profili in un pubblico. Infine, verrà attivato il flusso di lavoro 2. Consulta Passaggio 2: configurazione del flusso di lavoro 1.
- Crea flusso di lavoro 2: il flusso di lavoro legge il pubblico creato nel flusso di lavoro 1, quindi invia un messaggio personalizzato ai profili, con un codice di segmento personalizzato con i parametri. Consulta Passaggio 3: configurazione del flusso di lavoro 2.
Prerequisiti prerequisites
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.
Passaggio 1: configurazione della chiamata API step-1--configuring-the-api-call
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:
- fileToTarget: nome del file che si desidera importare nel database.
- discountDesc: la descrizione che desideri visualizzare nella consegna per lo sconto.
-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 }
Passaggio 2: configurazione del flusso di lavoro 1 step-2--configuring-workflow-1
Il flusso di lavoro 1 verrà creato come segue:
- External signal attività: in cui i parametri esterni devono essere dichiarati per essere utilizzati all’interno del flusso di lavoro.
- Transfer file activity (attività): importa il file con il nome definito nei parametri.
- Load file activity (attività): carica i dati dal file importato nel database.
- Update data attività: inserisci o aggiorna il database con i dati del file importato.
- Test attività: controlla se sono presenti dati importati.
- Save audience attività: se il file contiene dati, salva i profili in un pubblico.
- End activity attività: chiama il flusso di lavoro 2 con i parametri che desideri utilizzare al suo interno.
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:
code language-none $(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:
code language-none $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:
code language-none $(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.
Passaggio 3: configurazione del flusso di lavoro 2 step-3--configuring-workflow-2
Il flusso di lavoro 2 sarà creato come segue:
- External signal attività: dove i parametri devono essere dichiarati per essere utilizzati all’interno del flusso di lavoro.
- Read audience attività: legge il pubblico salvato nel flusso di lavoro 1.
- Email delivery attività: invia un messaggio ricorrente al pubblico di destinazione, personalizzato con parametri.
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:
code language-none $(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:
code language-none $(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.
Esecuzione dei flussi di lavoro executing-the-workflows
Una volta creati i flussi di lavoro, puoi eseguirli. Assicurati che i due flussi di lavoro siano avviati prima di eseguire la chiamata API.