[Disponibilidade limitada]{class="badge informative"}
Usar dados da Adobe Experience Platform para personalização aep-data
Nesta página: saiba como usar a função auxiliar datasetLookup no editor de personalização para recuperar campos dos conjuntos de dados de registro do Adobe Experience Platform e personalizar seu conteúdo.
O Journey Optimizer permite aproveitar os dados dos conjuntos de dados de registros do Adobe Experience Platform no editor de personalização para personalizar seu conteúdo. Antes de iniciar, os conjuntos de dados necessários para a personalização da pesquisa devem ser habilitados primeiro para a pesquisa. Informações detalhadas estão disponíveis nesta seção: Usar dados do Adobe Experience Platform.
Depois que um conjunto de dados é habilitado para personalização de pesquisa, você pode usar seus dados para personalizar seu conteúdo no Journey Optimizer.
-
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:
code language-none {{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 O valor inserido para este campo pode ser uma ID de campo ( profile.packages.packageSKU), um campo passado em um evento de jornada (context.journey.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.
accordion Onde recuperar uma ID de conjunto de dados? As IDs dos conjuntos de dados podem ser recuperadas na interface do usuário do Adobe Experience Platform. Saiba como trabalhar com conjuntos de dados na documentação do Adobe Experience Platform.
-
-
Adapte a sintaxe de acordo com suas necessidades. Neste exemplo, queremos recuperar dados relacionados aos voos dos passageiros. A sintaxe é a seguinte:
code language-none {{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:
code language-none {{result.fieldId}}note NOTE Ao referenciar um campo do conjunto de dados, verifique se você corresponde ao caminho de campo completo, conforme definido no esquema. Não há limites rígidos no número de campos que podem ser obtidos usando a função auxiliar. No entanto, para obter o melhor desempenho, é recomendável manter o número de campos abaixo de 50 para evitar impacto na taxa de transferência. -
resultado é o valor atribuído ao parâmetro resultado na função auxiliar datasetLookup. 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 método de simulação: clique em Simular conteúdo para testar as variações de conteúdo com dados de entrada de exemplo ou geração automática de IA, ou clique em Simular conteúdo e selecione Simular conteúdo (perfis do AEP) na lista suspensa para visualizar com perfis de teste. Saiba como visualizar e testar o conteúdo
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page teaches how to use the
datasetLookuphelper function in the Journey Optimizer personalization editor to retrieve fields from Adobe Experience Platform record datasets and incorporate them into message personalization.
Intents:
- Enable an AEP record dataset for lookup personalization
- Add the
datasetLookuphelper function to a personalization expression - Configure the function with a dataset ID, join key, result alias, and required flag
- Reference retrieved dataset fields in personalization expressions using the result alias
- Test personalized content using the Simulate content flow
Glossary:
- datasetLookup: A helper function in the personalization editor that retrieves field values from an AEP record dataset by joining on a specified key. (product-specific)
- Record dataset: An Adobe Experience Platform dataset type containing record-level data that can be enabled for lookup personalization. (product-specific)
- Lookup personalization: The process of fetching fields from an AEP record dataset at send time to personalize message content. (product-specific)
- result parameter: An arbitrary alias assigned in the
datasetLookupcall; used to reference all retrieved field values in subsequent expressions (e.g.{{result.fieldId}}). - required parameter: A boolean flag in
datasetLookupthat controls whether message delivery requires a matching key to be found in the dataset.
Guardrails:
- Feature is in Limited Availability — not yet generally available to all customers.
- The
datasetLookuphelper function within expression fragments is available to a limited set of customers only; contact your Adobe representative to gain access. - Datasets must be explicitly enabled for lookup personalization before they can be used with
datasetLookup. - Keep the number of fields retrieved per
datasetLookupcall under 50 to avoid impacting throughput (recommended limit — no hard limit is stated on the page).
Terminology:
- Canonical name: datasetLookup — variants: dataset lookup, dataset lookup helper, dataset lookup helper function
- Synonyms: “datasetLookup” = “dataset lookup helper function”
- Do not confuse: “datasetId” (identifier of the AEP dataset) ≠ “id” (the source column used to join with the dataset’s primary identity) ≠ “result” (the alias for referencing retrieved field values)
FAQ:
- Q: What is the
datasetLookuphelper function? — It is a helper function in the personalization editor that retrieves field values from Adobe Experience Platform record datasets, allowing you to incorporate that data into message personalization. - Q: What happens if
required=falseand no matching key is found in the dataset? — The message can still be delivered. It is recommended to account for fallback or default values in your message content when usingrequired=false. - Q: What happens if
required=trueand no matching key is found? — The message will only be delivered if a matching key is found in the dataset. - Q: Where do I find the dataset ID and field IDs needed for the syntax? — Dataset IDs can be retrieved in the Adobe Experience Platform UI under Datasets. Field IDs are visible when previewing a dataset and browsing the record schema in the AEP UI.
- Q: How do I test content that uses
datasetLookup? — Use the Simulate content button to test with sample input data or AI auto-generation, or select Simulate content (AEP profiles) from the dropdown to preview with test profiles.