DocumentaçãoExperience PlatformGuia de destinos

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

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Admin
  • User

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

O EXPERIENCE PLATFORM Pebble A implementação do tem algumas alterações, em comparação com a versão pronta para uso 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.

IMPORTANT
Todos os nomes e valores de parâmetros compatíveis com o Destination SDK são diferencia maiúsculas de minúsculas. Para evitar erros de diferenciação entre maiúsculas e minúsculas, use os nomes e valores dos parâmetros exatamente como mostrado na documentação.

Onde usar where-to-use

Use as funções suportadas 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 o seu destino.

O template de transformação de mensagem é usado no campo configuração do servidor de destino para destinos de transmissão.

Pré-requisitos prerequisites

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

Antes de avançar para as funções documentadas abaixo, revise os exemplos de modelo na seção Uso de uma linguagem de modelo para as transformações de identidade, atributos e associação de público. Os exemplos aqui começam de forma muito simples e aumentam em complexidade.

Compatível Pebble funções supported-functions

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

TIP
Usar for é diferente ao iterar através matriz ou mapa elementos 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 identityMap namespace, em que você pode iterar por meio de elementos como identityMap.gaid, identityMap.email, ou similar.
  • 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 mais abaixo mostra como a date função pode ser usada dentro do Destination SDK.

No Pebble funções, o Adobe faz não apoiar a intervalo função.

Exemplo de como a variável date é usada date-function

Para exemplificar como Pebble são usadas no Destination SDK, veja abaixo como a função de data (link na documentação do Pebble) é usado para transformar o formato de um carimbo de data e hora.

Caso de uso

Você deseja alterar o 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 pelo Adobe functions-added-by-adobe

Além das funções prontas para uso fornecidas pela Pebble, veja abaixo as funções adicionais criadas pelo Adobe que podem ser usadas nas 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 qual Pebble As funções são compatíveis com o Destination SDK, bem como sobre como usá-las para ajustar o formato dos dados exportados para atender às suas necessidades. Em seguida, você deve revisar as seguintes páginas:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6