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. Effettua una chiamata API per attivare il flusso di lavoro 1 con parametri esterni. Vedere 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. Vedere 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. Vedere 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’attività External signal 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 la documentazione Campaign Standard REST APIs.

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. A questo scopo, apri l’attività External signal, quindi aggiungi i nomi e i tipi dei parametri.

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

  3. Seleziona l'opzione Use a dynamic file path, quindi utilizza il parametro fileToTarget come file da trasferire:

    $(vars/@fileToTarget)
    

  4. Carica i dati dal file nel database.

    A questo scopo, trascina e rilascia un’attività Load file nel flusso di lavoro, quindi configurala in base alle tue esigenze.

  5. Inserire e aggiornare il database con i dati del file importato.

    A questo scopo, trascina e rilascia un’attività Update data, quindi seleziona la scheda Identification per aggiungere un criterio di riconciliazione (nel nostro caso il campo email ).

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

  7. Controlla se i dati vengono recuperati dal file. A questo scopo, trascina e rilascia un’attività 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’attività Save audience alla transizione Target non vuota, quindi aprila.

  10. Seleziona l'opzione Use a dynamic label, quindi utilizza il parametro fileToTarget come etichetta del pubblico:

    $(vars/@fileToTarget)
    

  11. Trascina e rilascia un’attività End che chiamerà Flusso di lavoro 2 con parametri, quindi aprila.

  12. Seleziona la scheda 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 parametro aggiuntivo segmentCode con un 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.

    A questo scopo, apri l’attività External signal, quindi aggiungi il nome e il tipo di ogni parametro definito nell’attività End del flusso di lavoro 1.

  2. Utilizza il pubblico salvato nel Flusso di lavoro 1. A questo scopo, trascina e rilascia un’attività Read audience nel flusso di lavoro, quindi aprila.

  3. Seleziona l'opzione Use a dynamic audience, quindi utilizza il parametro fileToTarget come nome del pubblico da leggere:

    $(vars/@fileToTarget)
    

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

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

  5. Utilizza il parametro segmentCode come nome della transizione in uscita:

    $(vars/@segmentCode)
    

  6. Trascina e rilascia un’attività Email delivery per inviare un messaggio al pubblico.

  7. Identifica i parametri da utilizzare nel messaggio per personalizzarlo con il parametro discountDesc . 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 il parametro 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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now