Configurazione azioni esterne
Le azioni esterne consentono ai percorsi di account in Journey Optimizer B2B edition di connettersi con i sistemi esterni direttamente dall’area di lavoro del percorso. Quando un pubblico di account raggiunge un nodo di azione esterna, il sistema effettua una chiamata in uscita asincrona a un servizio esterno configurato, trasmettendo i dati degli attributi di pubblico per account, persone o entrambi. Il servizio esterno elabora i dati e risponde utilizzando un callback, restituendo dati sul pubblico e metadati che possono essere utilizzati per guidare l’esecuzione del percorso.
Questa funzione supporta due tipi di nodo di percorso:
- Azione esterna - Chiama un servizio esterno e continua lungo un singolo percorso in uscita. Ideale per integrazioni Fire-and-Dimenticate, ad esempio per aggiornare un record CRM o attivare una notifica downstream.
- Percorsi di suddivisione esterni - Chiama un servizio esterno e valuta la risposta per instradare gli account lungo uno dei diversi percorsi definiti.
Panoramica sull’implementazione
La configurazione delle azioni esterne richiede il coordinamento in tre ruoli in sequenza:
Implementare il servizio esterno implement-service
Lo sviluppatore deve creare e pubblicare un servizio Web pubblico conforme all’interfaccia del provider di servizi Adobe Journey Optimizer B2B edition External Actions.
Dopo che il servizio è attivo, fornisci l’URL della specifica OpenAPI e le credenziali di autenticazione all’amministratore del prodotto responsabile della configurazione dell’azione.
Configurare l’azione configure-action
Un’azione deve essere configurata e attivata prima che gli addetti al marketing possano utilizzarla in un percorso. Le azioni vengono create nello stato Bozza e le modifiche vengono salvate automaticamente. Rimane come bozza finché non la attivate.
-
Vai a Amministrazione > Configurazioni.
-
Fai clic su Azioni esterne nel pannello intermedio.
-
Fai clic su Crea azione in alto a destra.
-
Immetti l’URL della specifica OpenAPI per il servizio esterno e fai clic su Crea.
Affinché questo passaggio abbia esito positivo, il servizio esterno deve essere attivo e raggiungibile. In caso di errore di convalida, nella finestra di dialogo viene visualizzato un messaggio che descrive l’errore e un suggerimento per risolverlo. Per ulteriori informazioni, vedere Risoluzione dei problemi.
-
Quando l’URL viene risolto correttamente, esaminare i Dettagli servizio.
I dettagli del servizio vengono letti direttamente dalla specifica OpenAPI al momento della creazione dell’azione. Non è possibile modificare queste proprietà nella configurazione dopo la creazione.
table 0-row-3 1-row-3 2-row-3 3-row-3 Proprietà Descrizione Proprietà delle specifiche OpenAPI Nome Nome dell’azione info.titleDescrizione Descrizione dell’azione info.descriptionURL URL della specifica OpenAPI che definisce il servizio esterno servers.url -
Immettere le credenziali di Autenticazione per il servizio esterno (
components.securitySchemes).note NOTE I campi delle credenziali visualizzati dipendono dal meccanismo di autenticazione definito nel servizio esterno. I tipi supportati sono API Key, OAuth2 e HTTP Basic Authentication. 
È possibile modificare le credenziali in base alle esigenze quando l’azione configurata è nello stato Bozza o Attivo.
-
Fai clic su Avanti.
-
Imposta le proprietà Configurations per definire il modo in cui l’azione scambia i dati con il servizio esterno.
note NOTE Le proprietà contrassegnate come Statiche non sono aggiornabili al momento della configurazione e si basano sulla definizione del servizio. -
Tipo di azione (Statico) - Tipo di nodo di percorso supportato:
- Azione esterna (
enableSplitPath= false) - Percorso suddivisione azione esterna (
enableSplitPath= true)
Non puoi modificare il tipo di azione dopo aver creato la configurazione dell’azione.
- Azione esterna (
-
Funzioni di accesso (Static) - (Solo percorso suddiviso azione esterna) Le variabili restituite dal servizio esterno sono disponibili come condizioni di percorso in un nodo di percorso suddiviso esterno. (
invocationPayloadDef.accessorsMetadata) -
Contesto Percorso (Statico) - Ambito dei dati del pubblico inviati nella richiesta (
supportedEntityType):-
Account - Invia solo gli account
-
Persone - Invia solo persone
-
Persone nell’account - Invia account e persone correlate all’account
-
-
Campi in uscita - Mappa ogni campo della tabella su un campo XDM. Questi campi vengono inviati nel corpo della richiesta al servizio esterno. Proprietà definizione servizio:
invocationPayloadDef.accountFields,invocationPayloadDef.fields.
-
Campi in ingresso - Mappa ogni campo della tabella su un campo XDM aggiornabile. Questi campi vengono compilati dalla risposta del servizio esterno. Proprietà definizione servizio:
callbackPayloadDef.accountFields,callbackPayloadDef.fields. Aggiornabile dopo la creazione. -
Parametri intestazione - Immettere un valore per ogni riga da passare come intestazione HTTP nella richiesta. Proprietà definizione servizio:
invocationPayloadDef.headers. -
Timeout - Immettere il numero di minuti di attesa per il richiamo del callback da parte del servizio esterno prima che la richiesta venga considerata non riuscita. Proprietà definizione servizio:
timeout. -
Attributi globali - Immettere un valore per ogni riga da includere come campo statico nel corpo della richiesta. Proprietà definizione servizio:
invocationPayloadDef.globalAttributes.
-
-
Fai clic sulla freccia Indietro per tornare all’elenco e mantenere l’azione nello stato Bozza.
In alternativa, fare clic su Attiva per modificare la configurazione dell’azione allo stato Attivo. L’azione esterna configurata deve essere attiva per renderla disponibile per l’utilizzo nei percorsi di account.
Risoluzione dei problemi troubleshooting
Quando si immette l’URL della specifica OpenAPI per il servizio esterno e si fa clic su Crea, il sistema esegue la convalida del servizio. Quando viene rilevato un errore, nella finestra di dialogo viene visualizzato un messaggio che descrive l’errore.
Dettagli errore di convalida
This URL is already used by another external actionAn action with this name already existsinfo.title nella specifica corrisponde a un’azione già esistenteinfo.title della specifica in modo che sia univoco.Duplicate operation ID found in the specificationoperationId.operationId univoco.Field in the specification exceeds the maximum allowed lengthThe entity type value is invalidx- specifica per Adobe per il tipo di entitàThe provided document is not a valid OpenAPI specificationRequired OpenAPI field is missinginfo o paths).Required endpoint is missing from the specificationRequired extension field is missingx- richiesto nelle specifiche.Security schemes are missing from the specificationsecuritySchemes definito nella specifica in components.Multiple authentication types are not supportedThe authentication type is not supportedoauth2 o openIdConnect) non è supportato.The OpenAPI version is not supportedAn unexpected error occurredAggiungere un nodo esterno a un percorso add-journey-node
Dopo l’attivazione di un’azione, gli addetti al marketing possono aggiungere un nodo Azione esterna o Percorso suddiviso esterno a qualsiasi percorso di account. Per informazioni su come aggiungere e utilizzare questi nodi nell’area di lavoro del percorso di account, vedere Nodi esterni.