Documentazione Campaign Documentazione di Campaign Standard

Caso d’uso use-case

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Intermedio
Sviluppatore

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 il flusso di lavoro 1 con parametri esterni. Vedi Passaggio 1: configurazione della chiamata API.
Genera flusso di lavoro 1: il flusso di lavoro trasferirà un file e lo caricherà 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. Vedere Passaggio 2: Configurazione del flusso di lavoro 1.
Genera 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 prerequisites

Prima di configurare i flussi di lavoro, è necessario 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 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 la 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.
scontoDesc: la descrizione che si desidera 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:

Attività External signal: in cui i parametri esterni devono essere dichiarati per essere utilizzati all'interno del flusso di lavoro.
Attività Transfer file: importa il file con il nome definito nei parametri.
Attività Load file: carica i dati dal file importato nel database.
Attività Update data: inserire o aggiornare il database con i dati del file importato.
Attività Test: verifica se sono presenti dati importati.
Attività Save audience: se il file contiene dati, salva i profili in un pubblico.
Attività End activity: 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. A questo scopo, apri l'attività External signal, quindi aggiungi i nomi e i tipi dei parametri.
Aggiungi un'attività Transfer file per importare dati nel database. A tale scopo, trascina e rilascia l'attività, aprila, quindi seleziona la scheda Protocol.

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

code language-none
`$(vars/@fileToTarget)`

Carica i dati dal file nel database.

Per eseguire questa operazione, trascinare e rilasciare un'attività Load file nel flusso di lavoro, quindi configurarla in base alle proprie esigenze.
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 e-mail).
Seleziona la scheda Fields to update, quindi specifica i campi da aggiornare nel database (nel nostro caso i campi nome e e-mail).
Verifica 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.

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. A questo scopo, aggiungi un'attività Save audience alla transizione Target non vuota, quindi aprila.

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

code language-none
`$(vars/@fileToTarget)`

Trascina e rilascia un'attività End che chiamerà il flusso di lavoro 2 con parametri, quindi aprila.
Selezionare la scheda External signal, quindi specificare il flusso di lavoro da attivare e l'attività del 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 parametro aggiuntivo 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:

Attività External signal: in cui i parametri devono essere dichiarati per essere utilizzati all'interno del flusso di lavoro.
Attività Read audience: legge il pubblico salvato nel flusso di lavoro 1.
Attività Email delivery: 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.

A questo scopo, apri l'attività External signal, quindi aggiungi il nome e il tipo di ciascun parametro definito nell'attività End del flusso di lavoro 1.
Utilizza il pubblico salvato nel flusso di lavoro 1. A tale scopo, trascinare e rilasciare un'attività Read audience nel flusso di lavoro, quindi aprirla.

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

code language-none
`$(vars/@fileToTarget)`

Denomina la transizione in uscita in base al parametro segmentCode.

A tale scopo, selezionare la scheda Transition, quindi l'opzione Use a dynamic segment code.

Utilizza il parametro segmentCode come nome della transizione in uscita:

code language-none
`$(vars/@segmentCode)`

Trascina e rilascia un'attività Email delivery per inviare un messaggio al pubblico.
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.
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 parametro 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.