Destination SDK中支援的轉換函式

Experience PlatformDestination SDK使用Pebble 範本,可讓您將從Experience Platform匯出的資料轉換為目的地所需的格式。

與Pebble提供的現成版本相比,Experience PlatformPebble實作有一些變更。 此外,除了Pebble提供的現成函式外,Adobe已建立一些可與Destination SDK搭配使用的其他函式。

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

使用位置 where-to-use

為從Experience Platform匯出至目的地的資料建立訊息轉換範本時,請使用本頁下面列出的支援函式。

訊息轉換範本用於串流目的地的目的地伺服器組態

先決條件 prerequisites

若要瞭解此參考頁面中的概念和函式,請先閱讀訊息格式檔案。 您必須先瞭解Experience Platform中設定檔🔗的結構,才能使用Pebble範本來轉換和匯出的資料。

在繼續使用下列功能之前,請先檢閱使用範本語言進行身分、屬性和對象成員資格轉換一節中的範本範例。 這裡的範例一開始非常簡單,複雜性也增加了。

支援的Pebble函式 supported-functions

從Pebble標籤區段,Destination SDK僅支援:

TIP
反複處理範本中的​ 陣列 ​或​ 對應 ​元素時,使用for會不同。 當反複處理陣列時,可以直接取得元素。 當反複檢視對映時,會取得每個對映專案,每個對映專案都有一個索引鍵/值組。
  • 如需陣列元素的範例,請考慮identityMap名稱空間中的身分,您可以在此重複執行元素,例如identityMap.gaididentityMap.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建立的其他函式,這些函式可用於資料匯出。

addedSegmentsremovedSegments函式 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函式,以及如何使用它們來調整匯出資料的格式,以符合您的需求。 接下來,請檢閱下列頁面:

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