Funciones de transformación admitidas en el Destination SDK

Información general

Experience Platform Destination SDK utiliza Pebble plantillas, lo que permite transformar los datos exportados desde el Experience Platform en el formato requerido por el destino.

El Experience Platform Pebble La implementación de tiene algunos cambios, en comparación con la versión predeterminada proporcionada por Pebble. Además de las funciones integradas que proporciona Pebble, Adobe ha creado algunas funciones adicionales que puede utilizar con Destination SDK.

Dónde se utiliza

Utilice las funciones compatibles que se enumeran más adelante en esta página cuando creación de una plantilla de transformación de mensaje para los datos exportados fuera del Experience Platform al destino. La plantilla de transformación de mensaje se utiliza en la variable configuración del servidor de destino para destinos de flujo continuo.

Requisitos previos

Para comprender los conceptos y las funciones de esta página de referencia, lea la formato del mensaje documento primero. Debe comprender el estructura de un perfil en Experience Platform antes de poder usar Pebble plantillas para transformar y exportar datos.

Antes de avanzar a las funciones documentadas a continuación, revise los ejemplos de creación de plantillas en la sección Uso de un idioma de plantilla para las transformaciones de identidad, atributos y pertenencia a segmentos. Los ejemplos de ahí empiezan de forma muy simple y aumentan la complejidad.

Admitido Pebble funciones

En el Pebble etiquetas , el Destination SDK solo admite:

SUGERENCIA

Uso for es diferente al iterar matriz o map elementos de una plantilla. Al iterar a través de una matriz, puede obtener el elemento directamente. Cuando se repite a través de un mapa, se obtiene cada entrada de mapa, que tiene un par clave-valor.

  • Para ver un ejemplo de un elemento de matriz, piense en las identidades de un identityMap área de nombres, donde puede iterar entre elementos como identityMap.gaid, identityMap.email, o similar.
  • Para ver un ejemplo de un elemento de mapa, piense en segmentMembership.

En el Pebble filtro , Destination SDK admite todas las funciones. Un ejemplo más abajo muestra cómo date puede utilizarse en Destination SDK.

En el Pebble sección funciones, el Adobe sí not soporte técnico range función.

Ejemplo de cómo date se utiliza

Para ejemplificar cómo Pebble en Destination SDK, consulte a continuación cómo funciona date (vínculo en la documentación de Pebble) se utiliza para transformar el formato de una marca de tiempo.

Caso de uso

Desea cambiar la variable lastQualificationTime marca de tiempo de la predeterminada ISO 8601 que el Experience Platform exporta a otro valor preferido por el destino.

Ejemplo

Entrada

{
"lastQualificationTime": "2022-02-08T18:34:24.000+0000"
}

Formato

{{ lastQualificationTime | date(existingFormat="yyyy-MM-dd'T'HH:mm:sss.SSSX", format="yyyy-MM-dd'T'HH:mm:ssX") }}

Output

{
"lastQualificationTime": "2022-02-21T18:34:24Z"
}

Funciones agregadas por Adobe

Además de las funciones integradas que proporciona Pebble, consulte a continuación las funciones adicionales creadas por Adobe que puede utilizar para sus exportaciones de datos.

addedSegments y removedSegments funciones

Caso de uso

Estas funciones se pueden utilizar para obtener una lista de segmentos que se han agregado o eliminado de un perfil.

Ejemplo

Entrada
{
  "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"
      }
    }
  }
}
Formato
added: {% for s in addedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}; removed: {% for s in removedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}
Salida
added: <111111><333333>; removed: <222222>

Pasos siguientes

Ahora sabe cuál Pebble son compatibles con Destination SDK, así como con cómo utilizarlas para ajustar el formato de los datos exportados según sus necesidades. A continuación, debe revisar las páginas siguientes:

En esta página