Funções de transformação compatíveis com o Destination SDK
O Experience Platform Destination SDK usa Pebble modelos, permitindo que você transforme os dados exportados do Experience Platform no formato exigido pelo seu destino.
A implementação do Experience Platform Pebble possui 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, o 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 em Experience Platform antes de usar Pebble modelos para transformar e exportar os dados.
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 só oferece suporte 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.email
ou semelhante. - Para obter um exemplo de um elemento de mapa, pense em segmentMembership.
Na seção de filtro Pebble, Destination SDK suporta 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, o 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) é usada para transformar o formato de um carimbo de data/hora.
Caso de uso
Você deseja alterar o carimbo de data/hora lastQualificationTime
do valor padrão ISO 8601 que o Experience Platform exporta para outro valor preferido pelo seu destino.
Exemplo
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") }}
Saída
{
"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 para suas exportações de dados.
addedSegments
e removedSegments
funções addedsegments-removedsegments-functions
Caso de uso
Essas funções podem ser usadas para obter uma lista de públicos-alvo que foram adicionados ou removidos de um perfil.
Exemplo
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 %}
Saída
added: <111111><333333>; removed: <222222>
Próximas etapas next-steps
Agora você sabe quais funções Pebble são suportadas no Destination SDK, bem como usá-las para ajustar o formato dos dados exportados para atender às suas necessidades. Em seguida, você deve revisar as seguintes páginas: