Funciones de transformación compatibles con Destination SDK
Experience Platform Destination SDK usa Pebble templates, lo que le permite transformar los datos exportados desde Experience Platform al formato requerido por su destino.
La implementación de Experience Platform Pebble tiene algunos cambios, en comparación con la versión predeterminada proporcionada por Pebble. Además de las funciones predeterminadas que proporciona Pebble, Adobe ha creado algunas funciones adicionales que puede usar con Destination SDK.
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 Pebble plantillas para transformar 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 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, Destination SDK solo admite:
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.emailo similares. - Para ver un ejemplo de un elemento de asignación, vea segmentMembership.
Desde la sección de filtros Pebble, Destination SDK admite todas las funciones. Un ejemplo más abajo muestra cómo se puede usar la función date en Destination SDK.
Desde la sección de funciones Pebble, 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 la función de fecha (link en la documentación de Pebble) transforma el formato de una marca de tiempo.
Ejemplo de uso date-use-case
Desea cambiar la marca de tiempo lastQualificationTime del valor predeterminado ISO 8601 que Experience Platform exporta a otro valor preferido por el destino.
Ejemplo date-example
Entrada date-input
{
"lastQualificationTime": "2022-02-08T18:34:24.000+0000"
}
Formato date-format
{{ lastQualificationTime | date(existingFormat="yyyy-MM-dd'T'HH:mm:sss.SSSX", format="yyyy-MM-dd'T'HH:mm:ssX") }}
Output date-output
{
"lastQualificationTime": "2022-02-21T18:34:24Z"
}
Funciones agregadas por Adobe functions-added-by-adobe
Además de las funciones predeterminadas que proporciona Pebble, vea a continuación las funciones adicionales creadas por Adobe que puede usar para sus exportaciones de datos.
Funciones addedSegments y removedSegments addedsegments-removedsegments-functions
Ejemplo de uso segments-use-case
Estas funciones se pueden utilizar para obtener una lista de audiencias que se añadieron o eliminaron de un perfil.
Ejemplo segments-example
Entrada segments-input
{
"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 segments-format
added: {% for s in addedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}; removed: {% for s in removedSegments(segmentMembership.ups) %}<{{s.key}}>{% endfor %}
Output segments-output
added: <111111><333333>; removed: <222222>
Próximos pasos next-steps
Ahora sabe qué funciones de Pebble son compatibles con Destination SDK, así como cómo utilizarlas para ajustar el formato de los datos exportados y adaptarlos a sus necesidades. A continuación, debe revisar las siguientes páginas: