Destination SDK でサポートされる変換関数

Experience Platform Destination SDK は、Experience Platform から書き出されたデータを宛先に必須の形式に変換できる、Pebble テンプレートを使用します。

Experience Platform Pebble 実装には、Pebble が提供する標準バージョンと比較して、いくつかの変更があります。また、Pebble が提供する標準関数に加えて、アドビは、Destination SDK で使用できるいくつかの追加の関数を作成しています。

使用する場所 where-to-use

Experience Platform から宛先に書き出されたデータ用にメッセージ変換テンプレートを作成する場合、このページで後述する、サポートされる関数を使用します。

メッセージ変換テンプレートは、ストリーミング宛先の宛先サーバー設定で使用されます。

前提条件 prerequisites

このリファレンスページの概念および関数を理解するには、最初にメッセージ形式ドキュメントを参照してください。変換するための Pebble テンプレートおよび書き出されたデータを使用する前に、Experience Platform のプロファイルの構造を理解する必要があります。

以下に説明する関数に進む前に、ID、属性およびオーディエンスメンバーシップを変換するためのテンプレート言語の使用の節のテンプレートの例を確認してください。そこに記載されている例は、非常にシンプルなものから始まり、だんだん複雑になっていきます。

サポートされる Pebble 関数 supported-functions

Pebble タグセクションからは、Destination SDK は、以下のみをサポートします。

Pebble フィルターセクションからは、Destination SDK は、すべての関数をサポートします。後述の例では、Destination SDK 内で date 関数をどのように使用できるかを示します。

Pebble 関数セクションからは、アドビは range 関数をサポート​ しません。

date 関数の使用例 date-function

Destination SDK での Pebble 関数の使用例として、date 関数（Pebble ドキュメントへのリンク）を使用してタイムスタンプの形式を変換する方法について、以下を参照してください。

ユースケース

Experience Platform が書き出すデフォルトの ISO 8601 値から宛先で優先される別の値に lastQualificationTime タイムスタンプを変更します。

例

入力

{
"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"
}

アドビが追加した関数 functions-added-by-adobe

Pebble が提供する標準関数に加えて、データ書き出しに使用できる、アドビが作成した追加の関数について、以下を参照してください。

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 関数と、それらを使用して、書き出されたデータの形式をニーズに合わせて調整する方法について確認しました。次に、以下のページを確認する必要があります。