Configurare un’azione personalizzata

Se utilizzi un sistema di terze parti per l’invio di messaggi o desideri che i percorsi inviino chiamate API a un sistema di terze parti, utilizza azioni personalizzate per configurarne la connessione al tuo percorso. Ad esempio, è possibile connettersi ai seguenti sistemi con azioni personalizzate: Epsilon, Slack, Adobe Developer, Firebase, ecc.

Le azioni personalizzate sono azioni aggiuntive definite dagli utenti tecnici e rese disponibili agli esperti di marketing. Una volta configurate, vengono visualizzate nella palette a sinistra del percorso, nel Azione categoria. Per ulteriori informazioni, consulta questa pagina.

Limitazioni

Le azioni personalizzate presentano alcune limitazioni elencate in questa pagina.

Nei parametri delle azioni personalizzati, puoi trasmettere una semplice raccolta e un insieme di oggetti. Ulteriori informazioni sulle limitazioni della raccolta in questa pagina.

Inoltre, i parametri delle azioni personalizzate hanno un formato previsto (ad esempio, stringa, decimale, ecc.). Devi fare attenzione a rispettare questi formati previsti. Ulteriori informazioni caso d’uso.

Consenso e governance dei dati

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:

• Governance dei dati.
• Consenso.

Passaggi di configurazione

Di seguito sono riportati i passaggi principali necessari per configurare un’azione personalizzata:

1. Nella sezione del menu ADMINISTRATION, selezionare Configurazioni. In Azioni , fare clic su Gestisci. Clic Crea azione per creare una nuova azione. Il riquadro di configurazione delle azioni si apre sul lato destro dello schermo.

   

2. Immetti un nome per l'azione.

   NOTA

   Non utilizzare spazi o caratteri speciali. Non usare più di 30 caratteri.

3. Aggiungi una descrizione all’azione. Questo passaggio è facoltativo.

4. Il numero di percorsi che utilizzano questa azione viene visualizzato nel Utilizzato in campo. Puoi fare clic su Visualizza percorsi per visualizzare l'elenco dei percorsi che utilizzano questa azione.

5. Definisci i diversi Configurazione URL parametri. Consulta questa pagina.

6. Configurare Autenticazione sezione. Questa configurazione è la stessa delle origini dati. Vedi questa sezione.

7. Definisci il Parametri azione. Consulta questa pagina.

8. Fai clic su Salva.

   L’azione personalizzata è ora configurata ed è pronta per essere utilizzata nei percorsi. Consulta questa pagina.

   NOTA

   Quando un’azione personalizzata viene utilizzata in un percorso, la maggior parte dei parametri è di sola lettura. È possibile modificare solo Nome, Descrizione, URL campi e Autenticazione sezione.

Configurazione URL

Durante la configurazione di un’azione personalizzata, devi definire quanto segue Configurazione URL parametri:

1. In URL , specifica l’URL del servizio esterno:

   • Se l’URL è statico, inseriscilo in questo campo.

   • Se l'URL include un percorso dinamico, immettere solo la parte statica dell'URL, ovvero lo schema, l'host, la porta e, facoltativamente, una parte statica del percorso.

     Esempio: https://xxx.yyy.com/somethingstatic/

     Specificherai il percorso dinamico dell’URL quando aggiungi l’azione personalizzata a un percorso. Maggiori informazioni.

   NOTA

   Per motivi di sicurezza, si consiglia vivamente di utilizzare lo schema HTTPS per l’URL. Non consentiamo l’uso di indirizzi Adobe non pubblici e l’uso di indirizzi IP.

   Durante la definizione di un’azione personalizzata sono consentite solo le porte predefinite: 80 per http e 443 per https.

2. Seleziona la chiamata Metodo: può essere POST o PUT.

   NOTA

   Il DELETE metodo non supportato. Se devi aggiornare una risorsa esistente, seleziona la PUT metodo.

3. Definisci le intestazioni e i parametri di query:

   • In Intestazioni , fare clic su Aggiungere un campo intestazione per definire le intestazioni HTTP del messaggio di richiesta da inviare al servizio esterno. Il Content-Type e Charset i campi dell’intestazione sono impostati per impostazione predefinita. Non è possibile modificare o eliminare questi campi.

   • In Parametri di query , fare clic su Aggiungere un campo Parametro query per definire i parametri che desideri aggiungere all’URL.

   

4. Immettere l'etichetta o il nome del campo.

5. Selezionare il tipo: Costante o Variabile. Se hai selezionato Costante, quindi inserisci il valore costante nel Valore campo. Se hai selezionato Variabile, quindi specificherai questa variabile quando aggiungi l’azione personalizzata a un percorso. Maggiori informazioni.

   

   NOTA

   Dopo aver aggiunto l’azione personalizzata a un percorso, puoi comunque aggiungere campi di intestazione o parametri di query se il percorso si trova nello stato Bozza. Se non desideri che le modifiche alla configurazione influiscano sul percorso, duplica l’azione personalizzata e aggiungi i campi alla nuova azione personalizzata.

   Le intestazioni vengono convalidate in base alle regole di analisi dei campi. Ulteriori informazioni in questa documentazione.

Definire i parametri dell’azione

In Parametri azione incolla un esempio del payload JSON da inviare al servizio esterno.

Potrai definire il tipo di parametro (ad esempio stringa, numero intero e così via).

Puoi anche scegliere se specificare se un parametro è una costante o una variabile:

• Costante significa che il valore del parametro è definito nel riquadro di configurazione dell’azione da un utente tecnico. Il valore sarà sempre lo stesso tra i percorsi. Non varia e l’addetto marketing non la vede quando utilizza l’azione personalizzata nel percorso. Potrebbe essere ad esempio un ID previsto dal sistema di terze parti. In tal caso, il campo a destra della costante/variabile di attivazione è il valore passato.
• Variabile indica che il valore del parametro varia. Gli addetti al marketing che utilizzano questa azione personalizzata in un percorso saranno liberi di trasmettere il valore desiderato o di specificare dove recuperare il valore per questo parametro (ad esempio dall’evento, da Adobe Experience Platform, ecc.). In tal caso, il campo a destra della costante/variabile di attivazione è l’etichetta che gli addetti al marketing vedranno nel percorso per denominare questo parametro.

Risorse Business.Adobe.com