DocumentaciónExperience PlatformGuía de destinos

Funciones de transformación compatibles en Destination SDK

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

Creado para:

  • Administrador
  • Usuario

El Destination SDK de Experience Platform usa Pebble templates, lo que le permite transformar los datos exportados desde el Experience Platform al formato requerido por el destino.

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

IMPORTANT
Todos los nombres y valores de parámetro admitidos por el Destination SDK distinguen entre mayúsculas y minúsculas 1}. 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

Use las funciones admitidas que se enumeran a continuación en esta página al crear una plantilla de transformación de mensajes para los datos exportados fuera de Experience Platform a su destino.

La plantilla de transformación de mensajes se usa en la configuración del servidor de destino para los destinos de flujo continuo.

Requisitos previos prerequisites

Para comprender los conceptos y las funciones de esta página de referencia, lea primero el documento formato del mensaje. Necesita comprender la estructura de un perfil en Experience Platform para poder usar las plantillas Pebble para transformar y exportar los 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 creación de plantillas para las transformaciones de identidad, atributos y pertenencia a audiencias. Los ejemplos comienzan muy simples y aumentan en complejidad.

Funciones Pebble compatibles supported-functions

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

TIP
El uso de for es diferente al iterar a través de matriz o mapa elementos en 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 un área de nombres identityMap, donde podría iterar a través de elementos como identityMap.gaid, identityMap.email o similares.
  • Para ver un ejemplo de un elemento de asignación, vea segmentMembership.

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

Desde la sección de funciones Pebble, el Adobe no admite la función range.

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

Para ejemplificar cómo se usan las funciones Pebble en Destination SDK, vea a continuación cómo se usa la función de fecha (link en la documentación de Pebble) para transformar el formato de una marca de tiempo.

Ejemplo de uso

Desea cambiar la marca de tiempo lastQualificationTime del valor predeterminado 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") }}

Salida

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

Funciones agregadas por Adobe functions-added-by-adobe

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

Funciones addedSegments y removedSegments addedsegments-removedsegments-functions

Ejemplo 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 %}
Salida
added: <111111><333333>; removed: <222222>

Pasos siguientes next-steps

Ahora sabe qué funciones de Pebble se admiten en Destination SDK, así como cómo 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