In questa pagina: scopri come utilizzare l’attività di azione Aggiorna profilo per arricchire o correggere un profilo Adobe Experience Platform esistente mentre un cliente procede attraverso un percorso.
Utilizzare l’attività di azione Aggiorna profilo per arricchire o correggere un profilo Adobe Experience Platform esistente durante l’avanzamento di un cliente in un percorso. È possibile impostare i valori dei campi originati da un evento di percorso, un’origine dati configurata o un valore statico, consentendo di mantenere accurati e utilizzabili i dati del profilo senza uscire dall’area di lavoro del percorso. Prima di configurare questa attività, controlla le protezioni e limitazioni applicabili.
Selezione set di dati dataset-selection
L’attività Aggiorna profilo richiede un set di dati dedicato per archiviare gli aggiornamenti. Poiché questa attività aggiorna solo l’archivio profili (non Datalake), tutti gli aggiornamenti devono essere salvati in un set di dati abilitato per il profilo specificamente designato per le azioni Aggiorna profilo.
Inoltre, la configurazione dell’attività Aggiorna profilo non richiede uno spazio dei nomi Identity. Di conseguenza, assicurati che il set di dati selezionato utilizzi lo stesso spazio dei nomi identità utilizzato dall’azione che ha avviato il percorso, in quanto questo spazio dei nomi verrà utilizzato da questi aggiornamenti. La mappa delle identità può essere utilizzata anche dal set di dati selezionato. Se non si seleziona un set di dati con lo spazio dei nomi identità corretto o uno che utilizza la mappa delle identità, l’attività Aggiorna profilo non riuscirà.
Configurare l’attività di aggiornamento del profilo use-profile-update
Segui i passaggi seguenti per configurare l’attività Aggiorna profilo nel tuo percorso.
-
Inizia a progettare il percorso. Ulteriori informazioni in Creare il primo percorso.
-
Nella sezione Azione della palette, rilascia l’attività Aggiorna profilo nell’area di lavoro.
-
Seleziona uno schema dall’elenco.
note NOTE Solo i campi già esistenti nello schema di profilo XDM selezionato sono disponibili per la selezione. Se il campo necessario non è elencato, aggiungilo prima allo schema in Adobe Experience Platform. -
Fai clic su Campo per selezionare il campo da aggiornare.
-
Seleziona un set di dati dall’elenco.
note NOTE L'azione Aggiorna profilo aggiorna i dati del profilo in tempo reale, ma non i set di dati. La selezione del set di dati è necessaria in quanto il profilo è un record correlato a un set di dati. -
Fai clic sul campo Valore per definire il valore da utilizzare:
-
Utilizzando l’editor di espressioni semplici, puoi selezionare un campo da un’origine dati o dall’evento in ingresso.
-
Se si desidera definire un valore specifico o sfruttare funzioni avanzate, selezionare Modalità avanzata.
-
-
Per aggiornare attributi di profilo aggiuntivi nella stessa azione, fare clic su Aggiorna un altro campo e ripetere la selezione del campo e del valore. È possibile aggiungere fino a cinque coppie campo/valore in una singola azione Aggiorna profilo. Consulta Guardrail e limitazioni.
L’attività Aggiorna profilo è ora configurata.
Verificare l’aggiornamento del profilo using-the-test-mode
Tieni presente che in modalità di test gli aggiornamenti del profilo hanno effetto immediato sul profilo di test e non sono simulati.
Solo i profili di test possono accedere a un percorso in modalità di test. È possibile creare un nuovo profilo di test o convertire un profilo esistente in un profilo di test. In Adobe Experience Platform, gli attributi del profilo possono essere aggiornati tramite un’importazione di file CSV o chiamate API. Un’alternativa più rapida consiste nell’utilizzare un’attività Aggiorna profilo all’interno del percorso stesso per impostare il campo booleano del profilo di test su true.
Per ulteriori informazioni su come trasformare un profilo esistente in un profilo di test, consulta questa sezione.
Guardrail e limitazioni guardrails
- L’azione Aggiorna profilo può essere utilizzata solo in percorsi con spazio dei nomi.
- L’azione aggiorna solo i campi esistenti, non crea nuovi campi profilo.
- L’azione supporta solo tipi di campo semplici (stringa, numero, booleano). I campi XDM definiti come enumerazioni, valori suggeriti, array di oggetti o raccolte complesse (ad esempio, elenchi di prodotti) non sono supportati.
- Impossibile utilizzare l’azione Aggiorna profilo per generare eventi esperienza, ad esempio un acquisto.
- Come qualsiasi altra azione, puoi definire un percorso alternativo in caso di errore o timeout. Non è possibile eseguire due azioni in parallelo.
- Non è garantito che gli aggiornamenti del profilo siano immediatamente disponibili a valle nello stesso percorso. Evita di inserire un’azione che legga un campo direttamente dopo l’azione Aggiorna profilo che lo scrive, poiché il valore aggiornato potrebbe non essere ancora riflesso.
- L’attività Aggiorna profilo aggiorna solo il archivio profili, non il Data Lake.
- È possibile aggiornare fino a cinque coppie campo/valore in una singola azione Aggiorna profilo. Utilizza il pulsante Aggiorna un altro campo per aggiungere altre coppie.
- Per migliorare le prestazioni, raggruppare più aggiornamenti di attributi in un’unica azione Aggiorna profilo anziché utilizzare una sola azione per attributo.
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.