Creare una configurazione del server di destinazione
La creazione di un server di destinazione è il primo passo per la creazione di una destinazione personalizzata con Destination SDK. Il server di destinazione include opzioni di configurazione per server e modello specifiche, formato del messaggioe formattazione file (per destinazioni basate su file).
Questa pagina esemplifica la richiesta API e il payload che è possibile utilizzare per creare il server di destinazione utilizzando /authoring/destination-servers
Endpoint API
Per una descrizione dettagliata delle funzionalità che puoi configurare tramite questo endpoint, leggi i seguenti articoli:
Guida introduttiva alle operazioni API del server di destinazione get-started
Prima di continuare, controlla guida introduttiva per informazioni importanti che è necessario conoscere per effettuare correttamente chiamate all’API, tra cui come ottenere l’autorizzazione di authoring della destinazione richiesta e le intestazioni richieste.
Creare una configurazione del server di destinazione create
È possibile creare una nuova configurazione del server di destinazione effettuando una POST
richiesta al /authoring/destination-servers
endpoint.
platform.adobe.io/data/core/activation/authoring/destination-servers
Formato API
POST /authoring/destination-servers
A seconda del tipo di destinazione creato, è necessario configurare un tipo leggermente diverso di server di destinazione.
Creare server di destinazione con schema statico static-destination-servers
Vedi nelle schede seguenti esempi di server di destinazione per le destinazioni che utilizzano schemi statici.
I payload di esempio seguenti includono tutti i parametri supportati da ciascun tipo di server di destinazione. Non è necessario includere tutti i parametri nella richiesta. Il payload è personalizzabile in base alle tue esigenze.
Seleziona ciascuna scheda di seguito per visualizzare le richieste API corrispondenti.
Creare un server di destinazione in tempo reale (streaming)
Quando configuri un’integrazione basata su API in tempo reale (streaming), devi creare un server di destinazione in tempo reale (streaming) simile a quello mostrato di seguito.
accordion | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | ||||||||||||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Creare un server di destinazione Amazon S3
Devi creare un’ Amazon S3 server di destinazione simile a quello mostrato di seguito quando si configura un server basato su file Amazon S3 destinazione.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | |||||||||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Creare un SFTP server di destinazione
Devi creare un’ SFTP server di destinazione simile a quello mostrato di seguito quando si configura un server basato su file SFTP destinazione.
accordion | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | |||||||||||||||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Creare un Azure Data Lake Storage server di destinazione
Devi creare un’ Azure Data Lake Storage server di destinazione simile a quello mostrato di seguito quando si configura un server basato su file Azure Data Lake Storage destinazione.
accordion | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | |||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Creare un Azure Blob Storage server di destinazione
Devi creare un’ Azure Blob Storage server di destinazione simile a quello mostrato di seguito quando si configura un server basato su file Azure Blob Storage destinazione.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | |||||||||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Creare un Data Landing Zone (DLZ) server di destinazione
Devi creare un Data Landing Zone (DLZ) server di destinazione simile a quello mostrato di seguito quando si configura un server basato su file Data Landing Zone (DLZ) destinazione.
accordion | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | |||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Creare un Google Cloud Storage server di destinazione
Devi creare un Google Cloud Storage server di destinazione simile a quello mostrato di seguito quando si configura un server basato su file Google Cloud Storage destinazione.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | |||||||||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Creare server di destinazione con schema dinamico dynamic-schema-servers
Gli schemi dinamici ti consentono di recuperare dinamicamente gli attributi di destinazione supportati e generare schemi in base alla tua API. Per configurare lo schema, è necessario configurare un server di destinazione per gli schemi dinamici.
Vedi nella scheda seguente un esempio di server di destinazione per le destinazioni che utilizzano schemi dinamici.
Il payload di esempio seguente include tutti i parametri necessari per un server di schema dinamico.
Creare un server di schema dinamico
Quando configuri una destinazione che recupera lo schema del profilo dal tuo endpoint API, devi creare un server schema dinamico simile a quello mostrato di seguito. A differenza di uno schema statico, uno schema dinamico non utilizza profileFields
array. Gli schemi dinamici utilizzano invece un server di schema dinamico che si connette alla tua API da dove recupera la configurazione dello schema.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | |||||||||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Creare server di destinazione dinamici a discesa dynamic-dropdown-servers
Utilizzare elenchi a discesa dinamici per recuperare e popolare dinamicamente i campi dei dati dei clienti a discesa, in base alla tua API. Ad esempio, puoi recuperare un elenco di account utente esistenti che desideri utilizzare per una connessione di destinazione.
Prima di poter configurare il campo dati cliente a discesa dinamico, è necessario configurare un server di destinazione per i menu a discesa dinamici.
Vedi nella scheda seguente un esempio di server di destinazione utilizzato per recuperare in modo dinamico da un’API i valori da visualizzare in un selettore a discesa.
Il payload di esempio seguente include tutti i parametri necessari per un server di schema dinamico.
Creare un server a discesa dinamico
Quando configuri una destinazione che recupera i valori di un campo dati cliente a discesa dal tuo endpoint API, devi creare un server a discesa dinamico simile a quello mostrato di seguito.
accordion | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Richiesta | ||||||||||||||||||||||||||||||||
|
accordion |
---|
Risposta |
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della configurazione del server di destinazione appena creata. |
Gestione degli errori API error-handling
Gli endpoint API di Destination SDK seguono i principi generali dei messaggi di errore API di Experience Platform. Fai riferimento a Codici di stato API e errori di intestazione della richiesta nella guida alla risoluzione dei problemi di Platform.
Passaggi successivi next-steps
Dopo aver letto questo documento, ora sai come creare un nuovo server di destinazione tramite la Destination SDK /authoring/destination-servers
Endpoint API
Per ulteriori informazioni su cosa è possibile fare con questo endpoint, consulta i seguenti articoli:
Per capire dove questo endpoint si inserisce nel processo di authoring della destinazione, vedi i seguenti articoli: