Funções de transformação compatíveis com o Destination SDK
O Experience Platform Destination SDK usa Pebble modelos, permitindo transformar os dados exportados do Experience Platform no formato exigido pelo seu destino.
A implementação do Experience Platform Pebble tem algumas alterações, em comparação à versão predefinida fornecida por Pebble. Além disso, além das funções prontas para uso fornecidas pelo Pebble, a Adobe criou algumas funções adicionais que você pode usar com o Destination SDK.
Onde usar where-to-use
Use as funções com suporte listadas mais abaixo nesta página ao criar um modelo de transformação de mensagem para os dados exportados do Experience Platform para o seu destino.
O modelo de transformação de mensagem é usado na configuração do servidor de destino para destinos de streaming.
Pré-requisitos prerequisites
Para entender os conceitos e funções nesta página de referência, leia primeiro o documento formato da mensagem. Você precisa entender a estrutura de um perfil no Experience Platform antes de poder usar Pebble modelos para transformar os dados exportados.
Antes de avançar para as funções documentadas abaixo, revise os exemplos de modelos na seção Uso de uma linguagem de modelo para as transformações de identidade, atributos e associação de público-alvo. Os exemplos aqui começam de forma muito simples e aumentam em complexidade.
Pebble funções com suporte supported-functions
Na seção de tags Pebble, o Destination SDK oferece suporte apenas a:
for é diferente ao iterar através de elementos matriz ou mapa em um modelo. Ao iterar por meio de uma matriz, você pode obter o elemento diretamente. Ao percorrer um mapa, você obtém cada entrada de mapa, que tem um par de valores chave.- Para obter um exemplo de um elemento de matriz, pense nas identidades em um namespace identityMap, em que você poderia iterar por meio de elementos como
identityMap.gaid,identityMap.emailou semelhante. - Para obter um exemplo de um elemento de mapa, pense em segmentMembership.
Na seção de filtro Pebble, o Destination SDK dá suporte a todas as funções. Um exemplo mais abaixo mostra como a função date pode ser usada dentro do Destination SDK.
Na seção de funções Pebble, a Adobe não oferece suporte à função range.
Exemplo de como a função date é usada date-function
Para exemplificar como as funções Pebble são usadas no Destination SDK, veja abaixo como a função de data (link na documentação do Pebble) transforma o formato de um carimbo de data/hora.
Caso de uso date-use-case
Você deseja alterar o carimbo de data/hora lastQualificationTime do valor padrão ISO 8601 exportado pelo Experience Platform para outro valor preferido pelo seu destino.
Exemplo 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"
}
Funções adicionadas pelo Adobe functions-added-by-adobe
Além das funções prontas para uso fornecidas pelo Pebble, veja abaixo as funções adicionais criadas pelo Adobe que você pode usar em suas exportações de dados.
addedSegments e removedSegments funções addedsegments-removedsegments-functions
Caso de uso segments-use-case
Essas funções podem ser usadas para obter uma lista de públicos-alvo que foram adicionados ou removidos de um perfil.
Exemplo 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óximas etapas next-steps
Agora você sabe quais Pebble funções têm suporte no Destination SDK e como usá-las para ajustar o formato dos dados exportados de acordo com suas necessidades. Em seguida, você deve revisar as seguintes páginas: