Show Menu
ARGOMENTI×

Chiamata di un flusso di lavoro con parametri esterni

Campaign Standard consente di richiamare un flusso di lavoro con parametri (un nome di audience per il targeting, un nome di file da importare, una parte del contenuto del messaggio, ecc.). In questo modo, puoi integrare facilmente le automatizzazioni Campaign con il sistema esterno.
Prendiamo l'esempio seguente, in cui desideriamo inviare e-mail direttamente da un CMS. In tal caso, potete configurare il sistema per selezionare l'audience e il contenuto dell'e-mail nel CMS. Facendo clic su Invia, si chiamerà un flusso di lavoro Campaign con questi parametri, che consente di utilizzarli nel flusso di lavoro per definire il pubblico e il contenuto dell'URL da utilizzare nella distribuzione.
La procedura da seguire per chiamare un flusso di lavoro con parametri è la seguente:
  1. Dichiarare i parametri nell' External signal attività. Vedete Dichiarazione dei parametri nell'attività del segnale esterno.
  2. Configurate l' End attività o la chiamata API per definire i parametri e attivare l' External signal attività del flusso di lavoro.
Una volta attivato il flusso di lavoro, i parametri vengono assimilati nelle variabili di eventi del flusso di lavoro e possono essere utilizzati all'interno del flusso di lavoro. Consultate Personalizzazione di un flusso di lavoro con parametri esterni.

Dichiarazione dei parametri nell'attività del segnale esterno

Il primo passo per chiamare un flusso di lavoro con parametri consiste nel dichiararlo in un' External signal attività.
  1. Aprite l' External signal attività, quindi selezionate la Parameters scheda.
  2. Fate clic sul Create element pulsante, quindi specificate il nome e il tipo di ogni parametro.
    Accertatevi che il nome e il numero di parametri siano identici a quelli definiti per la chiamata al flusso di lavoro (consultate Definizione dei parametri per la chiamata al flusso di lavoro ). Inoltre, i tipi di parametri devono essere coerenti con i valori previsti.
  3. Dopo aver dichiarato i parametri, completate la configurazione del flusso di lavoro, quindi eseguitela.

Definizione dei parametri durante la chiamata del flusso di lavoro

In questa sezione viene illustrato come definire i parametri durante la chiamata di un flusso di lavoro. Per ulteriori informazioni su come eseguire questa operazione da una chiamata API, consulta la documentazione ACS_API.htmlREST APIs.
Prima di definire i parametri, accertatevi che:
Per configurare l' End attività, attenetevi alla procedura seguente:
  1. Aprite l' End attività, quindi selezionate la External signal scheda.
  2. Seleziona il flusso di lavoro e l’attività del segnale esterno da chiamare.
  3. Fate clic sul Create element pulsante per aggiungere un parametro, quindi compilate il relativo nome e valore.
    Accertatevi che tutti i parametri siano stati dichiarati nell' External signal attività. In caso contrario, si verificherà un errore durante l'esecuzione dell'attività.
  4. Una volta definiti i parametri, confermate l'attività, quindi salvate il flusso di lavoro.

Monitoraggio delle variabili evento

È possibile monitorare le variabili di eventi disponibili nel flusso di lavoro, compresi i parametri esterni dichiarati. A questo scopo, effettuate le seguenti operazioni:
  1. Selezionate l'attività che segue l'attività, quindi fate clic sul External signal Log and tasks pulsante.
  2. Nella Tasks scheda, fare clic sul pulsante.
  3. Viene visualizzato il contesto di esecuzione dell’attività (ID, stato, durata, ecc.), comprese tutte le variabili di evento ora disponibili per l’uso nel flusso di lavoro.

Personalizzazione di un flusso di lavoro con parametri esterni

Una volta attivato il flusso di lavoro, i parametri vengono assimilati nelle variabili degli eventi e possono essere utilizzati per personalizzare le attività del flusso di lavoro.
Possono, ad esempio, essere utilizzati per definire il pubblico da leggere nell' Read audience attività, il nome del file da trasferire nell' Transfer file attività, ecc.
Le attività che possono essere personalizzate con variabili di eventi sono descritte in questa sezione .

Uso delle variabili di evento

