DocumentaciónExperience PlatformGuía de destinos

Funciones de transformación compatibles en Destination SDK

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Admin
  • User

El Destination SDK Experience Platform utiliza Pebble templates, lo que permite transformar los datos exportados desde Experience Platform al 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 ofrece el producto, Pebble, Adobe ha creado algunas funciones adicionales que puede utilizar con Destination SDK.

IMPORTANT
Todos los nombres y valores de parámetro admitidos por el Destination SDK son distingue mayúsculas de minúsculas. Para evitar errores de distinción entre mayúsculas y minúsculas, utilice los nombres y valores de los parámetros exactamente como se muestra en la documentación.

Dónde se usa where-to-use

Utilice las funciones admitidas que se enumeran a continuación en esta página cuando creación de una plantilla de transformación de mensaje para los datos exportados fuera de Experience Platform a su destino.

La plantilla de transformación de mensajes se utiliza en la configuración del servidor de destino para destinos de streaming.

Requisitos previos prerequisites

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 los datos exportados.

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 audiencias. Los ejemplos comienzan muy simples y aumentan en complejidad.

Admitido Pebble Funciones supported-functions

Desde el Pebble sección de etiquetas, el Destination SDK solo admite:

TIP
Uso de for es diferente al iterar matriz o asignar elementos de una plantilla. Al iterar a través de una matriz, puede obtener el elemento directamente. Al iterar a través de un mapa, se obtiene cada entrada del mapa, que tiene un par clave-valor.
  • Para ver un ejemplo de un elemento de matriz, piense en las identidades de una matriz identityMap área de nombres, donde puede iterar a través de elementos como identityMap.gaid, identityMap.email, o similar.
  • Para ver un ejemplo de un elemento de mapa, piense en segmentMembership.

Desde el Pebble filtro, el Destination SDK admite todas las funciones. Un ejemplo más abajo muestra cómo se puede usar la función date se puede utilizar dentro de Destination SDK.

Desde el Pebble sección de funciones, el Adobe sí no admiten el intervalo función.

Ejemplo de cómo el date se utiliza la función date-function

Para ejemplificar cómo Pebble funciones se utilizan en Destination SDK; consulte a continuación cómo funciona la fecha (Vínculo en la documentación de Pebble) se utiliza para transformar el formato de una marca de tiempo.

Caso de uso

Desea cambiar el lastQualificationTime marca de tiempo predeterminada ISO 8601 valor 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 functions-added-by-adobe

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

addedSegments y removedSegments Funciones addedsegments-removedsegments-functions

Caso de uso

Estas funciones se pueden utilizar para obtener una lista de audiencias que se añadieron o eliminaron 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 %}
Output
added: <111111><333333>; removed: <222222>

Pasos siguientes next-steps

Ahora sabe cuál Pebble Las funciones de se admiten en Destination SDK, así como la forma de utilizarlas para ajustar el formato de los datos exportados según sus necesidades. A continuación, debe revisar las siguientes páginas:

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