Funções de transformação compatíveis no Destination SDK

Visão geral

Experience Platform Destination SDK use Pebble modelos, permitindo transformar os dados exportados do Experience Platform no formato exigido pelo destino.

O Experience Platform Pebble A implementação tem algumas alterações, em comparação com a versão predefinida fornecida pelo Pebble. Além disso, além das funções prontas para uso fornecidas pelo Pebble, o Adobe criou algumas funções adicionais que podem ser usadas com o Destination SDK.

Onde usar

Use as funções compatíveis listadas mais abaixo nesta página quando criação de um template de transformação de mensagem para os dados exportados do Experience Platform para seu destino. O modelo de transformação de mensagem é usado na variável configuração do servidor de destino para destinos de transmissão.

Pré-requisitos

Para entender os conceitos e as funções nesta página de referência, leia o formato de mensagem documento primeiro. Você precisa entender o estrutura de um perfil no Experience Platform antes de usar Pebble modelos para transformar e os dados exportados.

Antes de avançar para as funções documentadas abaixo, analise os exemplos de modelos na seção Uso de uma linguagem de modelo para as transformações de identidade, atributos e associação de segmento. Os exemplos lá começam muito simples e aumentam a complexidade.

Suportado Pebble funções

No Pebble seção de tags, o Destination SDK suporta apenas:

DICA

Usando for é diferente ao iterar por array ou mapa elementos em um template. Ao iterar por meio de uma matriz, você pode obter o elemento diretamente. Ao iterar por um mapa, você obtém cada entrada de mapa, que tem um par de valor chave.

  • Para obter um exemplo de um elemento de matriz, pense nas identidades em um identityMap namespace, onde você pode iterar por meio de elementos como identityMap.gaid, identityMap.emailou semelhante.
  • Para obter um exemplo de um elemento de mapa, pense em segmentMembership.

No Pebble seção de filtro, o Destination SDK suporta todas as funções. Um exemplo a seguir mostra como a função date pode ser usada dentro do Destination SDK.

No Pebble seção funções, Adobe faz not apoiará intervalo .

Exemplo de como a função date é usada

Para exemplificar como 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 e hora.

Caso de uso

Você deseja alterar a variável lastQualificationTime carimbo de data e hora do 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 por Adobe

Além das funções prontas para uso fornecidas pelo Pebble, consulte abaixo as funções adicionais criadas pelo Adobe que você pode usar nas exportações de dados.

addedSegments e removedSegments funções

Caso de uso

Essas funções podem ser usadas para obter uma lista de segmentos 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

Agora você sabe qual Pebble As funções do são compatíveis com o Destination SDK, bem como como como usá-las para ajustar o formato dos dados exportados para atender às suas necessidades. Em seguida, você deve revisar as seguintes páginas:

Nesta página