Panoramica dell’estensione Cloud Connector

L’estensione di inoltro degli eventi Cloud Connector consente di creare richieste HTTP personalizzate per l’invio di dati a una destinazione o il recupero di dati da una destinazione. L’estensione Cloud Connector è simile a Postman su Adobe Experience Platform Edge Network e può essere utilizzata per inviare dati a un endpoint che non ha ancora un’estensione dedicata.

Utilizza questo riferimento per informazioni sulle opzioni disponibili quando utilizzi questa estensione per creare una regola.

Tipo di azione dell’estensione Cloud Connector

Questa sezione descrive il tipo di azione Invia dati disponibile nell’estensione Cloud Connector di Adobe Experience Platform.

Tipo di richiesta

Per selezionare il tipo di richiesta necessario per l’endpoint, seleziona il tipo appropriato nel menu a discesa Tipo di richiesta.

URL dell’endpoint

Nel campo di testo accanto al menu a discesa Tipo richiesta, immetti l’URL dell’endpoint al quale si stanno inviando i dati.

Parametri di query, intestazioni e configurazione corpo

Utilizza ciascuna di queste schede (Parametri query, Intestazioni ed Elementi dati del corpo) per controllare quali dati vengono inviati a un determinato endpoint.

Parametri query

Definisci una chiave e un valore per ogni coppia chiave-valore che si desidera inviare come parametro di stringa di query. Per immettere manualmente un elemento dati, utilizza la tokenizzazione dell’elemento dati con parentesi graffa per l’inoltro di eventi. Per fare riferimento al valore di un elemento dati denominato “siteSection” come chiave o valore, immetti {{siteSection}}. In alternativa, seleziona l’elemento di dati creato in precedenza scegliendolo nel menu a discesa.

Per aggiungere altri parametri di query, seleziona Aggiungi altro.

Intestazioni

Definisci una chiave e un valore per ogni coppia chiave-valore da inviare come intestazione. Per immettere manualmente un elemento dati, utilizza la tokenizzazione dell’elemento dati con parentesi graffa per l’inoltro di eventi. Per fare riferimento al valore di un elemento dati denominato “pageName” come chiave o valore, immetti {{pageName}}. In alternativa, seleziona l’elemento dati creato in precedenza scegliendolo nel menu a discesa.

Per aggiungere altre intestazioni, seleziona Aggiungi altro.

Nella tabella seguente sono elencate le intestazioni predefinite. Non sei limitato a utilizzare solo queste intestazioni: queste sono disponibili per praticità e, se necessario, puoi aggiungere altre intestazioni personalizzate.

Body come JSON

Definire una chiave e un valore per ogni coppia chiave-valore da inviare nel corpo della richiesta. Per immettere manualmente un elemento dati, utilizza la tokenizzazione dell’elemento dati con parentesi graffa per l’inoltro di eventi. Per fare riferimento al valore di un elemento dati denominato "appSection" come chiave o valore, immetti {{appSection}}. In alternativa, seleziona l’elemento di dati creato in precedenza scegliendolo nel menu a discesa.

Per aggiungere altre coppie chiave-valore, seleziona Aggiungi altro.

Body come Raw

Definire una chiave e un valore per ogni coppia chiave-valore da inviare nel corpo della richiesta. Per immettere manualmente un elemento dati, utilizza la tokenizzazione dell’elemento dati con parentesi graffa per l’inoltro di eventi. Per fare riferimento al valore di un elemento dati denominato "appSection" come chiave o valore, immetti {{appSection}}. In alternativa, seleziona l'elemento dati creato in precedenza scegliendolo nel menu a discesa. Puoi aggiungere uno o più elementi di dati.

Avanzate

Le azioni all’interno delle regole nell'inoltro degli eventi vengono eseguite in sequenza. Potrebbero verificarsi situazioni in cui vuoi recuperare dati da una sorgente esterna che non è presente nell'evento in arrivo dal client, quindi rispondere e trasformare o inviare tali dati a una destinazione finale in un'azione successiva all'interno di una singola regola. Questa operazione è possibile tramite l’opzione "Salva la risposta della richiesta" nella sezione avanzata.

Per salvare il corpo della risposta da un endpoint, seleziona la casella Salva la risposta della richiesta e definisci una chiave di risposta nel campo di testo.

Se la chiave di risposta è definita come productDetails, fai riferimento a tali dati in un elemento dati e poi a tale elemento in un'azione successiva all'interno della stessa regola. Per creare un elemento dati che fa riferimento a productDetail, crea un elemento dati di tipo path e immetti il percorso seguente:

arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]

arc.ruleStash.adobe-cloud-connector.reponses.productDetails