Le variabili evento sono utilizzate all'interno di un'espressione che deve rispettare la sintassi Standard syntax Standard.
La sintassi per l'utilizzo delle variabili di evento deve seguire il formato seguente e utilizzare il nome del parametro definito nell' External signal attività (vedere Dichiarazione dei parametri nell'attività di segnale esterno):
$(vars/@parameterName)

In questa sintassi, la funzione $ restituisce il tipo di dati stringa . Per specificare un altro tipo di dati, utilizzare le seguenti funzioni:
  • $long : numero intero.
  • $float : numero decimale.
  • $boolean : true/false.
  • $datetime : timestamp.
Quando si utilizza una variabile in un'attività, l'interfaccia fornisce aiuto per chiamarla.
  • : selezionate la variabile degli eventi tra tutte le variabili disponibili nel flusso di lavoro (consultate ).
  • : modificare le espressioni combinando variabili e funzioni. Per ulteriori informazioni sull'Editor espressioni, consulta questa sezione .
Argomenti correlati:

Personalizzazione di attività con variabili di eventi

Le variabili evento possono essere utilizzate per personalizzare diverse attività, elencate nella sezione seguente. Per ulteriori informazioni su come chiamare una variabile da un'attività, consultate questa sezione .
Read audience activity: definire l'audience di cui eseguire il targeting in base alle variabili di evento.
Per ulteriori informazioni sull'utilizzo dell'attività, consultate la sezione Read audience dedicata.
Test activity: creare condizioni basate su variabili di eventi.
Per ulteriori informazioni sull'utilizzo dell'attività, consultate la sezione Test dedicata.
Transfer file activity: personalizzare il file da trasferire in base alle variabili degli eventi.
Per ulteriori informazioni sull'utilizzo dell'attività, consultate la sezione File di trasferimento dedicata.
Query activity: in una query è possibile fare riferimento ai parametri utilizzando espressioni che combinano variabili di eventi e funzioni. A questo scopo, aggiungete una regola e fate clic sul Advanced mode collegamento per accedere alla finestra di modifica delle espressioni (consultate Modifica delle espressioni avanzate).
Per ulteriori informazioni sull'utilizzo dell'attività, consultate la sezione Query dedicata.
Channels attività: personalizzare le consegne in base alle variabili degli eventi.
I valori dei parametri di consegna vengono recuperati ogni volta che la consegna viene preparata.
La preparazione delle consegne ricorrenti si basa sul periodo di aggregazione delle consegne. Ad esempio, se il periodo di aggregazione è "per giorno", la consegna verrà preparata solo una volta al giorno. Se il valore di un parametro di consegna viene modificato durante il giorno, non verrà aggiornato nella consegna, come è già stato preparato una volta.
Se prevedete di richiamare il flusso di lavoro più volte al giorno, utilizzate l' No aggregation opzione in modo che i parametri di consegna vengano aggiornati ogni volta. Per ulteriori informazioni sulla configurazione delle consegne ricorrenti, consulta questa sezione .
Per personalizzare una consegna basata su variabili di eventi, è innanzitutto necessario dichiarare nell'attività di consegna le variabili che si desidera utilizzare:
  1. Selezionate l'attività, quindi fate clic sul pulsante per accedere alle impostazioni.
  2. Selezionate la General scheda, quindi aggiungete le variabili evento che saranno disponibili come campi di personalizzazione nella distribuzione.
  3. Fate clic sul Confirm pulsante.
Le variabili degli eventi dichiarati ora sono disponibili nell'elenco dei campi di personalizzazione. Puoi utilizzarli nella consegna per eseguire le azioni seguenti:
  • Definite il nome del modello da utilizzare per la consegna.
    Questa azione è disponibile solo per consegne ricorrenti .
  • Personalizza la consegna: quando si seleziona un campo di personalizzazione per configurare una consegna, nell' Workflow parameters elemento sono disponibili variabili di eventi. Puoi usarli come qualsiasi campo di personalizzazione, ad esempio per definire l’oggetto di consegna, il mittente e così via.
    La personalizzazione della distribuzione è dettagliata in questa sezione .
Codici segmento: definisce il codice del segmento in base alle variabili degli eventi.
Questa azione può essere eseguita da qualsiasi attività che consente di definire un codice di segmento come, ad esempio, Query o Segmentation attività.
Etichetta consegna: definire l'etichetta di consegna in base alle variabili degli eventi.

Caso di utilizzo

Il caso d’uso seguente mostra come chiamare il flusso di lavoro con i parametri all’interno dei flussi di lavoro.
L'obiettivo è 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'audience associata. Una volta creata l'audience, verrà attivato un secondo flusso di lavoro per inviare un messaggio personalizzato con i parametri esterni definiti nella chiamata API.
Per eseguire questo caso di utilizzo, è necessario eseguire le azioni seguenti:
  1. Eseguite una chiamata API per attivare Workflow 1 con parametri esterni. Vedere Passaggio 1: Configurazione della chiamata API.
  2. Crea flusso di lavoro 1 : il flusso di lavoro trasferisce un file e lo carica nel database. Quindi, verrà verificato se i dati sono vuoti o meno e alla fine salverà i profili in un'audience. Infine, attiverà Workflow 2. Vedere Passaggio 2: Configurazione del flusso di lavoro 1 .
  3. Crea flusso di lavoro 2 : il flusso di lavoro leggerà l'audience creata nel Flusso di lavoro 1, quindi invierà un messaggio personalizzato ai profili, con un codice del segmento personalizzato con i parametri. Vedere Passaggio 3: Configurazione del flusso di lavoro 2 .

Prerequisiti

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 quando chiami i flussi di lavoro.

Passaggio 1: Configurazione della chiamata API

Effettuare una chiamata API per attivare Workflow 1 con i parametri. Per ulteriori informazioni sulla sintassi delle chiamate API, consulta la 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 che vogliamo 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à creato come segue:
  • External signal activity: dove i parametri esterni devono essere dichiarati per essere utilizzati nel flusso di lavoro.
  • Transfer file activity: importa il file con il nome definito nei parametri.
  • Load file activity: carica i dati dal file importato nel database.
  • Update data activity: inserire o aggiornare il database con i dati del file importato.
  • Test activity: verifica se sono presenti dati importati.
  • Save audience activity: se il file contiene dei dati, salva i profili in un'audience.
  • End activity activity: chiama Workflow 2 con i parametri che si desidera utilizzare al suo interno.
Per configurare il flusso di lavoro, effettuate le seguenti operazioni:
  1. Dichiarare i parametri definiti nella chiamata API. A questo scopo, aprite l' External signal attività, quindi aggiungete i nomi e i tipi dei parametri.
  2. Aggiungete un' Transfer file attività per importare i dati nel database. A tale scopo, trascinate l'attività, apritela, quindi selezionate la Protocol scheda.
  3. Selezionate l' Use a dynamic file path opzione, quindi utilizzate il parametro fileToTarget come file da trasferire:
    $(vars/@fileToTarget)
    
    
  4. Caricate i dati dal file nel database.
    A tal fine, trascinate un' Load file attività nel flusso di lavoro, quindi configuratela in base alle vostre esigenze.
  5. Inserite e aggiornate il database con i dati del file importato.
    A tal fine, trascinate un' Update data attività, quindi selezionate la Identification scheda per aggiungere un criterio di riconciliazione (nel nostro caso, il campo e-mail ).
  6. Selezionate la Fields to update scheda, quindi specificate i campi da aggiornare nel database (nel nostro caso, i campi first name e email ).
  7. Verificate se i dati vengono recuperati dal file. A tal fine, trascinate un' Test attività nel flusso di lavoro, quindi fate clic sul Add an element pulsante per aggiungere una condizione.
  8. Assegnare un nome e definire 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'audience. A questo scopo, aggiungete un' Save audience attività alla transizione Target non vuota , quindi apritela.
  10. Selezionate l' Use a dynamic label opzione, quindi utilizzate il parametro fileToTarget come etichetta dell'audience:
    $(vars/@fileToTarget)
    
    
  11. Trascina e rilascia un' End attività che chiamerà Flusso di lavoro 2 con i parametri, quindi aprila.
  12. Selezionate la External signal scheda, quindi specificate il flusso di lavoro da attivare e l'attività del segnale associata.
  13. Definite i parametri che desiderate utilizzare in Workflow 2 e i relativi valori associati.
    Nel nostro caso, vogliamo trasmettere i parametri originariamente definiti nella chiamata API ( fileToTarget e scontoDesc ), e un parametro aggiuntivo segmentCode con un valore costante ("sconto del 20%").
Il flusso di lavoro 1 è configurato. È ora possibile generare il flusso di lavoro 2. For more on this, refer to this section .

Passaggio 3: Configurazione del flusso di lavoro 2

Il flusso di lavoro 2 verrà creato come segue:
  • External signal activity: dove i parametri devono essere dichiarati per essere utilizzati nel flusso di lavoro.
  • Read audience activity: legge il pubblico salvato nel Flusso di lavoro 1.
  • Email delivery activity: invia un messaggio ricorrente all'audience di destinazione, personalizzato con parametri.
Per configurare il flusso di lavoro, effettuate le seguenti operazioni:
  1. Dichiarare i parametri definiti nel Flusso di lavoro 1.
    A questo scopo, aprite l' External signal attività, quindi aggiungete il nome e il tipo di ogni parametro definito nell' End attività del Flusso di lavoro 1.
  2. Utilizza il pubblico salvato nel Flusso di lavoro 1. A questo scopo, trascinate un' Read audience attività nel flusso di lavoro, quindi apritela.
  3. Selezionate l' Use a dynamic audience opzione, quindi utilizzate il parametro fileToTarget come nome dell'audience da leggere:
    $(vars/@fileToTarget)
    
    
  4. Denominate la transizione in uscita in base al parametro segmentCode .
    A questo scopo, selezionate la Transition scheda, quindi l’ Use a dynamic segment code opzione.
  5. Utilizzate il parametro segmentCode come nome della transizione in uscita:
    $(vars/@segmentCode)
    
    
  6. Trascinate e rilasciate un' Email delivery attività per inviare un messaggio all'audience.
  7. Identificare i parametri da utilizzare nel messaggio per personalizzare con il parametro scontoDesc . A questo scopo, aprite le opzioni avanzate dell'attività, quindi aggiungete il nome e il valore del parametro.
  8. Ora puoi configurare il messaggio. Aprite l'attività, quindi selezionate Recurring email .
  9. Selezionate il modello da usare, quindi definite le proprietà dell’e-mail in base alle vostre esigenze.
  10. Usa il parametro scontoDesc come campo di personalizzazione. A questo scopo, selezionatelo dall’elenco dei campi di personalizzazione.
  11. Ora puoi completare la configurazione del messaggio e inviarlo come di consueto.

Esecuzione dei flussi di lavoro

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