目的地傳遞

為了讓您更能掌控匯出至目的地資料的著陸位置,Destination SDK可讓您指定目的地傳送設定。

目的地傳送區段會指出匯出的資料前往何處,以及資料著陸位置所使用的驗證規則。

若要瞭解此元件在何處適合使用Destination SDK建立的整合,請參閱組態選項檔案中的圖表,或檢視下列目的地組態概觀頁面:

您可以透過/authoring/destinations端點設定目的地傳遞設定。 請參閱下列API參考頁面,以取得詳細的API呼叫範例,您可在此範例設定本頁面中顯示的元件。

本文會說明您可用於目的地的所有支援目的地傳送選項。

IMPORTANT
Destination SDK支援的所有引數名稱和值都區分大小寫​**​**。 為避免區分大小寫錯誤,請完全依照檔案中所示使用引數名稱和值。

支援的整合型別 supported-integration-types

如需瞭解哪些型別的整合支援本頁面所述功能的詳細資訊,請參閱下表。

整合型別
支援功能
即時(串流)整合
檔案式(批次)整合

支援的引數 supported-parameters

設定目的地傳送設定時,您可以使用下表所述的引數來定義應傳送已匯出資料的位置。

參數
類型
說明
authenticationRule
字串

指示Platform應該如何連線到您的目的地。 支援的值:

  • CUSTOMER_AUTHENTICATION:如果Platform客戶透過此處說明的任何驗證方法登入您的系統,請使用此選項。
  • PLATFORM_AUTHENTICATION:如果Adobe與您的目的地之間有全域驗證系統,且Platform客戶不需要提供任何驗證認證即可連線至您的目的地,請使用此選項。 在此情況下,您必須使用認證API設定來建立認證物件。
  • NONE:如果不需要驗證即可將資料傳送至您的目的地平台,請使用此選項。
destinationServerId
字串
您要匯出資料的目的地伺服器instanceId
deliveryMatchers.type
字串
  • 設定檔案型目的地的目的地傳遞時,請一律將此項設為SOURCE
  • 設定串流目的地的目的地傳遞時,deliveryMatchers區段不是必要的。
deliveryMatchers.value
字串
  • 設定檔案型目的地的目的地傳遞時,請一律將此項設為batch
  • 設定串流目的地的目的地傳遞時,deliveryMatchers區段不是必要的。

串流目的地的目的地傳送設定 destination-delivery-streaming

以下範例說明應如何為串流目的地設定目的地傳送設定。 請注意,串流目的地不需要deliveryMatchers區段。

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

檔案型目的地的目的地傳送設定 destination-delivery-file-based

以下範例說明應如何針對以檔案為基礎的目的地設定目的地傳送設定。 請注意,以檔案為基礎的目的地需要deliveryMatchers區段。

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

後續步驟 next-steps

閱讀本文後,您應該更加瞭解如何針對串流和檔案型目的地,設定目的地應匯出資料的位置。

若要深入瞭解其他目的地元件,請參閱下列文章:

7f4d1967-bf93-4dba-9789-bb6b505339d6