Risolvere i problemi relativi alle azioni personalizzate troubleshoot-a-custom-action
Puoi verificare le azioni personalizzate inviando chiamate API dalla sezione amministrazione dell’interfaccia utente di Journey Optimizer. Questa funzionalità consente di risolvere i problemi relativi alle azioni personalizzate prima o dopo il loro utilizzo in un percorso.
In qualità di amministratore, utilizza la funzionalità Invia richiesta di test per convalidare le configurazioni delle azioni personalizzate effettuando chiamate API reali direttamente da Adobe Journey Optimizer. Questa funzione assicura che la struttura della richiesta, le intestazioni, l’autenticazione e il payload siano formattati correttamente prima di essere utilizzati in un percorso.
Utilizza questa funzionalità per semplificare il processo di test e convalida, garantendo il corretto funzionamento delle azioni personalizzate nei percorsi live.
Prerequisiti troubleshoot-custom-action-prereq
Per utilizzare la funzionalità Invia richiesta di test, è necessario preconfigurare un'azione personalizzata con un URL, intestazioni e impostazioni di autenticazione.
Affinché gli amministratori possano utilizzare questa funzionalità, sono necessarie le seguenti autorizzazioni:
- Gli utenti devono disporre dell'autorizzazione Manage journeys events, data sources and actions.
- Questa autorizzazione è inclusa nel ruolo Amministratori di Percorso.
- La sola autorizzazione View journeys events non è sufficiente.
Ulteriori informazioni sulle autorizzazioni di percorso in questa sezione.
Come utilizzare la funzione Send test request troubleshoot-custom-action-use
Per testare un’azione personalizzata, effettua le seguenti operazioni:
-
Passa alla schermata di configurazione Azioni e seleziona un'azione personalizzata.
-
Fai clic sul pulsante Invia richiesta test nella parte inferiore della schermata di configurazione dell'azione.
-
Nella finestra pop-up, che consente di specificare i parametri della richiesta:
-
Se il metodo di azione personalizzato è GET, non è richiesto alcun payload.
-
Se il metodo di azione personalizzato è POST, è necessario fornire un payload JSON.
note note NOTE Adobe Journey Optimizer genererà un errore se la struttura di questo JSON non è corretta, ma non lo farà in caso di mancata corrispondenza con un tipo di dati. Ad esempio, non si verifica alcun errore se si utilizza un parametro intero per quella che deve essere una stringa. -
Se è definita l'autenticazione, verrà richiesto di immettere i dettagli di autenticazione.
-
-
Fai clic su Invia per eseguire la richiesta.
-
La risposta dall’API, incluse le intestazioni e i codici di stato, verrà visualizzata nell’interfaccia.
Gestione dell’autenticazione troubleshoot-custom-action-auth
Quando un’azione personalizzata include l’autenticazione, Adobe Journey Optimizer richiede all’utente di immettere i dettagli di autenticazione per ogni richiesta di test:
- Autenticazione di base: L'utente deve fornire la password.
- Autenticazione chiave API: L'utente deve immettere la chiave API value.
- Autenticazione personalizzata: L'utente deve fornire i parametri di autenticazione nella richiesta bodyParam. In questo caso vengono aggiunte due sezioni: Richiesta di autenticazione e Risposta di autenticazione.
Vantaggi chiave troubleshoot-custom-action-benefits
In qualità di amministratore di Journey Optimizer, puoi anche utilizzare strumenti esterni (ad esempio, Postman) per testare le azioni personalizzate. Di seguito sono elencati i principali vantaggi della funzionalità di risoluzione dei problemi interna al prodotto rispetto a un test esterno:
-
La richiesta di test viene eseguita da AJO Percorsi, ovvero:
- Viene utilizzata la struttura esatta della richiesta (comprese le intestazioni specifiche di Adobe Journey Optimizer).
- L’IP sorgente e le intestazioni corrispondono a quelle utilizzate nei percorsi live.
-
La funzionalità Invia richiesta di test può essere utilizzata per la risoluzione dei problemi di percorsi live, in quanto l'azione personalizzata è già distribuita.
-
Questa funzionalità di test interna al prodotto elimina la necessità di copiare manualmente i dettagli di configurazione tra gli strumenti, riducendo il rischio di errori.
Risoluzione dei problemi troubleshoot-custom-action-check
Se la richiesta non riesce, puoi controllare:
- Credenziali di autenticazione immesse nel test.
- Il metodo di richiesta (GET vs. POST) e il payload corrispondente.
- L’endpoint API e le intestazioni definiti nell’azione personalizzata.
- Utilizza i dati di risposta per identificare potenziali configurazioni errate.