Configurare un’azione personalizzata

Se utilizzi un sistema di terze parti per l’invio di messaggi o se desideri che i percorsi inviino chiamate API a un sistema di terze parti, utilizza le azioni personalizzate per configurare la connessione al 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 addetti al marketing. Una volta configurati, vengono visualizzati nella palette a sinistra del percorso, nella Azione categoria. Per ulteriori informazioni, consulta questa pagina.

Limitazioni

Le azioni personalizzate presentano alcune limitazioni elencate in questa pagina.

Nei parametri di azione personalizzati è possibile passare una raccolta semplice e una raccolta di oggetti. Ulteriori informazioni sulle limitazioni della raccolta in questa pagina.

Tieni presente che 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 i criteri di governance dei dati e di consenso alle azioni personalizzate per impedire l’esportazione di campi specifici in sistemi di terze parti o escludere i clienti che non hanno acconsentito a ricevere comunicazioni e-mail, push o SMS. Per ulteriori informazioni, consulta le pagine seguenti:

Passaggi di configurazione

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

  1. Nella sezione del menu AMMINISTRAZIONE, seleziona Configurazioni. In Azioni sezione, fai clic su Gestisci. Fai clic su 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 nella Utilizzato in campo . Puoi fare clic su Visualizza percorsi per visualizzare l’elenco dei percorsi che utilizzano questa azione.

  5. Definire i diversi Configurazione URL Parametri. Consulta questa pagina.

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

  7. Definisci la 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 il Nome, Descrizione, URL e Autenticazione sezione .

Configurazione URL

Quando configuri un’azione personalizzata, devi definire quanto segue Configurazione URL parametri:

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

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

    • Se l’URL include un percorso dinamico, immetti 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/

      Quando aggiungi l’azione personalizzata a un percorso, specificerai il percorso dinamico dell’URL. Ulteriori informazioni.

    NOTA

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

    Quando definisci 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

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

  3. In Intestazioni definisci le intestazioni HTTP del messaggio di richiesta da inviare al servizio esterno:

    1. Per aggiungere un campo di intestazione, fai clic su Aggiungi un campo intestazione.

    2. Immetti la chiave del campo intestazione.

    3. Per impostare un valore dinamico per la coppia chiave-valore, selezionare Variabile. In caso contrario, seleziona Costante.

      Ad esempio, per una marca temporale, è possibile impostare un valore dinamico.

    4. Se hai selezionato Costante, quindi immetti il valore costante.

      Se hai selezionato Variabile, quindi specificherai questa variabile quando aggiungi l’azione personalizzata a un percorso. Ulteriori informazioni.

    5. Per eliminare un campo intestazione, posizionare il puntatore sul campo intestazione e fare clic sul pulsante Elimina icona.

    La Content-Type e Charset i campi di intestazione sono impostati per impostazione predefinita. Non è possibile modificare o eliminare questi campi.

    Dopo aver aggiunto l’azione personalizzata a un percorso, puoi comunque aggiungergli dei campi di intestazione se il percorso è in stato di bozza. Se non desideri che le modifiche alla configurazione interessino il percorso, duplica l’azione personalizzata e aggiungi i campi di intestazione alla nuova azione personalizzata.

    NOTA

    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.

NOTA

L'esempio di payload non può contenere valori null. I nomi di campo nel payload non possono contenere un "." aggiuntivo. Non possono iniziare con un carattere "$".

Puoi definire il tipo di parametro (ad esempio: (stringa, numero intero, ecc.).

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 in tutti i percorsi. Non varia e l’addetto al marketing non lo vedrà quando utilizza l’azione personalizzata nel percorso. Potrebbe trattarsi, ad esempio, di un ID previsto dal sistema di terze parti. In tal caso, il valore passato è rappresentato dal campo a destra della costante/variabile di attivazione/disattivazione.
  • Variabile indica che il valore del parametro varia. Gli addetti al marketing che utilizzano questa azione personalizzata in un percorso possono passare liberamente il valore desiderato o 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.

In questa pagina