Destination SDK中支援的轉換函式
Experience PlatformDestination SDK使用Pebble 範本,可讓您將從Experience Platform匯出的資料轉換為目的地所需的格式。
與Pebble提供的現成版本相比,Experience PlatformPebble實作有一些變更。 此外,除了Pebble提供的現成函式外,Adobe已建立一些可與Destination SDK搭配使用的其他函式。
使用位置 where-to-use
當為從Experience Platform匯出至目的地的資料建立訊息轉換範本時,請使用本頁下面列出的支援函式。
訊息轉換範本用於串流目的地的目的地伺服器組態。
先決條件 prerequisites
若要瞭解此參考頁面中的概念和函式,請先閱讀訊息格式檔案。 您必須先瞭解Experience Platform中設定檔🔗的結構,才能使用Pebble範本來轉換和匯出的資料。
在繼續使用下列功能之前,請先檢閱使用範本語言進行身分、屬性和對象成員資格轉換一節中的範本範例。 這裡的範例一開始非常簡單,複雜性也增加了。
支援的Pebble函式 supported-functions
從Pebble標籤區段,Destination SDK僅支援:
for
會不同。 當反複處理陣列時,可以直接取得元素。 當反複檢視對映時,會取得每個對映專案,每個對映專案都有一個索引鍵/值組。- 如需陣列元素的範例,請考慮identityMap名稱空間中的身分,您可以在此重複執行元素,例如
identityMap.gaid
、identityMap.email
或類似專案。 - 如需對應元素的範例,請考慮segmentMembership。
從Pebble篩選區段,Destination SDK支援所有函式。 以下進一步的範例說明如何在Destination SDK中使用date
函式。
從Pebble函式區段,Adobe 不 支援範圍函式。
如何使用date
函式的範例 date-function
若要說明Pebble函式在Destination SDK中的使用方式,請參閱以下說明如何使用日期函式(Pebble檔案中的連結)來轉換時間戳記的格式。
使用實例
您想要將lastQualificationTime
時間戳記從Experience Platform匯出的預設ISO 8601值變更為您目的地偏好的其他值。
範例
輸入
{
"lastQualificationTime": "2022-02-08T18:34:24.000+0000"
}
格式
{{ lastQualificationTime | date(existingFormat="yyyy-MM-dd'T'HH:mm:sss.SSSX", format="yyyy-MM-dd'T'HH:mm:ssX") }}
匯出
{
"lastQualificationTime": "2022-02-21T18:34:24Z"
}
Adobe新增的函式 functions-added-by-adobe
除了Pebble提供的現成函式之外,請參閱下方Adobe建立的其他函式,這些函式可用於資料匯出。
addedSegments
和removedSegments
函式 addedsegments-removedsegments-functions
使用實例
這些函式可用於取得新增到設定檔或從中移除的對象清單。
範例
輸入
{
"identityMap": {
"myIdNamespace": [
{
"id": "external_id1"
},
{
"id": "external_id2"
}
]
},
"segmentMembership": {
"ups": {
"111111": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
},
"222222": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "exited"
},
"333333": {
"lastQualificationTime": "2019-11-20T13:15:49Z",
"status": "realized"
}
}
}
}
格式
added: {% for s in addedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}; removed: {% for s in removedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}
匯出
added: <111111><333333>; removed: <222222>
後續步驟 next-steps
您現在知道Destination SDK支援哪些Pebble函式,以及如何使用它們來調整匯出資料的格式,以符合您的需求。 接下來,請檢閱下列頁面: