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.
Questa sezione contiene informazioni strutturate che supportano l’interpretazione, il recupero e la risposta alle domande relative a questo argomento.
Per una comprensione completa, queste informazioni devono essere unite alla documentazione su questa pagina. Nessuna delle due origini è progettata per essere indipendente; la pagina descrive la funzione, mentre questa sezione fornisce un contesto aggiuntivo che aiuta a non ambiguare la terminologia, le finalità, l’applicabilità e i vincoli.
- TL;DR: In questa pagina viene illustrato come configurare l’attività Aggiorna profilo per arricchire o correggere un profilo Adobe Experience Platform esistente con dati provenienti da eventi di percorso, origini dati o valori statici durante l’avanzamento di un cliente in un percorso.
Intenti:
- Configurare l’attività Update Profile per modificare gli attributi di profilo esistenti durante un percorso
- Seleziona un set di dati abilitato per il profilo dedicato alle azioni Aggiorna profilo
- Mappa i valori dei campi da eventi di percorso, origini dati o valori statici agli attributi del profilo
- Aggiornare più attributi di profilo (fino a cinque) in una singola attività
- Aggiornamenti del profilo di test in modalità di test percorso
Glossario:
- Aggiorna attività profilo: attività di azione che scrive nuovi valori in campi esistenti in un profilo Adobe Experience Platform in tempo reale mentre un profilo si sposta attraverso un percorso (specifico per prodotto)
- Archivio profili: l’archivio Adobe Experience Platform che contiene i dati del profilo cliente in tempo reale, distinto dal Data Lake (specifico per prodotto)
- Spazio dei nomi identità: etichetta che distingue i contesti di identità (ad esempio e-mail, ID CRM) utilizzati per far corrispondere il profilo da aggiornare (specifico per prodotto)
- Set di dati abilitato per il profilo: un set di dati Adobe Experience Platform configurato per contribuire con record al profilo unificato (specifico per prodotto)
Guardrail:
- L’azione Aggiorna profilo può essere utilizzata solo nei percorsi in cui è definito uno spazio dei nomi.
- L’azione aggiorna solo i campi XDM esistenti; non può creare nuovi campi di profilo.
- Sono supportati solo i tipi di campo semplici (stringa, numero, booleano); non sono supportate enumerazioni, array di oggetti e raccolte complesse.
- L’azione non può generare eventi di esperienza come acquisti.
- È possibile aggiornare fino a cinque coppie campo/valore in una singola azione Aggiorna profilo.
- Non condividere il set di dati dedicato con i processi di acquisizione in batch o in streaming, in quanto altre esecuzioni di acquisizione sovrascriveranno le modifiche apportate al profilo di aggiornamento.
- Gli aggiornamenti del profilo potrebbero non essere immediatamente disponibili a valle nell’esecuzione dello stesso percorso.
- L’attività aggiorna solo l’archivio profili, non il Data Lake.
Terminologia:
- Nome canonico: Aggiorna profilo — Acronimo: none — Varianti: Aggiorna attività profilo, Azione Aggiorna profilo
- Sinonimi: “Profile Store” = “Real-Time Customer Profile store”
- Non confondere: “Archivio profili” (aggiornato da questa attività) ≠ “Data Lake” (non aggiornato da questa attività)
Domande frequenti:
- Q: l’attività Aggiorna profilo può creare nuovi campi del profilo? — No, può solo aggiornare campi che esistono già nello schema profilo XDM selezionato.
- Q: perché dovrei usare un set di dati dedicato per le azioni Aggiorna profilo? — la condivisione del set di dati con l’acquisizione in batch o in streaming può causare la sovrascrittura delle modifiche apportate dall’attività Aggiorna profilo da parte di altre esecuzioni di acquisizione.
- Q: gli aggiornamenti dei profili sono immediatamente visibili alle attività a valle nello stesso percorso? — No, i valori aggiornati potrebbero non essere ancora riflessi se un’azione legge lo stesso campo immediatamente dopo che è stato scritto dall’attività Aggiorna profilo.
- D: quanti campi posso aggiornare in una singola azione Aggiorna profilo? — È possibile configurare fino a cinque coppie campo/valore in una singola attività utilizzando il pulsante “Aggiorna un altro campo”.
- Q: gli aggiornamenti dei profili vengono applicati in modalità di test? — Sì, in modalità di test gli aggiornamenti hanno effetto immediato sul profilo di test e non sono simulati.