Consegna della destinazione

Per offrire un maggiore controllo sulla destinazione dei dati esportati, Destination SDK consente di specificare le impostazioni di consegna della destinazione.

La sezione di consegna della destinazione indica dove vanno i dati esportati e quale regola di autenticazione viene utilizzata nella posizione in cui verranno recapitati i dati.

Per capire dove questo componente si inserisce in un'integrazione creata con Destination SDK, consulta il diagramma nella documentazione delle opzioni di configurazione oppure vedi le seguenti pagine di panoramica sulla configurazione di destinazione:

È possibile configurare le impostazioni di consegna di destinazione tramite l'endpoint /authoring/destinations. Consulta le seguenti pagine di riferimento API per esempi dettagliati di chiamate API, in cui puoi configurare i componenti mostrati in questa pagina.

Questo articolo descrive tutte le opzioni di consegna di destinazione supportate che puoi utilizzare per la tua destinazione.

IMPORTANT
Tutti i nomi e i valori dei parametri supportati da Destination SDK sono con distinzione tra maiuscole e minuscole. Per evitare errori di distinzione tra maiuscole e minuscole, utilizza i nomi e i valori dei parametri esattamente come mostrato nella documentazione.

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.

Tipo di integrazione
Supporta la funzionalità
Integrazioni in tempo reale (streaming)
Integrazioni basate su file (batch)

Parametri supportati supported-parameters

Quando configuri le impostazioni di consegna di destinazione, puoi utilizzare i parametri descritti nella tabella seguente per definire dove devono essere inviati i dati esportati.

Parametro
Tipo
Descrizione
authenticationRule
Stringa

Indica come Platform deve connettersi alla destinazione. Valori supportati:

  • CUSTOMER_AUTHENTICATION: utilizzare questa opzione se i clienti di Platform accedono al sistema tramite uno dei metodi di autenticazione descritti qui.
  • PLATFORM_AUTHENTICATION: utilizzare questa opzione se è presente un Adobe di autenticazione globale tra e la destinazione e il cliente Platform non deve fornire credenziali di autenticazione per connettersi alla destinazione. In questo caso, è necessario creare un oggetto credenziali utilizzando la configurazione credentials API.
  • NONE: utilizzare questa opzione se non è richiesta alcuna autenticazione per inviare dati alla piattaforma di destinazione.
destinationServerId
Stringa
instanceId del server di destinazione in cui si desidera esportare i dati.
deliveryMatchers.type
Stringa
  • Durante la configurazione della consegna di destinazione per le destinazioni basate su file, impostare sempre questa opzione su SOURCE.
  • Durante la configurazione della consegna di destinazione per una destinazione di streaming, la sezione deliveryMatchers non è richiesta.
deliveryMatchers.value
Stringa
  • Durante la configurazione della consegna di destinazione per le destinazioni basate su file, impostare sempre questa opzione su batch.
  • Durante la configurazione della consegna di destinazione per una destinazione di streaming, la sezione deliveryMatchers non è richiesta.

Impostazioni di consegna della destinazione per le destinazioni di streaming destination-delivery-streaming

L’esempio seguente mostra come configurare le impostazioni di consegna di destinazione per una destinazione di streaming. La sezione deliveryMatchers non è necessaria per le destinazioni di streaming.

recommendation-more-help
{
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Impostazioni di consegna delle destinazioni per destinazioni basate su file destination-delivery-file-based

L’esempio seguente mostra come configurare le impostazioni di consegna di destinazione per una destinazione basata su file. La sezione deliveryMatchers è obbligatoria per le destinazioni basate su file.

{
   "destinationDelivery":[
      {
         "deliveryMatchers":[
            {
               "type":"SOURCE",
               "value":[
                  "batch"
               ]
            }
         ],
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Passaggi successivi next-steps

Dopo aver letto questo articolo, dovresti sapere meglio come configurare le posizioni in cui la tua destinazione deve esportare i dati, sia per le destinazioni in streaming che per quelle basate su file.

Per ulteriori informazioni sugli altri componenti di destinazione, consulta i seguenti articoli:

7f4d1967-bf93-4dba-9789-bb6b505339d6