Specifiche del server per le destinazioni create con Destination SDK
Le specifiche del server di destinazione definiscono il tipo di piattaforma di destinazione che riceverà i dati da Adobe Experience Platform e i parametri di comunicazione tra Platform e la destinazione. Ad esempio:
- A streaming La specifica del server di destinazione definisce l’endpoint del server HTTP che riceverà i messaggi HTTP da Platform. Per informazioni su come configurare la formattazione delle chiamate HTTP all’endpoint, leggi specifiche modelli pagina.
- Un Amazon S3 specifica del server di destinazione definisce S3 nome del bucket e percorso in cui Platform esporterà i file.
- Un SFTP La specifica del server di destinazione definisce il nome host, la directory principale, la porta di comunicazione e il tipo di crittografia del server SFTP in cui Platform esporta i file.
Per capire dove questo componente si inserisce in un’integrazione creata con Destination SDK, consulta il diagramma riportato di seguito. opzioni di configurazione oppure consulta le seguenti pagine di panoramica sulla configurazione di destinazione:
È possibile configurare le specifiche del server di destinazione tramite /authoring/destination-servers
endpoint. Consulta le seguenti pagine di riferimento API per esempi dettagliati di chiamate API, in cui puoi configurare i componenti mostrati in questa pagina.
Questa pagina mostra tutti i tipi di server di destinazione supportati da Destination SDK, con tutti i relativi parametri di configurazione. Quando crei la destinazione, sostituisci i valori dei parametri con i tuoi.
Tipi di integrazione supportati supported-integration-types
Consulta la tabella seguente per informazioni dettagliate sui tipi di integrazioni che supportano le funzionalità descritte in questa pagina.
Quando creazione o aggiornamento un server di destinazione, utilizza una delle configurazioni del tipo di server descritte in questa pagina. A seconda dei requisiti di integrazione, assicurati di sostituire i valori dei parametri di esempio di questi esempi con i tuoi.
Campi hardcoded e template templatized-fields
Durante la creazione di un server di destinazione tramite Destination SDK, è possibile definire i valori dei parametri di configurazione codificandoli nella configurazione o utilizzando campi modello. I campi con modello consentono di leggere i valori forniti dall’utente dall’interfaccia utente di Platform.
I parametri del server di destinazione hanno due campi configurabili. Queste opzioni determinano se si utilizzano valori hardcoded o template.
templatingStrategy
Obbligatorio. Definisce se è presente un valore hardcoded fornito tramite il value
o un valore configurabile dall’utente nell’interfaccia utente. Valori supportati:
NONE
: utilizza questo valore quando esegui la codifica fissa del valore del parametro tramitevalue
(vedere la riga successiva). Esempio:"value": "my-storage-bucket"
.PEBBLE_V1
: utilizza questo valore quando desideri che gli utenti forniscano un valore per il parametro nell’interfaccia utente. Esempio:"value": "{{customerData.bucket}}"
.
value
Obbligatorio. Definisce il valore del parametro. Tipi di valore supportati:
- Valore hardcoded: utilizza un valore hardcoded (ad esempio
"value": "my-storage-bucket"
) quando non è necessario che gli utenti immettano un valore di parametro nell'interfaccia utente. Quando si codifica un valore,templatingStrategy
deve essere sempre impostato suNONE
. - Valore modellato: utilizza un valore modellato (ad esempio
"value": "{{customerData.bucket}}"
) quando desideri che gli utenti forniscano un valore di parametro nell'interfaccia utente. Quando si utilizzano i valori con modelli,templatingStrategy
deve essere sempre impostato suPEBBLE_V1
.
Quando utilizzare campi hardcoded e campi con modelli
Sia i campi hardcoded che i campi template hanno un proprio uso nella Destination SDK, a seconda del tipo di integrazione che si sta creando.
Connessione alla destinazione senza input dell'utente
Quando gli utenti connettersi alla destinazione nell’interfaccia utente di Platform, potrebbe essere utile gestire il processo di connessione della destinazione senza il relativo input.
A questo scopo, puoi codificare i parametri di connessione della piattaforma di destinazione nelle specifiche del server. Quando si utilizzano valori di parametri hardcoded nella configurazione del server di destinazione, la connessione tra Adobe Experience Platform e la piattaforma di destinazione viene gestita senza alcun input da parte dell’utente.
Nell’esempio seguente, un partner crea un server di destinazione Data Landing Zone con il path.value
campo in codifica fissa.
{
"name":"Data Landing Zone destination server",
"destinationServerType":"FILE_BASED_DLZ",
"fileBasedDlzDestination":{
"path":{
"templatingStrategy":"NONE",
"value":"Your/hardcoded/path/here"
},
"useCase": "Your use case"
}
}
Di conseguenza, quando gli utenti passano attraverso tutorial sulla connessione di destinazione, non visualizzeranno un passaggio di autenticazione. L’autenticazione viene invece gestita da Platform, come illustrato nell’immagine seguente.
Connessione alla destinazione con l'input dell'utente
Quando la connessione tra Platform e la destinazione deve essere stabilita in base a un input specifico dell’utente nell’interfaccia utente di Platform, ad esempio la selezione di un endpoint API o la fornitura di un valore di campo, puoi utilizzare i campi modello nelle specifiche del server per leggere l’input dell’utente e connettersi alla piattaforma di destinazione.
Nell’esempio seguente, un partner crea un’ tempo reale (streaming) integrazione e url.value
utilizza il parametro di modello {{customerData.region}}
per personalizzare parte dell’endpoint API in base all’input dell’utente.
{
"name":"Templatized API endpoint example",
"destinationServerType":"URL_BASED",
"urlBasedDestination":{
"url":{
"templatingStrategy":"PEBBLE_V1",
"value":"https://api.yourcompany.com/data/{{customerData.region}}/items"
}
}
}
Per consentire agli utenti di selezionare un valore dall’interfaccia utente di Platform, l’opzione region
Il parametro deve essere definito anche nel configurazione di destinazione come campo dati cliente, come illustrato di seguito:
"customerDataFields":[
{
"name":"region",
"title":"Region",
"description":"Select an option",
"type":"string",
"isRequired":true,
"readOnly":false,
"enum":[
"US",
"EU"
]
}
Di conseguenza, quando gli utenti passano attraverso tutorial sulla connessione di destinazione, devono selezionare un’area geografica prima di connettersi alla piattaforma di destinazione. Quando si connettono alla destinazione, il campo modello {{customerData.region}}
viene sostituito con il valore selezionato dall’utente nell’interfaccia utente, come illustrato nell’immagine seguente.
Server di destinazione in tempo reale (streaming) streaming-example
Questo tipo di server di destinazione ti consente di esportare dati da Adobe Experience Platform alla destinazione tramite richieste HTTP. La configurazione del server contiene informazioni sul server che riceve i messaggi (il server sul lato dell’utente).
Questo processo distribuisce i dati utente come una serie di messaggi HTTP alla piattaforma di destinazione. I parametri seguenti costituiscono il modello delle specifiche del server HTTP.
L’esempio seguente mostra un esempio di configurazione del server di destinazione per una destinazione in tempo reale (streaming).
{
"name":"Your destination server name",
"destinationServerType":"URL_BASED",
"urlBasedDestination":{
"url":{
"templatingStrategy":"PEBBLE_V1",
"value":"{YOUR_API_ENDPOINT}"
}
}
}
name
Moviestar destination server
.destinationServerType
URL_BASED
per le destinazioni di streaming.templatingStrategy
Obbligatorio.
- Utilizzare
PEBBLE_V1
se utilizzi un campo con modello invece di un valore hardcoded nelvalue
campo. Utilizza questa opzione se disponi di un endpoint come:https://api.moviestar.com/data/{{customerData.region}}/items
, in cui gli utenti devono selezionare l’area dell’endpoint dall’interfaccia utente di Platform. - Utilizzare
NONE
se non è necessaria alcuna trasformazione modellata sul lato Adobe, ad esempio se si dispone di un endpoint come:https://api.moviestar.com/data/items
value
Amazon S3 server di destinazione s3-example
Questo server di destinazione ti consente di esportare i file contenenti dati di Adobe Experience Platform nell’archiviazione Amazon S3.
L’esempio seguente mostra un esempio di configurazione del server di destinazione per una destinazione Amazon S3.
{
"name":"Amazon S3 destination",
"destinationServerType":"FILE_BASED_S3",
"fileBasedS3Destination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
}
name
destinationServerType
FILE_BASED_S3
.fileBasedS3Destination.bucket.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel bucket.value
campo.
- Se desideri che gli utenti inseriscano il proprio nome di bucket nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello pervalue
per leggere un valore da campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un nome di bucket hardcoded per l’integrazione, ad esempio
"bucket.value":"MyBucket"
, quindi imposta questo valore suNONE
.
fileBasedS3Destination.bucket.value
"value":"MyBucket"
.fileBasedS3Destination.path.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel path.value
campo.
- Se desideri che gli utenti inseriscano il proprio percorso nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello perpath.value
per leggere un valore da campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un percorso hardcoded per l’integrazione, ad esempio
"bucket.value":"/path/to/MyBucket"
, quindi imposta questo valore suNONE
.
fileBasedS3Destination.path.value
"value":"/path/to/MyBucket"
.SFTP server di destinazione sftp-example
Questo server di destinazione ti consente di esportare i file contenenti dati di Adobe Experience Platform nel SFTP server di archiviazione.
L’esempio seguente mostra un esempio di configurazione del server di destinazione per una destinazione SFTP.
{
"name":"File-based SFTP destination server",
"destinationServerType":"FILE_BASED_SFTP",
"fileBasedSFTPDestination":{
"rootDirectory":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.rootDirectory}}"
},
"hostName":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.hostName}}"
},
"port":22,
"encryptionMode":"PGP"
}
}
name
destinationServerType
FILE_BASED_SFTP
.fileBasedSFTPDestination.rootDirectory.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel rootDirectory.value
campo.
- Se desideri che gli utenti inseriscano il proprio percorso di directory principale nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello perrootDirectory.value
per leggere un valore fornito dall'utente dal campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un percorso di directory principale hardcoded per l’integrazione, ad esempio
"rootDirectory.value":"Storage/MyDirectory"
, quindi imposta questo valore suNONE
.
fileBasedSFTPDestination.rootDirectory.value
"value":"Storage/MyDirectory"
fileBasedSFTPDestination.hostName.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel hostName.value
campo.
- Se desideri che gli utenti inseriscano il proprio nome host nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello perhostName.value
per leggere un valore fornito dall'utente dal campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un nome host hardcoded per l’integrazione, ad esempio
"hostName.value":"my.hostname.com"
, quindi imposta questo valore suNONE
.
fileBasedSFTPDestination.hostName.value
"hostName.value":"my.hostname.com"
.port
encryptionMode
Indica se utilizzare la crittografia file. Valori supportati:
- PGP
- Nessuna
Azure Data Lake Storage (ADLS) server di destinazione adls-example
Questo server di destinazione ti consente di esportare i file contenenti dati di Adobe Experience Platform nel Azure Data Lake Storage account.
L’esempio seguente mostra un esempio di configurazione del server di destinazione per un Azure Data Lake Storage destinazione.
{
"name":"ADLS destination server",
"destinationServerType":"FILE_BASED_ADLS_GEN2",
"fileBasedAdlsGen2Destination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
}
name
destinationServerType
FILE_BASED_ADLS_GEN2
.fileBasedAdlsGen2Destination.path.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel path.value
campo.
- Se desideri che gli utenti immettano il ADLS nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello perpath.value
per leggere un valore da campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un percorso hardcoded per l’integrazione, ad esempio
"abfs://<file_system>@<account_name>.dfs.core.windows.net/<path>/"
, quindi imposta questo valore suNONE
.
fileBasedAdlsGen2Destination.path.value
abfs://<file_system>@<account_name>.dfs.core.windows.net/<path>/
.Azure Blob Storage server di destinazione blob-example
Questo server di destinazione ti consente di esportare i file contenenti dati di Adobe Experience Platform nel Azure Blob Storage contenitore.
L’esempio seguente mostra un esempio di configurazione del server di destinazione per un Azure Blob Storage destinazione.
{
"name":"Blob destination server",
"destinationServerType":"FILE_BASED_AZURE_BLOB",
"fileBasedAzureBlobDestination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
},
"container":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.container}}"
}
}
}
name
destinationServerType
FILE_BASED_AZURE_BLOB
.fileBasedAzureBlobDestination.path.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel path.value
campo.
- Se desideri che gli utenti inseriscano i propri Azure Blob URI dell'account di archiviazione nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello perpath.value
campo da cui leggere il valore campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un percorso hardcoded per l’integrazione, ad esempio
"path.value": "https://myaccount.blob.core.windows.net/"
, quindi imposta questo valore suNONE
.
fileBasedAzureBlobDestination.path.value
https://myaccount.blob.core.windows.net/
.fileBasedAzureBlobDestination.container.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel container.value
campo.
- Se desideri che gli utenti inseriscano i propri Azure Blob nome contenitore nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello percontainer.value
campo da cui leggere il valore campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se per l’integrazione utilizzi un nome di contenitore hardcoded, ad esempio
"path.value: myContainer"
, quindi imposta questo valore suNONE
.
fileBasedAzureBlobDestination.container.value
myContainer
.Data Landing Zone (DLZ) server di destinazione dlz-example
Questo server di destinazione ti consente di esportare i file contenenti i dati di Platform in una Data Landing Zone archiviazione.
L’esempio seguente mostra un esempio di configurazione del server di destinazione per un Data Landing Zone (DLZ) destinazione.
{
"name":"Data Landing Zone destination server",
"destinationServerType":"FILE_BASED_DLZ",
"fileBasedDlzDestination":{
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
},
"useCase": "Your use case"
}
}
name
destinationServerType
FILE_BASED_DLZ
.fileBasedDlzDestination.path.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel path.value
campo.
- Se desideri che gli utenti inseriscano i propri Data Landing Zone nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello perpath.value
per leggere un valore da campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un percorso hardcoded per l’integrazione, ad esempio
"path.value": "https://myaccount.blob.core.windows.net/"
, quindi imposta questo valore suNONE
.
fileBasedDlzDestination.path.value
Google Cloud Storage server di destinazione gcs-example
Questo server di destinazione ti consente di esportare i file contenenti i dati di Platform nel Google Cloud Storage account.
L’esempio seguente mostra un esempio di configurazione del server di destinazione per un Google Cloud Storage destinazione.
{
"name":"Google Cloud Storage Server",
"destinationServerType":"FILE_BASED_GOOGLE_CLOUD",
"fileBasedGoogleCloudStorageDestination":{
"bucket":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.bucket}}"
},
"path":{
"templatingStrategy":"PEBBLE_V1",
"value":"{{customerData.path}}"
}
}
}
name
destinationServerType
FILE_BASED_GOOGLE_CLOUD
.fileBasedGoogleCloudStorageDestination.bucket.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel bucket.value
campo.
- Se desideri che gli utenti inseriscano i propri Google Cloud Storage nome del bucket nell’interfaccia utente Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello perbucket.value
per leggere un valore da campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un nome di bucket hardcoded per l’integrazione, ad esempio
"bucket.value": "my-bucket"
, quindi imposta questo valore suNONE
.
fileBasedGoogleCloudStorageDestination.bucket.value
"value": "my-bucket"
.fileBasedGoogleCloudStorageDestination.path.templatingStrategy
Obbligatorio. Imposta questo valore in base al tipo di valore utilizzato nel path.value
campo.
- Se desideri che gli utenti inseriscano i propri Google Cloud Storage nell’interfaccia utente di Experienci Platform, imposta questo valore su
PEBBLE_V1
. In questo caso, è necessario creare un modello perpath.value
per leggere un valore da campi dati cliente compilato dall’utente. Questo caso d’uso è illustrato nell’esempio precedente. - Se utilizzi un percorso hardcoded per l’integrazione, ad esempio
"path.value": "/path/to/my-bucket"
, quindi imposta questo valore suNONE
.
fileBasedGoogleCloudStorageDestination.path.value
"value": "/path/to/my-bucket"
.Passaggi successivi next-steps
Dopo aver letto questo articolo, è necessario comprendere meglio cosa è una specifica del server di destinazione e come configurarla.
Per ulteriori informazioni sugli altri componenti del server di destinazione, consulta i seguenti articoli: