以Destination SDK建立之目的地的範本規格

使用目的地伺服器設定的範本規格部分來設定如何格式化傳送到目的地的HTTP要求。

在範本規格中,您可以定義如何在XDM結構描述和平台支援的格式之間轉換設定檔屬性欄位。

範本規格是即時(串流)目的地的目的地伺服器設定的一部分。

若要瞭解此元件在何處適合使用Destination SDK建立的整合,請參閱設定選項檔案中的圖表,或參閱如何使用Destination SDK設定串流目的地的指南。

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

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

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

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

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

設定範本規格 configure-template-spec

Adobe使用類似Jinja的範本化語言,將XDM結構描述的欄位轉換為目的地支援的格式。

醒目提示的範本設定

如需轉換的詳細資訊,請造訪下列連結:

TIP
Adobe提供開發人員工具,可協助您建立和測試訊息轉換範本。

請參閱以下的HTTP要求範本範例,以及各個引數的說明。

{
   "httpTemplate":{
      "httpMethod":"POST",
      "requestBody":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{ \"attributes\": [ {% for ns in [\"external_id\", \"yourdestination_id\"] %} {% if input.profile.identityMap[ns] is not empty and first_namespace_encountered %} , {% endif %} {% set first_namespace_encountered = true %} {% for identity in input.profile.identityMap[ns]%} { \"{{ ns }}\": \"{{ identity.id }}\" {% if input.profile.segmentMembership.ups is not empty %} , \"AEPSegments\": { \"add\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"realized\" or segment.value.status == \"existing\" %} {% if added_segment_found %} , {% endif %} {% set added_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ], \"remove\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"exited\" %} {% if removed_segment_found %} , {% endif %} {% set removed_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ] } {% set removed_segment_found = false %} {% set added_segment_found = false %} {% endif %} {% if input.profile.attributes is not empty %} , {% endif %} {% for attribute in input.profile.attributes %} \"{{ attribute.key }}\": {% if attribute.value is empty %} null {% else %} \"{{ attribute.value.value }}\" {% endif %} {% if not loop.last%} , {% endif %} {% endfor %} } {% if not loop.last %} , {% endif %} {% endfor %} {% endfor %} ] }"
      },
      "contentType":"application/json"
   }
}
參數
類型
說明
httpMethod
字串
必要。 Adobe將在伺服器呼叫中使用的方法。 支援的方法: GETPUTPOSTDELETEPATCH
templatingStrategy
字串
必要。 ​使用PEBBLE_V1
value
字串
必要。 ​此字串是範本的字元逸出版本,可將Platform傳送的HTTP要求格式化為您目的地預期的格式。
如需如何撰寫範本的詳細資訊,請使用範本🔗閱讀上的區段。
如需字元逸出的詳細資訊,請參閱RFC JSON標準第7節
如需簡單轉換的範例,請參閱設定檔屬性轉換。
contentType
字串
必要。 ​您的伺服器接受的內容型別。 視轉換範本產生的輸出型別而定,這可以是任何支援的HTTP應用程式內容型別。 在大多數情況下,這個值應該設定為application/json

後續步驟 next-steps

閱讀本文後,您應該更瞭解什麼是範本規格,以及如何進行設定。

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

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6