DocumentaçãoExperience PlatformGuia de destinos

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Usuário

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.

IMPORTANT
Todos os nomes e valores de parâmetros suportados pelo Destination SDK fazem distinção entre maiúsculas e 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 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:

TIP
O uso de 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:

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