Caso d’uso

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:

  1. Effettuare una chiamata API per attivare il flusso di lavoro 1 con parametri esterni. Vedi Passaggio 1: Configurazione della chiamata API.
  2. Crea flusso di lavoro 1: il flusso di lavoro trasferirà un file e lo caricherà nel database. In seguito, verificherà se i dati sono vuoti o meno e alla fine salverà i profili in un pubblico. Infine, attiverà il flusso di lavoro 2. Vedi Passaggio 2: Configurazione del flusso di lavoro 1.
  3. Crea flusso di lavoro 2: il flusso di lavoro leggerà il pubblico creato nel flusso di lavoro 1, quindi invierà un messaggio personalizzato ai profili con un codice di segmento personalizzato con i parametri. Vedi Passaggio 3: Configurazione del flusso di lavoro 2.

Prerequisiti

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.

Passaggio 1: Configurazione della chiamata API

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:

  • fileToTarget: il nome del file da importare nel database.
  • discountDesc: la descrizione da 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

Il flusso di lavoro 1 verrà generato come segue:

  • External signal attività: dove i parametri esterni devono essere dichiarati per essere utilizzati all’interno del flusso di lavoro.
  • Transfer file attività: importa il file con il nome definito nei parametri .
  • Load file attività: carica i dati dal file importato nel database.
  • Update data attività: inserire o aggiornare il database con i dati del file importato.
  • Test attività: verifica se sono presenti dati importati.
  • Save audience attività: se il file contiene dati, salva i profili in un pubblico.
  • End activity attività: chiama Workflow 2 con i parametri che desideri utilizzare al suo interno.

Per configurare il flusso di lavoro, effettua le seguenti operazioni:

  1. Dichiara i parametri definiti nella chiamata API. Per eseguire questa operazione, apri la External signal , quindi aggiungi i nomi e i tipi dei parametri.

  2. Aggiungi un Transfer file attività per importare dati nel database. A questo scopo, trascina e rilascia l’attività, aprila, quindi seleziona la Protocol scheda .

  3. Seleziona la Use a dynamic file path , quindi utilizza l’ fileToTarget come file da trasferire:

    $(vars/@fileToTarget)
    

  4. 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.

  5. 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).

  6. Seleziona la Fields to update , quindi specifica i campi da aggiornare nel database (nel nostro caso il nome e email campi).

  7. 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.

  8. 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
    

  9. Se i dati vengono recuperati, salvarli in un pubblico. A questo scopo, aggiungi un Save audience attività Target non vuoto , quindi aprilo.

  10. Seleziona la Use a dynamic label , quindi utilizza l’ fileToTarget come etichetta del pubblico:

    $(vars/@fileToTarget)
    

  11. Trascina e rilascia una End attività che chiamerà il Flusso di lavoro 2 con i parametri, quindi aprilo.

  12. Seleziona la External signal , quindi specifica il flusso di lavoro da attivare e l’attività del segnale associata.

  13. 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.

Passaggio 3: Configurazione del flusso di lavoro 2

Il flusso di lavoro 2 verrà generato come segue:

  • External signal attività: dove i parametri devono essere dichiarati per poter 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, effettua le seguenti operazioni:

  1. 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.

  2. Utilizza il pubblico salvato nel Flusso di lavoro 1. A questo scopo, trascina e rilascia una Read audience nel flusso di lavoro, quindi aprilo.

  3. Seleziona la Use a dynamic audience , quindi utilizza l’ fileToTarget come nome del pubblico da leggere:

    $(vars/@fileToTarget)
    

  4. Denomina la transizione in uscita in base alla segmentCode parametro .

    A questo scopo, seleziona la Transition , quindi la Use a dynamic segment code opzione .

  5. Utilizza la segmentCode come nome della transizione in uscita:

    $(vars/@segmentCode)
    

  6. Trascina e rilascia una Email delivery per inviare un messaggio al pubblico.

  7. 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.

  8. Ora puoi configurare il messaggio. Apri l’attività, quindi seleziona Recurring email.

  9. Seleziona il modello da utilizzare, quindi definisci le proprietà dell’e-mail in base alle tue esigenze.

  10. Utilizza la discountDesc come campo di personalizzazione. A questo scopo, selezionalo dall’elenco dei campi di personalizzazione.

  11. Ora puoi completare la configurazione del messaggio, quindi inviarlo come di consueto.

Esecuzione dei flussi di lavoro

Una volta generati i flussi di lavoro, puoi eseguirli. Assicurati che i due flussi di lavoro siano avviati prima di eseguire la chiamata API.

In questa pagina