In questa pagina: scopri come utilizzare le azioni personalizzate per connettere un percorso a un sistema di terze parti tramite una chiamata REST API con un payload JSON, durante l’applicazione della governance dei dati e dei criteri di consenso.
Utilizza le azioni personalizzate per abilitare la connessione a un sistema di terze parti per l’invio di messaggi o chiamate API. Per ciascun provider è possibile configurare un’azione che può essere attivata tramite un’API REST con un payload in formato JSON.
Ulteriori informazioni sulle azioni personalizzate in questa sezione.
Scopri come creare e configurare un’azione personalizzata in questa pagina.
Scopri come utilizzare le risposte alle chiamate API da azioni personalizzate per la personalizzazione in questa pagina.
Consenso e governance dei dati privacy
In Journey Optimizer, puoi applicare la governance dei dati e i criteri di consenso alle azioni personalizzate per impedire l’esportazione di campi specifici in sistemi di terze parti o escludere clienti che non hanno acconsentito a ricevere comunicazioni e-mail, push o SMS. Per ulteriori informazioni, consulta le pagine seguenti:
Configurazione URL
Nel riquadro di configurazione dell’attività Azione personalizzata sono visualizzati i parametri di configurazione URL e i parametri di autenticazione configurati per l’azione personalizzata. Non è possibile impostare la parte statica dell’URL nel percorso, ma nella configurazione globale dell’azione personalizzata. Ulteriori informazioni.
Percorso dinamico
Se l’URL include un percorso dinamico, specificare il percorso nel campo Percorso.
Per concatenare campi e stringhe di testo normale, utilizza le funzioni Stringa o il segno più (+) nell’editor di espressioni avanzate. Racchiudere le stringhe di testo normale tra virgolette singole (') o doppie ("). Ulteriori informazioni.
Questa tabella mostra un esempio di configurazione:
https://xxx.yyy.com:8080/somethingstatic/The _id + '/messages'L’URL concatenato ha il seguente modulo:
https://xxx.yyy.com:8080/somethingstatic/<ID>/messages
Intestazioni e parametri di query headers
La sezione Configurazione URL mostra i campi intestazione dinamica e parametro di query, ma non i campi costanti. I campi dell’intestazione dinamica e dei parametri di query sono definiti come variabili nella schermata di configurazione dell’azione. Ulteriori informazioni
Per specificare il valore dei campi con intestazione dinamica e parametri di query, fai clic all’interno del campo o sull’icona a forma di matita e seleziona il campo desiderato.
Parametri azione
Nella sezione Parametri azione verranno visualizzati i parametri del messaggio definiti come “Variabile”. Per questi parametri, puoi definire dove ottenere queste informazioni (ad esempio: eventi, origini dati), passare i valori manualmente o utilizzare l’editor di espressioni avanzate per casi d’uso avanzati. I casi d’uso avanzati possono essere la manipolazione dei dati e altro utilizzo di funzioni. Consulta questa pagina.
Questa sezione contiene informazioni strutturate che supportano l’interpretazione, il recupero e la risposta alle domande relative a questo argomento.
Per una comprensione completa, queste informazioni devono essere unite alla documentazione su questa pagina. Nessuna delle due origini è progettata per essere indipendente; la pagina descrive la funzione, mentre questa sezione fornisce un contesto aggiuntivo che aiuta a non ambiguare la terminologia, le finalità, l’applicabilità e i vincoli.
- TL;DR: In questa pagina viene illustrato come aggiungere e configurare un’attività di azione personalizzata in un percorso per chiamare un’API REST di terze parti con un payload JSON, inclusi la configurazione degli URL, la mappatura dei parametri di intestazione/query, la mappatura dei parametri di azione e l’applicazione della governance dei dati e dei criteri di consenso.
Intenti:
- Aggiungere un’attività di azione personalizzata a un percorso per inviare dati a un sistema di terze parti tramite API REST
- Configurare un percorso URL dinamico concatenando campi e testo statico nell’editor di espressioni
- Mappare i valori dinamici di intestazione e parametri di query da eventi di percorso o origini dati
- Mappa i parametri dell’azione (definiti come Variabile) su campi evento, campi origine dati o valori statici
- Applicare la governance dei dati e i criteri di consenso per controllare quali dati vengono esportati tramite azioni personalizzate
Glossario:
- Azione personalizzata: attività di azione di percorso che chiama un endpoint API REST esterno con un payload in formato JSON per integrare i sistemi di terze parti (specifico per prodotto)
- Percorso dinamico: la parte variabile dell’URL dell’azione personalizzata definita per esecuzione utilizzando campi del contesto di percorso (specifico per prodotto)
- Parametri azione: campi payload del messaggio definiti come “Variabile” nella configurazione dell’azione personalizzata, mappati ai dati del percorso a livello di percorso (specifico per prodotto)
Guardrail:
- La parte statica dell’URL non può essere modificata nel percorso; deve essere impostata nella configurazione dell’azione personalizzata globale.
- I campi dell’intestazione dinamica e dei parametri di query sono definiti come variabili nella schermata di configurazione dell’azione, non nel percorso.
- È possibile applicare la governance dei dati e i criteri di consenso per impedire l’esportazione di campi specifici o per escludere clienti non autorizzati.
Terminologia:
- Nome canonico: azione personalizzata — Acronimo: none — varianti: azioni personalizzate, azione di terze parti
- Sinonimi: “parametri azione” = “parametri messaggio definiti come variabile”
- Da non confondere: “parte URL statica” (impostata nella configurazione azione globale, non modificabile nel percorso) ≠ “percorso dinamico” (impostata nel percorso per esecuzione)
Domande frequenti:
- Q: posso modificare l’URL di base di un’azione personalizzata all’interno del percorso? — No, nel percorso è possibile impostare solo la parte del percorso dinamico; la parte statica dell’URL è configurata nella configurazione dell’azione personalizzata globale.
- D: come posso creare un percorso URL dinamico che includa un ID profilo? — Utilizzare il campo Percorso con l’editor di espressioni avanzate per concatenare il campo ID con stringhe statiche, ad esempio:
_id + '/messages'. - D: come si applicano le regole di consenso a un’azione personalizzata? — Configurare i criteri di consenso sull’azione personalizzata in modo da escludere i clienti che non hanno acconsentito a ricevere la comunicazione rilevante; per ulteriori informazioni, fare riferimento alla pagina Consenso.
- Q: dove posso mappare i valori per le intestazioni dinamiche? — Nella sezione Configurazione URL del riquadro attività, fai clic all’interno del campo dell’intestazione dinamica oppure utilizza l’icona a forma di matita per selezionare il campo desiderato da eventi o origini dati.
- D: quali tipi di valori posso assegnare ai parametri di azione? — È possibile mappare i parametri ai campi evento, ai campi origine dati, passare i valori manualmente o utilizzare l’editor di espressioni avanzate per la manipolazione dei dati.