Usar dados da Adobe Experience Platform para personalização aep-data

Abra o editor de personalização, que está disponível em todos os contextos, onde é possível definir personalização, como mensagens. Saiba como trabalhar com o editor de personalização

Navegue até a lista de funções auxiliares e adicione a função auxiliar datasetLookup ao painel de código.

Essa função fornece uma sintaxe predefinida para permitir que você chame campos a partir de conjuntos de dados da Adobe Experience Platform. A sintaxe é a seguinte:

{{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}

• datasetId é a ID do conjunto de dados com o qual você está trabalhando.

• id é a identificação da coluna de origem que deve ser unida à identidade primária do conjunto de dados de pesquisa.

  note note
  NOTE
  O valor inserido para este campo pode ser uma ID de campo (profile.packages.packageSKU), um campo passado em um evento de jornada (context.jornada.events.event_ID.productSKU) ou um valor estático (sku007653). Em qualquer caso, o sistema usará o valor e pesquisará no conjunto de dados para verificar se ele corresponde a uma chave.
  Se estiver usando um valor de sequência literal para a chave, mantenha o texto entre aspas. Por exemplo: {{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}. Se estiver usando um valor de atributo como uma chave dinâmica, remova as aspas. Por exemplo: {{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}}

• resultado é um nome arbitrário que você precisa fornecer para fazer referência a todos os valores de campo que você vai recuperar do conjunto de dados. Esse valor será usado no código para chamar cada campo.

• required=false: se o valor required for definido como TRUE, a mensagem só será entregue se uma chave correspondente for encontrada. Se definido como false, uma chave correspondente não será necessária e a mensagem ainda poderá ser entregue. Observe que, se definido como falso, é recomendável levar em conta os valores de fallback ou padrão no conteúdo da mensagem.

Adapte a sintaxe de acordo com suas necessidades. Neste exemplo, queremos recuperar dados relacionados aos voos dos passageiros. A sintaxe é a seguinte:

{{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}

• Estamos trabalhando no conjunto de dados cuja ID é "1234567890abcdtId",
• O campo que queremos usar para fazer uma associação com o conjunto de dados de pesquisa é profile.comingFlightId,
• Queremos incluir todos os valores de campo sob a referência "flight".

Depois que a sintaxe a ser chamada no conjunto de dados do Adobe Experience Platform for configurada, você poderá especificar quais campos deseja recuperar. A sintaxe é a seguinte:

{{result.fieldId}}

• resultado é o valor atribuído ao parâmetro resultado na função auxiliar MultiEntity. Neste exemplo, "voo".

• fieldID é a identificação do campo que você deseja recuperar. Esta ID é visível na interface do usuário Adobe Experience Platform ao navegar pelo esquema de registro relacionado ao seu conjunto de dados:

  accordion
  Onde recuperar uma ID de campo?
  As IDs de campos podem ser recuperadas ao visualizar um conjunto de dados na interface do usuário do Adobe Experience Platform. Saiba como visualizar conjuntos de dados na documentação do Adobe Experience Platform.

Neste exemplo, queremos usar informações relacionadas ao horário e ao portão de embarque dos passageiros. Portanto, adicionamos estas duas linhas:

• {{flight._myorg.booking.boardingTime}}
• {{flight._myorg.booking.gate}}

Agora que o código está pronto, você pode concluir o conteúdo como de costume e testá-lo usando o botão Simular conteúdo para verificar a personalização. Saiba como visualizar e testar o conteúdo