Configurare un’azione personalizzata configure-a-custom-action
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, nella categoria Azione. Per ulteriori informazioni, consulta questa pagina.
Limitazioni custom-actions-limitations
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 in questo caso d'uso.
Le azioni personalizzate supportano il formato JSON solo quando si utilizza richiesta o payload di risposta.
Best practice custom-action-enhancements-best-practices
Quando scegli un endpoint per il targeting utilizzando un’azione personalizzata, assicurati che:
- Questo endpoint possa supportare la velocità effettiva del percorso utilizzando le configurazioni della API di limitazione o API di limitazione di utilizzo per limitarlo. Fai attenzione che una configurazione di limitazione non può scendere al di sotto di 200 TPS. Qualsiasi endpoint di destinazione dovrà supportare almeno 200 TPS.
- Questo endpoint deve avere un tempo di risposta il più basso possibile. A seconda della velocità effettiva prevista, avere un tempo di risposta elevato potrebbe influire sulla velocità effettiva.
Per tutte le azioni personalizzate viene definito un limite massimo di 300.000 chiamate in un minuto. Inoltre, il limite predefinito viene eseguito per host e per sandbox. Ad esempio, se in una sandbox hai due endpoint con lo stesso host (ad esempio: https://www.adobe.com/endpoint1 e https://www.adobe.com/endpoint2), il limite verrà applicato a tutti gli endpoint nell’host adobe.com. "endpoint1" ed "endpoint2" condivideranno la stessa configurazione di limitazione e il fatto che un endpoint raggiunga il limite avrà un impatto sull’altro endpoint.
Questo limite è stato impostato in base all’utilizzo da parte della clientela, per proteggere gli endpoint esterni interessati dalle azioni personalizzate. Devi tenerne conto nei percorsi basati sul pubblico definendo una velocità di lettura appropriata (5000 profili al secondo quando vengono utilizzate le azioni personalizzate). Se necessario, puoi ignorare questa impostazione definendo un limite di limitazione di utilizzo o di limitazione maggiore tramite le rispettive API. Consulta questa pagina.
Non eseguire il targeting degli endpoint pubblici con azioni personalizzate per vari motivi:
- Senza limiti o limitazioni corretti, esiste il rischio di inviare troppe chiamate a un endpoint pubblico che potrebbe non supportare tale volume.
- I dati del profilo possono essere inviati tramite azioni personalizzate, pertanto il targeting di un endpoint pubblico potrebbe causare la condivisione involontaria di informazioni personali esternamente.
- Non hai alcun controllo sui dati restituiti dagli endpoint pubblici. Se un endpoint modifica la propria API o inizia a inviare informazioni errate, queste saranno rese disponibili nelle comunicazioni inviate, con potenziali effetti negativi.
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:
Passaggi di configurazione configuration-steps
Di seguito sono riportati i passaggi principali necessari per configurare un’azione personalizzata:
-
Nella sezione del menu AMMINISTRAZIONE, selezionare Configurazioni. Nella sezione Azioni, 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.
-
Immetti un nome per l'azione.
note note NOTE Sono consentiti solo caratteri alfanumerici e trattini bassi. La lunghezza massima è di 30 caratteri. -
Aggiungi una descrizione all’azione. Questo passaggio è facoltativo.
-
Il numero di percorsi che utilizzano questa azione viene visualizzato nel campo Usato in. È possibile fare clic sul pulsante Visualizza percorsi per visualizzare l'elenco dei percorsi che utilizzano questa azione.
-
Definisci i diversi parametri di configurazione URL. Consulta questa pagina.
-
Configura la sezione Autenticazione. Questa configurazione è la stessa delle origini dati. Consulta questa sezione.
-
Definisci i parametri azione. Consulta questa pagina.
-
Fai clic su Salva.
L’azione personalizzata è ora configurata ed è pronta per essere utilizzata nei percorsi. Consulta questa pagina.
note note NOTE Quando un’azione personalizzata viene utilizzata in un percorso, la maggior parte dei parametri è di sola lettura. Puoi modificare solo i campi Nome, Descrizione, URL e la sezione Autenticazione.
Configurazione endpoint url-configuration
Durante la configurazione di un'azione personalizzata, è necessario definire i seguenti parametri di configurazione dell'endpoint:
-
Nel campo 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. Ulteriori informazioni.
note note NOTE 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. -
-
Selezionare la chiamata Metodo: può essere POST, GET o PUT.
note note NOTE Metodo DELETE non supportato. Se devi aggiornare una risorsa esistente, seleziona il metodo PUT. -
Definisci le intestazioni e i parametri di query:
- Nella sezione Intestazioni, fai clic su Aggiungi un campo di intestazione per definire le intestazioni HTTP del messaggio di richiesta da inviare al servizio esterno. I campi di intestazione Content-Type e Charset sono impostati per impostazione predefinita. Non è possibile eliminare questi campi. Solo l'intestazione Content-Type può essere modificata. Il suo valore deve rispettare il formato JSON. Di seguito è riportato il valore predefinito:
- Nella sezione Parametri query, fai clic su Aggiungi un campo Parametro query per definire i parametri che desideri aggiungere nell'URL.
-
Immettere l'etichetta o il nome del campo.
-
Selezionare il tipo: Costante o Variabile. Se hai selezionato Costante, immetti il valore costante nel campo Valore. Se hai selezionato Variabile, specificherai questa variabile quando aggiungi l'azione personalizzata a un percorso. Ulteriori informazioni.
note note NOTE 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 sono disponibili in questa documentazione.
Supporto del protocollo mTLS mtls-protocol-support
Puoi utilizzare Mutual Transport Layer Security (mTLS) per garantire una maggiore sicurezza nelle connessioni in uscita alle azioni personalizzate di Adobe Journey Optimizer. mTLS è un metodo di sicurezza end-to-end per l’autenticazione reciproca che garantisce che entrambe le parti che condividono le informazioni siano chi affermano di essere prima che i dati vengano condivisi. mTLS include un ulteriore passaggio rispetto a TLS, in cui il server richiede anche il certificato del client e lo verifica alla loro fine.
L’autenticazione reciproca TLS (mTLS) è supportata nelle azioni personalizzate. Non è necessaria alcuna configurazione aggiuntiva nell’azione o nel percorso personalizzato per attivare mTLS; l’attivazione viene eseguita automaticamente quando viene rilevato un endpoint abilitato per mTLS. Ulteriori informazioni.
Definire i parametri di payload define-the-message-parameters
Puoi definire il parametro payload come descritto di seguito:
-
Nella sezione Request (Richiesta), incolla un esempio del payload JSON da inviare al servizio esterno. Questo campo è facoltativo e disponibile solo per i metodi di chiamata POST e PUT.
Abilita l'opzione Consenti valori NULL per mantenere valori Null nella chiamata esterna. Si noti che l’invio di array di int, stringa, ecc. con valori Null all’interno di non è del tutto supportato. Ad esempio, la seguente matrice di numeri interi
[1, null, 2, 3]viene inviata come[1, 2, 3]anche se questa opzione è selezionata. Inoltre, se tale array è null, viene inviato come array vuoto.
-
Nella sezione Risposta, incolla un esempio del payload restituito dalla chiamata. Questo campo è facoltativo e disponibile per tutti i metodi di chiamata. Per informazioni dettagliate su come sfruttare le risposte alle chiamate API nelle azioni personalizzate, consulta questa pagina.
. né iniziare con un carattere $.
Nella configurazione del campo, devi:
-
Seleziona il tipo di parametro, ad esempio stringa, numero intero e così via.
-
Definisci una costante o un parametro 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 può visualizzarlo quando utilizza l’azione personalizzata nel percorso. Potrebbe essere ad esempio un ID previsto dal sistema di terze parti. In tal caso, il valore costante viene impostato sul campo a destra della costante/variabile di attivazione.
-
Variabile indica che il valore del parametro può variare. Gli addetti al marketing che utilizzano questa azione personalizzata in un percorso sono 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.
Per i parametri facoltativi, abilitare l'opzione È facoltativo alla fine della riga. Selezionando questa opzione, contrassegni il parametro come non obbligatorio e consenti ai professionisti del percorso di scegliere se compilarlo o meno durante la creazione dell’azione personalizzata in un percorso.
-