Nesta página: saiba como usar a atividade de ação Atualizar Perfil para enriquecer ou corrigir um perfil existente do Adobe Experience Platform à medida que um cliente avança em uma jornada.
Use a atividade de ação Atualizar Perfil para enriquecer ou corrigir um perfil Adobe Experience Platform existente à medida que um cliente avança em uma jornada. É possível definir valores de campo originados de um evento de jornada, uma fonte de dados configurada ou um valor estático — permitindo que você mantenha os dados do perfil precisos e acionáveis sem sair da tela de jornada. Antes de configurar esta atividade, leia as medidas de proteção e limitações aplicáveis.
Seleção do conjunto de dados dataset-selection
A atividade Atualizar Perfil requer um conjunto de dados dedicado para armazenar atualizações. Como esta atividade atualiza apenas o Repositório de Perfis (não o Datalake), todas as atualizações devem ser salvas em um conjunto de dados habilitado para perfil especificamente designado para as ações Atualizar Perfil.
Além disso, a configuração da atividade Atualizar Perfil não requer um namespace de identidade. Dessa forma, verifique se o conjunto de dados selecionado usa o mesmo namespace de identidade usado pela ação que iniciou a jornada, pois é esse namespace que essas atualizações usarão. O mapa de identidade também pode ser usado pelo conjunto de dados selecionado. Falha ao selecionar um conjunto de dados com o namespace de identidade correto ou um que usa o mapa de identidade causará a falha da atividade Atualizar Perfil.
Configurar a atividade de atualização do perfil use-profile-update
Siga as etapas abaixo para configurar a atividade Atualizar Perfil na sua jornada.
-
Comece a projetar sua jornada. Saiba mais em Criar a primeira jornada.
-
Na seção Ação da paleta, solte a atividade Atualizar Perfil na tela.
-
Selecione um esquema na lista.
note NOTE Somente os campos que já existem no esquema do Perfil XDM selecionado estão disponíveis para seleção. Se o campo necessário não estiver listado, adicione-o ao esquema no Adobe Experience Platform primeiro. -
Clique em Campo para selecionar o campo que deseja atualizar.
-
Selecione um conjunto de dados na lista.
note NOTE A ação Atualizar Perfil atualiza os dados do perfil em tempo real, mas não atualiza os conjuntos de dados. A seleção do conjunto de dados é necessária, pois o perfil é um registro relacionado a um conjunto de dados. -
Clique no campo Value para definir o valor que você deseja usar:
-
Usando o editor de expressões simples, é possível selecionar um campo de uma fonte de dados ou do evento de entrada.
-
Para definir um valor específico ou aproveitar funções avançadas, selecione Modo avançado.
-
-
Para atualizar atributos de perfil adicionais na mesma ação, clique em Atualizar outro campo e repita a seleção de campo e valor. Você pode adicionar até cinco pares de campo/valor em uma única ação Atualizar Perfil. Consulte Medidas de proteção e limitações.
A atividade Atualizar Perfil está configurada.
Testar a atualização do perfil using-the-test-mode
Esteja ciente de que no modo de teste, as atualizações de perfil entram em vigor imediatamente no perfil de teste e não são simuladas.
Somente perfis de teste podem entrar em uma jornada no modo de teste. Você pode criar um novo perfil de teste ou converter um perfil existente em um perfil de teste. No Adobe Experience Platform, os atributos de perfil podem ser atualizados por uma importação de arquivo CSV ou chamadas de API. Uma alternativa mais rápida é usar uma atividade Atualizar perfil dentro da própria jornada para definir o campo booleano do perfil de teste como verdadeiro.
Para obter mais informações sobre como transformar um perfil existente em um perfil de teste, consulte esta seção.
Medidas de proteção e limitações guardrails
- A ação Atualizar Perfil só pode ser usada em jornadas que tenham um namespace.
- A ação atualiza apenas os campos existentes, não cria novos campos de perfil.
- A ação só oferece suporte a tipos de campos simples (sequência, número, booleano). Campos XDM definidos como enumerações, valores sugeridos, matrizes de objetos ou coleções complexas (por exemplo, listas de produtos) não são compatíveis.
- Você não pode usar a ação Atualizar Perfil para gerar eventos de experiência, como uma compra.
- Como qualquer outra ação, você pode definir um caminho alternativo em caso de erro ou tempo limite. Duas ações não podem ser colocadas em paralelo.
- Não há garantias de que as atualizações de perfil estarão imediatamente disponíveis downstream na mesma jornada. Evite colocar uma ação que leia um campo diretamente após a ação Atualizar Perfil que o grava, pois o valor atualizado pode não ser refletido ainda.
- A atividade Atualizar perfil atualiza somente o Repositório de Perfis, não o Data Lake.
- Até cinco pares de campo/valor podem ser atualizados em uma única ação Atualizar Perfil. Use o botão Atualizar outro campo para adicionar mais pares.
- Para obter um melhor desempenho, agrupe várias atualizações de atributo em uma única ação Atualizar Perfil em vez de usar uma ação por atributo.
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 Atualizar Perfil para enriquecer ou corrigir um perfil do Adobe Experience Platform existente com dados de eventos de jornada, fontes de dados ou valores estáticos à medida que um cliente avança em uma jornada.
Intenções:
- Configure a atividade Atualizar perfil para modificar atributos de perfil existentes durante uma jornada
- Selecionar um conjunto de dados habilitado para perfil dedicado às ações Atualizar perfil
- Mapear valores de campo de eventos de jornada, fontes de dados ou valores estáticos para atributos de perfil
- Atualizar vários atributos de perfil (até cinco) em uma única atividade
- Atualizações de perfil de teste no modo de teste do jornada
Glossário:
- Atualizar atividade do perfil: uma atividade de ação que grava novos valores em campos existentes em um perfil do Adobe Experience Platform em tempo real, conforme um perfil passa por uma jornada (específico do produto)
- Repositório de Perfis: o repositório da Adobe Experience Platform que armazena dados de perfil do cliente em tempo real, distintos do Data Lake (específico do produto)
- Namespace de identidade: um rótulo que distingue contextos de identidade (por exemplo, email, ID de CRM) usados para corresponder ao perfil que está sendo atualizado (específico do produto)
- Conjunto de dados habilitado para perfil: um conjunto de dados Adobe Experience Platform configurado para contribuir com registros para o perfil unificado (específico do produto)
Medidas de Proteção:
- A ação Atualizar Perfil só pode ser usada em jornadas que tenham um namespace definido.
- A ação atualiza apenas campos XDM existentes; não é possível criar novos campos de perfil.
- Somente tipos de campos simples são suportados (string, número, booleano); enumerações, arrays de objetos e coleções complexas não são suportados.
- A ação não pode gerar eventos de experiência como compras.
- Até cinco pares de campo/valor podem ser atualizados em uma única ação Atualizar perfil.
- Não compartilhe o conjunto de dados dedicado com processos de assimilação em lote ou por transmissão, pois outras execuções de assimilação substituirão as alterações no Perfil de atualização.
- As atualizações de perfil podem não estar imediatamente disponíveis downstream na mesma execução da jornada.
- A atividade atualiza somente o Repositório de perfis, não o Data Lake.
Terminologia:
- Nome canônico: Atualizar Perfil — Acrônimo: none — variantes: Atualizar atividade do perfil, Atualizar ação do perfil
- Sinônimos: “Loja de perfis” = “Loja de perfis do cliente em tempo real”
- Não confunda: “Armazenamento de perfis” (atualizado por esta atividade) ≠ “Data Lake” (não atualizado por esta atividade)
Perguntas frequentes:
- P: A atividade Atualizar Perfil pode criar novos campos de perfil? — Não, ele só pode atualizar campos que já existem no esquema de perfil XDM selecionado.
- P: Por que devo usar um conjunto de dados dedicado para ações de Atualização de Perfil? — Compartilhar o conjunto de dados com assimilação em lote ou por transmissão pode fazer com que outras execuções de assimilação substituam as alterações feitas pela atividade Atualizar perfil.
- P: As atualizações de perfil estão imediatamente visíveis para atividades downstream na mesma jornada? — Não, os valores atualizados podem não ser refletidos ainda se uma ação ler o mesmo campo imediatamente após a atividade Atualizar perfil grava-o.
- P: Quantos campos posso atualizar em uma única ação Atualizar Perfil? — Até cinco pares de campo/valor podem ser configurados em uma única atividade usando o botão “Atualizar outro campo”.
- P: As atualizações de perfil se aplicam ao modo de teste? — Sim, no modo de teste, as atualizações entram em vigor imediatamente no perfil de teste e não são simuladas.