Destination SDK中支持的转换函数

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
目标

创建对象：

管理员
用户

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.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函数，以及如何使用它们调整导出数据的格式以满足您的需求。接下来，您应该查看以下页面：

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6