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.
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 explains how to configure the Update Profile activity to enrich or correct an existing Adobe Experience Platform profile with data from journey events, datasources, or static values as a customer progresses through a journey.
Intents:
- Configure the Update Profile activity to modify existing profile attributes during a journey
- Select a profile-enabled dataset dedicated to Update Profile actions
- Map field values from journey events, datasources, or static values to profile attributes
- Update multiple profile attributes (up to five) in a single activity
- Test profile updates in journey test mode
Glossary:
- Update Profile activity: An action activity that writes new values to existing fields in an Adobe Experience Platform profile in real time as a profile moves through a journey (product-specific)
- Profile Store: The Adobe Experience Platform store that holds real-time customer profile data, distinct from the Data Lake (product-specific)
- Identity namespace: A label that distinguishes identity contexts (e.g., email, CRM ID) used to match the profile being updated (product-specific)
- Profile-enabled dataset: An Adobe Experience Platform dataset configured to contribute records to the unified profile (product-specific)
Guardrails:
- The Update Profile action can only be used in journeys that have a namespace defined.
- The action only updates existing XDM fields; it cannot create new profile fields.
- Only simple field types are supported (string, number, boolean); enumerations, object arrays, and complex collections are not supported.
- The action cannot generate experience events such as purchases.
- Up to five field/value pairs can be updated in a single Update Profile action.
- Do not share the dedicated dataset with batch or streaming ingestion processes, as other ingestion runs will overwrite Update Profile changes.
- Profile updates may not be immediately available downstream in the same journey execution.
- The activity only updates the Profile Store, not the Data Lake.
Terminology:
- Canonical name: Update Profile — Acronym: none — variants: Update Profile activity, Update Profile action
- Synonyms: “Profile Store” = “Real-Time Customer Profile store”
- Do not confuse: “Profile Store” (updated by this activity) ≠ “Data Lake” (not updated by this activity)
FAQ:
- Q: Can the Update Profile activity create new profile fields? — No, it can only update fields that already exist in the selected XDM Profile schema.
- Q: Why should I use a dedicated dataset for Update Profile actions? — Sharing the dataset with batch or streaming ingestion can cause other ingestion runs to overwrite the changes made by the Update Profile activity.
- Q: Are profile updates immediately visible to downstream activities in the same journey? — No, updated values may not yet be reflected if an action reads the same field immediately after the Update Profile activity writes it.
- Q: How many fields can I update in a single Update Profile action? — Up to five field/value pairs can be configured in a single activity using the “Update another field” button.
- Q: Do profile updates apply in test mode? — Yes, in test mode the updates take effect immediately on the test profile and are not simulated.