Destination SDK中支持的转换函数

Experience PlatformDestination SDK使用 Pebble 模板,允许您将从Experience Platform导出的数据转换为目标所需的格式。

Experience Platform Pebble 与提供的现成版本相比,实施有一些变化 Pebble. 此外,除了提供的现成功能外, 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 namespace,您可以在其中循环访问元素,例如 identityMap.gaididentityMap.email或类似项。
  • 有关映射元素的示例,请考虑 区段成员资格.

从 Pebble 过滤器部分,Destination SDK支持所有函数。 下面的另一个示例显示了 date 函数可在Destination SDK中使用。

从 Pebble 函数部分,Adobe执行 支持 范围 函数。

示例 date 函数使用 date-function

举例说明 Pebble 函数在Destination SDK中使用,请参阅下面日期函数的使用方式(Pebble文档的链接)用于转换时间戳的格式。

用例

要更改 lastQualificationTime 默认时间戳 ISO 8601 Experience Platform导出到您的目标首选的其他值的值。

示例

输入

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

您现在知道了哪个 Pebble Destination SDK支持各种函数,以及如何使用它们调整导出数据的格式以满足您的需求。 接下来,您应该查看以下页面:

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