Utilizzare l’editor espressioni avanzato about-the-advanced-expression-editor
Utilizza l’editor di espressioni avanzate di Percorso per creare espressioni avanzate in varie schermate dell’interfaccia. Ad esempio, puoi creare espressioni durante la configurazione e l’utilizzo di percorsi e durante la definizione di una condizione di origine dati.
È inoltre disponibile ogni volta che hai bisogno di definire parametri di azione che richiedono specifiche manipolazioni dei dati. Puoi sfruttare i dati provenienti dagli eventi o le informazioni aggiuntive recuperate dall’origine dati. In un percorso, l’elenco visualizzato dei campi dell’evento è contestuale e varia in base agli eventi aggiunti nel percorso.
L’editor di espressioni avanzate offre un set di funzioni e operatori incorporati che consente di manipolare i valori e definire un’espressione adatta alle tue esigenze. L’editor di espressioni avanzate ti consente inoltre di definire i valori del parametro dell’origine dati esterna, di manipolare i campi e le raccolte delle mappe.
Accedere all’editor di espressioni avanzate accessing-the-advanced-expression-editor
L’editor di espressioni avanzate può essere utilizzato per:
- creare condizioni avanzate sulle origini dati e sulle informazioni sull’evento
- definire le attività di attesa personalizzate
- definire la mappatura dei parametri di azione
Se possibile, puoi passare tra le due modalità utilizzando il pulsante Modalità avanzata / Modalità semplice. La modalità semplice è descritta qui.
-
Le condizioni possono essere definite nell’editor di espressioni semplice o avanzato. Restituiscono sempre un tipo booleano.
-
I parametri delle azioni possono essere definiti selezionando i campi o tramite l’editor di espressioni avanzate. I parametri restituiscono un tipo di dati specifico in base alla relativa espressione.
Puoi accedere all’editor di espressioni avanzate con diverse modalità:
-
Quando crei una condizione di origine dati, puoi accedere all’editor avanzato facendo clic su Modalità avanzata.
-
Quando crei un timer personalizzato, l’editor avanzato viene visualizzato direttamente.
-
Quando mappi il parametro dell’azione, fai clic su Modalità avanzata.
Scopri l’interfaccia discovering-the-interface
Questa schermata ti consente di scrivere manualmente l’espressione.
Nella parte sinistra dello schermo sono visualizzati i campi e le funzioni disponibili:
-
Eventi: scegli uno dei campi ricevuti dall’evento in entrata. L’elenco visualizzato dei campi dell’evento è contestuale e varia in base agli eventi aggiunti nel percorso. Ulteriori informazioni
note caution CAUTION La creazione di espressioni utilizzando eventi di esperienza non è supportata. Si fa riferimento ad approcci alternativi e best practice per la creazione di espressioni/logiche con eventi di esperienza qui -
Tipi di pubblico: se hai rimosso un evento Qualificazione del pubblico, scegli il pubblico che desideri utilizzare nell’espressione. Ulteriori informazioni
-
Origini dati: scegli dall’elenco di campi disponibili nei gruppi di campi delle origini dati. Ulteriori informazioni
-
proprietà Percorso: questa sezione raggruppa i campi tecnici relativi al percorso per un determinato profilo. Ulteriori informazioni
-
Funzioni: scegli dall’elenco di funzioni incorporate che consentono di eseguire filtri complessi. Le funzioni sono organizzate per categorie. Ulteriori informazioni
Un meccanismo di completamento automatico visualizza i suggerimenti contestuali.
Un meccanismo di convalida della sintassi verifica l’integrità del tuo codice. Gli errori vengono visualizzati sopra l’editor.
Necessità di parametri per la creazione di condizioni con l’editor di espressioni avanzate
Se selezioni un campo da un’origine dati esterna che richiede la chiamata di un parametro (vedi questa pagina), a destra viene visualizzata una nuova scheda che consente di specificare questo parametro. Il valore del parametro può provenire dagli eventi posizionati nel percorso o nell’origine dati di Experience Platform (e non da altre origini dati esterne). Ad esempio, in un’origine dati correlata al meteo, un parametro utilizzato di frequente sarà “city”. Di conseguenza, devi selezionare il punto in cui vuoi ottenere questo parametro della città. Ai parametri è possibile applicare anche le funzioni, al fine di eseguire modifiche di formato o concatenazioni.
Per casi di utilizzo più complessi, se desideri includere i parametri dell’origine dati nell’espressione principale, puoi definirne i valori utilizzando la parola chiave “params”. Consulta questa pagina.
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 presentato l’editor di espressioni avanzate di Percorso, con i relativi punti di accesso, pannelli di interfaccia e funzionalità per la creazione di condizioni complesse, timer di attesa personalizzati e mappature dei parametri di azione tramite eventi, origini dati, funzioni e operatori.
Intenti:
- Accedere all’editor di espressioni avanzate da una condizione di origine dati, da un’attività di attesa personalizzata o dalla mappatura di parametri di azione
- Creare condizioni booleane avanzate utilizzando campi evento, campi origine dati, appartenenza a un pubblico e proprietà di percorso
- Passa dalla modalità semplice alla modalità avanzata durante la configurazione delle condizioni
- Fare riferimento ai parametri dell’origine dati esterna direttamente all’interno dell’espressione principale utilizzando la parola chiave
params - Utilizza la generazione di espressioni basate sull’intelligenza artificiale per creare espressioni dai prompt del linguaggio naturale
Glossario:
- Editor di espressioni avanzate: editor di codice Journey Optimizer per la scrittura di espressioni complesse; distinto dall’editor di condizioni punto e clic più semplice (specifico per prodotto)
- Modalità semplice: editor di condizioni point-and-click; meno flessibile dell’editor avanzato ma più semplice per non sviluppatori (specifico per prodotto)
- Proprietà Percorso: campi tecnici sull’istanza del percorso (ID, versione, errori, nodo corrente) accessibili nell’editor espressioni (specifico per prodotto)
- Genera espressioni con IA: funzionalità basata su IA (versione beta pubblica) all’interno dell’editor avanzato che genera espressioni dai prompt del linguaggio normale (specifico per prodotto)
Guardrail:
- La creazione diretta di espressioni utilizzando eventi di esperienza non è supportata. Utilizzare approcci alternativi, ad esempio attributi calcolati.
- Le condizioni restituiscono sempre un tipo booleano indipendentemente dalla modalità dell’editor
- Le espressioni non devono contenere caratteri nascosti o non stampabili e devono utilizzare il formato a riga singola per evitare errori di analisi
- I valori dei parametri dell’origine dati esterna possono provenire solo da eventi di percorso o dall’origine dati di Experience Platform, non da altre origini dati esterne
- Le funzioni dell’editor di espressioni avanzate sono diverse da quelle dell’editor di personalizzazione
Terminologia:
- Nome canonico: Editor espressioni avanzate — Acronimo: none — varianti: editor avanzato, editor espressioni
- Sinonimi: “Advanced mode” = “advanced expression editor”
- Non confondere: editor di espressioni avanzate (condizioni/azioni di percorso) ≠ editor di personalizzazione (personalizzazione del contenuto dei messaggi)
Domande frequenti:
- Q: quando devo utilizzare l’editor di espressioni avanzate invece della modalità semplice? — utilizza l’editor avanzato quando devi eseguire query sulle raccolte, utilizzare funzioni, fare riferimento alle proprietà del percorso o creare una logica a più condizioni che l’editor semplice non è in grado di esprimere.
- D: come si passa un parametro a un’origine dati esterna nell’espressione? — Utilizzare la parola chiave
paramsnella sintassi dell’espressione, ad esempio#{DataSource.fieldGroup.field, params: {paramName: value}}. - D: quali sono le funzioni del meccanismo di completamento automatico? — Visualizza suggerimenti di campi contestuali e funzioni durante la digitazione, per velocizzare la creazione di espressioni valide.
- Q: dove si trovano le espressioni Generate con accesso ai dati di intelligenza artificiale? — Tramite il controllo AI all’interno dell’editor di espressioni avanzate; è attualmente in versione beta pubblica.
- D: le condizioni nell’editor avanzato restituiscono un tipo diverso rispetto alla modalità semplice? — No; le condizioni restituiscono sempre un valore booleano in entrambe le modalità.