Usar dados da Adobe Experience Platform em jornadas datalookup

Filtragem com base na categoria do produto

Cenário:Send um cupom para usuários que gastam mais de US$ 40 em produtos domésticos.

Fluxo de Jornadas:

1. Evento de compra: capturar SKUs do carrinho do usuário.

2. Atividade de pesquisa do conjunto de dados:

   • Conjunto de dados: products-dataset (SKU como chave primária).
   • Chaves de Pesquisa: list(@event{purchase_event.products.sku}).
   • Campos a Retornar: ["SKU", "category", "price"].

3. Atividade de condição:

   • Filtrar SKUs em que a categoria é “residência”.

     code language-none
     @event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookupActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}

   OR

   • Agregar o total gasto em produtos domésticos e compará-lo ao limite de US$ 40.

     code language-none
     sum(@event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookUpActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}.price}, ',', true ) > 40

4. Editor Personalization:

   Use os dados enriquecidos para personalizar o conteúdo do email:

   code language-none
   {% let householdTotal = 0 %} {{#each journey.datasetlookup.3709000.entities as |product|}} {%#if get(product, "category") = "household"%} {% let householdTotal = householdTotal + product.price %}{%/if%} {{/each}} "Hi, thanks for spending " + {%= householdTotal %} + " on household products. Here is your reward!"

Personalization usando dados de fidelidade externos

Cenário: identifique qual conta de email de um perfil tem um Status de Fidelidade Platinum. Nesse cenário, a conta de fidelidade é associada a uma ID de email e os dados de fidelidade não estão disponíveis na loja de pesquisa de perfil padrão.

Fluxo de Jornadas:

1. Acionador do Evento de Perfil: Capturar IDs de email do perfil ou do contexto do evento.

2. Atividade de Pesquisa de Conjunto de Dados:

   • Conjunto de dados: loyalty-member-dataset (email como chave primária).
   • Chaves de Pesquisa: @profile.email.
   • Campos a Retornar: ["email", "loyaltyTier"].

3. Atividade de condição:

   Ramifique a jornada com base no nível de fidelidade:

   code language-none
   @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum'

4. Editor Personalization:

   Use os dados da camada de fidelidade enriquecida para personalizar a comunicação de saída:

   code language-none
   {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}

Referência de conhecimento de IA

Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.

Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.

• TL;DR: Esta página explica como configurar a atividade de pesquisa do Conjunto de dados para recuperar dinamicamente os dados do conjunto de dados de registros do AEP no tempo de execução do jornada para personalização em tempo real e lógica condicional.

Intenções:

• Adicione uma atividade de pesquisa do conjunto de dados a uma jornada para buscar dados de registros externos do AEP no tempo de execução
• Selecionar campos de conjunto de dados específicos (nós de folha/valores primitivos) para recuperar durante a pesquisa
• Definir uma chave de pesquisa no modo avançado para unir o contexto de jornada com registros de conjunto de dados
• Usar dados enriquecidos do conjunto de dados no editor de expressão de jornada ou no editor de personalização
• Solução de problemas de erros “Pesquisa de conjunto de dados não encontrada” causados pelo uso do modo simples para a chave de pesquisa

Glossário:

• Atividade de pesquisa do conjunto de dados: uma atividade de orquestração de jornada que recupera dados de conjuntos de dados de registros AEP em tempo de execução usando uma chave de junção (específico do produto)
• Nó de folha: um campo no nível mais baixo de uma hierarquia de esquema que contém um valor primitivo (sequência, número, booleano, data) (específico do produto)
• Chave de pesquisa: a expressão de associação (cadeia de caracteres ou lista de cadeias de caracteres) usada para corresponder dados de contexto de jornada com registros no conjunto de dados selecionado (específico do produto)
• Dados enriquecidos: dados recuperados por uma atividade de pesquisa do Conjunto de Dados e armazenados transitoriamente no contexto de jornada para uso em atividades downstream (específico do produto)

Medidas de Proteção:

• Máximo de 10 atividades de pesquisa do conjunto de dados por jornada.
• Máximo de 20 campos selecionados por atividade de pesquisa.
• Máximo de 50 chaves na matriz de chaves de pesquisa.
• O tamanho de dados enriquecido é limitado a 10 KB.
• O conjunto de dados deve ser ativado para pesquisa no Adobe Experience Platform antes de aparecer na configuração da atividade.
• Somente nós de folha (valores primitivos) podem ser selecionados; matrizes e mapas não podem ser selecionados.
• Somente cadeias de caracteres ou listas de cadeias de caracteres têm suporte como chaves de pesquisa.
• A chave de pesquisa deve ser definida no modo avançado; o uso do modo simples faz com que a saída da atividade fique indisponível como um atributo de contexto downstream.
• Os dados enriquecidos são transitórios e estão disponíveis apenas durante o tempo de execução do jornada e na personalização da atividade de saída.
• Para obter o melhor desempenho, limite de 5 atividades de pesquisa por jornada (recomendado); o limite rígido aplicado pelo sistema é de 10 atividades por jornada. Até 20 atributos por pesquisa também são recomendados.

Terminologia:

• Nome canônico: Atividade de pesquisa do conjunto de dados — Acrônimo: n/a — variantes: pesquisa de dados do AEP, atividade de enriquecimento de dados
• Sinônimos: “chave de pesquisa” = “chave de associação”
• Não confunda: “Atividade de pesquisa do conjunto de dados” ≠ “Pesquisa de evento de experiência” — a pesquisa do conjunto de dados recupera dados do conjunto de dados de registro, não eventos de experiência de série de tempo

Perguntas frequentes:

• P: Por que meu conjunto de dados não aparece na lista suspensa de campos Conjunto de dados? — O conjunto de dados deve estar habilitado para pesquisa no Adobe Experience Platform. Siga as instruções na seção Must-read para ativá-la.
• P: Por que @datasetLookup{} retorna um erro “Pesquisa de conjunto de dados não encontrada” em uma condição? — A chave de pesquisa foi definida usando o modo simples em vez do modo avançado. Redefina-a no modo avançado e republique a jornada.
• P: Posso recuperar matrizes ou mapear campos do conjunto de dados? — Não, somente campos de nó de folha primitivos (sequência, número, booleano, data) podem ser selecionados.
• P: Como faço para acessar dados enriquecidos em um email? — Use o editor de personalização com a sintaxe {{context.journey.datasetLookup.<activityId>.entities}}.
• P: Os dados enriquecidos persistem após o término da jornada? — Não, os dados enriquecidos são transitórios e só ficam disponíveis durante a sessão de tempo de execução do jornada.