In questa pagina: scopri come utilizzare l’editor di personalizzazione per aggiungere, personalizzare e convalidare espressioni di personalizzazione da origini quali attributi di profilo, tipi di pubblico, decisioni sulle offerte e attributi contestuali.
L’editor di personalizzazione è il fulcro della personalizzazione in Journey Optimizer. È disponibile in ogni contesto in cui è necessario definire la personalizzazione, ad esempio e-mail, push e offerte.
Nell’interfaccia dell’editor di personalizzazione puoi selezionare, disporre, personalizzare e convalidare tutti i dati per creare una personalizzazione personalizzata per il contenuto.
Dove posso aggiungere la personalizzazione where
Puoi aggiungere la personalizzazione in Journey Optimizer in ogni campo con l’icona
Nei messaggi, la personalizzazione può essere aggiunta in posizioni diverse nei messaggi, ad esempio il campo Oggetto.
Può essere aggiunto anche in altre sezioni del contenuto. Ad esempio, per notifiche push, è possibile aggiungere la personalizzazione nei campi Titolo, Corpo, Audio personalizzato, Badge e Dati personalizzati.
Durante la modifica del contenuto delle e-mail in E-mail Designer, puoi aggiungere la personalizzazione nella maggior parte degli elementi di testo utilizzando l’icona nella barra degli strumenti contestuale.
Journey Optimizer consente inoltre di personalizzare URL nei messaggi. Gli URL personalizzati indirizzano i destinatari verso pagine specifiche di un sito web o verso un microsito personalizzato, a seconda degli attributi del profilo. Ulteriori informazioni
| note |
|---|
| NOTE |
| La personalizzazione URL è disponibile per i seguenti tipi di collegamenti: Collegamento esterno, Collegamento per l'annullamento dell'abbonamento e Rinuncia. |
Origini Personalization sources
Il riquadro di navigazione consente di selezionare l’origine per la personalizzazione. Le origini disponibili sono:
- Attributi profilo : elenca tutti i riferimenti associati allo schema profilo descritto nella documentazione di Adobe Experience Platform Data Model (XDM).
- Attributi di destinazione: questa cartella è specifica per le campagne orchestrate. Contiene attributi calcolati direttamente nell’area di lavoro della campagna. Scopri come aggiungere la personalizzazione nelle campagne orchestrate
- Tipi di pubblico: elenca tutti i tipi di pubblico creati nel servizio di segmentazione di Adobe Experience Platform. Ulteriori informazioni sono disponibili nella documentazione sulla segmentazione di Adobe Experience Platform.
- Decisioni di offerta : elenca tutte le offerte associate a un posizionamento specifico. Seleziona il posizionamento e inserisci le offerte nel contenuto. Per una documentazione completa su come gestire le offerte, consulta questa sezione.
- Attributi contestuali: quando un’attività di azione canale (e-mail, push, SMS) viene utilizzata in un percorso o in una campagna, gli attributi contestuali relativi a eventi e proprietà sono disponibili per la personalizzazione. Un esempio di personalizzazione che sfrutta gli attributi contestuali è presentato in questa sezione. Inoltre, le risposte alle azioni personalizzate possono essere utilizzate per la personalizzazione. Scopri come utilizzare le risposte alle azioni personalizzate nei canali nativi.
Aggiungere personalizzazione add
Nell’area di lavoro centrale puoi creare la sintassi di personalizzazione. Per utilizzare un attributo per personalizzare il messaggio, individuarlo nel riquadro di spostamento a sinistra e fare clic sul pulsante + per aggiungerlo all’espressione.
Il menu con i puntini di sospensione accanto all’icona + consente di ottenere ulteriori dettagli per ciascun attributo e di aggiungere gli attributi utilizzati più di frequente ai preferiti. Gli attributi aggiunti ai preferiti sono accessibili dal menu Preferiti nel riquadro di spostamento.
Inoltre, puoi definire il testo di fallback predefinito che verrà visualizzato se un attributo di profilo di tipo stringa è vuoto. A tale scopo, fare clic sul pulsante con i puntini di sospensione accanto all’attributo e selezionare Inserisci con testo di fallback. Scrivere il testo da visualizzare per impostazione predefinita se il valore dell’attributo è vuoto per un profilo, quindi fare clic su Aggiungi.
Nell’esempio seguente, l’editor di personalizzazione ti consente di selezionare i profili che hanno il compleanno oggi e quindi di completare la personalizzazione inserendo un’offerta specifica corrispondente a quel giorno.
Opzioni per la modifica delle espressioni options
L’area di lavoro centrale fornisce vari strumenti per aiutarti a scrivere la tua espressione di personalizzazione.
Le opzioni disponibili sono:
-
Trova / Trova e sostituisci: cerca nell’espressione e sostituisci automaticamente parti di codice.
-
Annulla / Ripristina: annulla/ripristina l’ultima operazione.
-
Completamento automatico: suggerisce e completa automaticamente il codice durante la digitazione. Questa funzione è disponibile solo per i formati HTML e Testo e supporta gli attributi di Profilo e Contesto. Se viene disabilitata tramite l’apposito pulsante di attivazione, il completamento automatico del codice HTML nativo verrà eseguito dall’editor.
-
HTML / JSON / Testo: identifica il formato del codice. Questo consente al sistema di adattare la convalida e la funzione di completamento automatico in base alla lingua selezionata.
-
Convalida: verifica la sintassi dell’espressione. Ulteriori informazioni in questa sezione.
-
Salva come frammento: salva l’espressione come frammento di espressione. Ulteriori informazioni
-
Dimensione font: regola la dimensione font per i contenuti all’interno dell’editor per migliorarne la leggibilità.
-
Parola a capo: attiva o disattiva il ritorno a capo automatico, consentendo la visualizzazione di espressioni lunghe su una singola riga o racchiuse nell’editor. Le opzioni includono:
- Disattivato (impostazione predefinita) - Nessun ritorno a capo automatico. Le linee lunghe si estendono oltre la vista dell’editor e richiedono uno scorrimento orizzontale.
- Il - Dispone le righe alla larghezza dell’editor.
- Colonna a capo automatico - Dispone le righe quando i caratteri di una riga raggiungono gli 80 caratteri.
- Limitato - Dispone le righe alla larghezza dell’editor o a 80 caratteri, a seconda di quale dei due valori è più basso.
-
Pillole: visualizza gli attributi come “pillole” compatte per migliorare la leggibilità nascondendo i percorsi degli attributi lunghi. Fare clic su un attributo per visualizzarne il percorso completo.
note NOTE Questa opzione è disponibile solo per gli attributi di profilo, gli attributi contestuali e gli elementi multimediali dinamici.
Nel riquadro di navigazione sono disponibili funzioni aggiuntive per aiutarti a creare la tua espressione di personalizzazione.
-
Funzioni helper - Le funzioni helper consentono di eseguire operazioni sui dati, ad esempio calcoli, formattazione o conversioni di dati, condizioni e di manipolarli nel contesto della personalizzazione. Ulteriori informazioni sulle funzioni helper disponibili
-
Preferiti - Gli attributi aggiunti ai preferiti vengono visualizzati in questo elenco. Questo consente di accedere rapidamente agli elementi utilizzati con maggiore frequenza. Per aggiungere un attributo ai preferiti, fai clic sul menu con i puntini di sospensione e scegli Aggiungi ai preferiti.
-
Condizioni - Sfrutta le regole condizionali create nella libreria per aggiungere contenuto dinamico ai messaggi. Questo consente di creare più varianti del messaggio in base alle condizioni. Scopri come creare contenuti dinamici
-
Frammenti - Sfrutta i frammenti di espressione creati o salvati nella sandbox corrente. Un frammento è un componente riutilizzabile a cui è possibile fare riferimento in Journey Optimizer campagne e percorsi. Questa funzionalità consente di precreare più blocchi di contenuto personalizzati che possono essere utilizzati dagli utenti di marketing per assemblare rapidamente i contenuti in un processo di progettazione migliorato. Scopri come utilizzare i frammenti di espressione per la personalizzazione
Una volta che l’espressione di personalizzazione è pronta, devi farla convalidare dall’editor di personalizzazione. Ulteriori informazioni in questa sezione.
Meccanismi di convalida validation-mechanisms
La convalida dell’espressione viene eseguita automaticamente quando si fa clic sul pulsante Aggiungi per chiudere la finestra dell’editor. Puoi anche usare il pulsante Convalida per controllare la sintassi di personalizzazione.
Espandi la sezione seguente per visualizzare gli errori più comuni che possono verificarsi durante la convalida della personalizzazione.
- Percorso “XYZ” non trovato
Quando tenti di fare riferimento a un campo non definito nello schema.
In questo caso firstName1 non è definito come attributo nello schema del profilo:
| code language-none |
|---|
|
- Tipo non corrispondente per la variabile “XYZ”. Previsto array. Trovata stringa.
Quando si tenta di eseguire l’iterazione su una stringa anziché su un array.
In questo caso product non è un array:
| code language-none |
|---|
|
- Sintassi Handlebars non valida. Trovato
'[XYZ}}'
Se viene utilizzata una sintassi Handlebars non valida.
Le espressioni Handlebars sono circondate da {{expression}}
| code language-none |
|---|
|
- Definizione segmento non valida
| code language-none |
|---|
|
Per le offerte, possono verificarsi errori specifici. Per ulteriori informazioni, espandi la sezione seguente:
Gli errori relativi all’integrazione delle offerte in un messaggio e-mail o push hanno il seguente pattern:
| code language-none |
|---|
|
La convalida viene eseguita durante la convalida del contenuto di personalizzazione nell’editor di personalizzazione.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
|---|---|
| Titolo errore | Convalida/risoluzione |
| Risorsa con ID placementID e tipo OfferPlacement non trovata Risorsa con ID activityID e tipo OfferActivity non trovata |
Controlla se ActivityID e/o PlacementID sono disponibili |
| Impossibile convalidare la risorsa. | Il componentType nel posizionamento deve corrispondere all’offerta offerType |
| L’URL pubblico non è presente in offerId. | Le offerte di immagini (tutte le offerte personalizzate e di fallback associate alla coppia decisione-posizionamento) devono avere un URL pubblico popolato (deliveryURL non deve essere vuoto). |
| La decisione contiene attributi non di profilo. | Offerte L’utilizzo del modello deve contenere solo gli attributi del profilo. |
| Si è verificato un errore durante il recupero dell’utilizzo della decisione. | Questo errore può verificarsi quando l’API tenta di recuperare il modello di offerta. |
| Attributo offerta attributo offerta non valido. | Verifica se l’attributo dell’offerta a cui si fa riferimento nel pacchetto di offerta è valido. Di seguito sono riportati gli attributi validi: Immagine: deliveryURL, linkURL Testo: contenuto HTML: content |
Riferimento rapido quick-reference
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
Questa pagina spiega come utilizzare l’editor di personalizzazione di Journey Optimizer per selezionare, generare, personalizzare e convalidare le espressioni di personalizzazione da origini quali attributi di profilo, tipi di pubblico, decisioni sulle offerte e attributi contestuali.
Intenti
- Scopri dove è possibile aggiungere la personalizzazione in Journey Optimizer (messaggi, e-mail Designer, URL, configurazione e-mail, offerte)
- Seleziona l’origine di personalizzazione appropriata per un’espressione
- Aggiungere attributi ed espressioni di build nell’area di lavoro dell’editor
- Utilizza gli strumenti dell’editor: Trova/Sostituisci, Completamento automatico, Convalida, Pillole, Salva come frammento
- Utilizza le funzioni del riquadro di navigazione: Funzioni helper, Preferiti, Condizioni, Frammenti
- Convalidare espressioni e risolvere errori comuni
- Editor Personalization: lo strumento dell’interfaccia utente centrale di Journey Optimizer per la creazione, la personalizzazione e la convalida delle espressioni di personalizzazione, disponibile ovunque sia possibile definire la personalizzazione. (specifico per prodotto)
- Origini Personalization: le categorie di dati disponibili per la creazione di espressioni: attributi di profilo, attributi di destinazione, tipi di pubblico, decisioni di offerta e attributi contestuali.
- Attributi contestuali: dati specifici del Percorso o della campagna (eventi, proprietà, risposte ad azioni personalizzate) disponibili per la personalizzazione solo quando un’azione del canale viene utilizzata in un percorso o in una campagna. (specifico per prodotto)
- Pillole: modalità di visualizzazione dell’editor di personalizzazione che rende i percorsi di attributi lunghi come token compatti e cliccabili per migliorarne la leggibilità. Disponibile solo per attributi di profilo, attributi contestuali e elementi multimediali dinamici. (specifico per prodotto)
- Completamento automatico: funzionalità dell’editor che suggerisce e completa automaticamente il codice durante la digitazione. Disponibile solo per i formati HTML e Text, supporta solo gli attributi Profile e Context. (specifico per prodotto)
- Frammento di espressione: componente di espressione di personalizzazione riutilizzabile a cui è possibile fare riferimento in più campagne e percorsi. (specifico per prodotto)
- Testo di fallback: stringa predefinita visualizzata quando un attributo di profilo di tipo stringa è vuoto per un determinato profilo; configurato per attributo tramite “Inserisci con testo di fallback”.
- Nome canonico: editor di personalizzazione
- Non confondere: l’editor di Personalization (utilizzato per creare espressioni di contenuto nei messaggi, nelle e-mail, nelle notifiche push e nelle offerte; supporta sia Handlebars che la sintassi PQL) ≠ l’editor di espressioni avanzate (utilizzato nel percorso per condizioni sulle origini dati e informazioni sugli eventi, attività di attesa personalizzate e mappatura dei parametri delle azioni) fornisce funzioni e operatori incorporati che differiscono da quelli dell’editor di personalizzazione
- Non confondere: Attributi di profilo (basati su schema XDM, disponibili in tutti i contesti) ≠ Attributi contestuali (specifici del percorso/della campagna, disponibili solo in tale contesto) ≠ Attributi di destinazione (solo per campagne orchestrate)
- Non confondere: Completamento automatico per HTML/Text (suggerisce il completamento degli attributi di personalizzazione) ≠ completamento automatico del codice nativo di HTML (impostazione predefinita dell’editor quando l’opzione è disabilitata)
- Il completamento automatico è disponibile solo per i formati HTML e Text; supporta solo gli attributi Profile e Context.
- La modalità di visualizzazione delle pillole è disponibile solo per gli attributi di profilo, gli attributi contestuali e gli elementi multimediali dinamici.
- La personalizzazione URL è disponibile solo per i tipi di collegamento External, Unsubscription link e Opt-out.
- Per impostazione predefinita, il riquadro degli attributi mostra solo gli attributi popolati; disattiva “Mostra solo attributi popolati” per visualizzare tutti gli attributi dello schema.
- L’utilizzo del modello di offerte deve contenere solo attributi di profilo; gli attributi non di profilo in una decisione causano un errore di convalida.
Q: dove è possibile aggiungere la personalizzazione in Journey Optimizer?
In qualsiasi campo con l’icona Aggiungi personalizzazione, inclusa la riga dell’oggetto e-mail, i campi di notifica push (Titolo, Corpo, Audio personalizzato, Badge, Dati personalizzati), gli elementi di testo E-mail Designer, gli URL (Collegamento esterno, Collegamento di annullamento dell’abbonamento, Rinuncia), i sottodomini/intestazioni/parametri di tracciamento URL della configurazione e-mail e le rappresentazioni di tipo testo dell’offerta.
D: Quali sono le origini di personalizzazione disponibili?
Attributi del profilo, attributi di Target (solo campagne orchestrate), tipi di pubblico, decisioni di offerta e attributi contestuali (eventi di percorso/campagna e risposte alle azioni personalizzate).
Q: Come viene convalidata un’espressione?
La convalida viene eseguita automaticamente quando si fa clic su Aggiungi per chiudere l’editor. Puoi anche attivarla manualmente con il pulsante Convalida. Gli errori più comuni includono: percorso non trovato (campo non incluso nello schema), tipo non corrispondente (iterazione di una stringa come array), sintassi Handlebars non valida e definizione di segmento non valida.
D: cosa fa l’opzione Pillole?
I lunghi percorsi di attributi vengono riprodotti come token compatti e cliccabili per una migliore leggibilità nell’editor. Disponibile solo per attributi di profilo, attributi contestuali e elementi multimediali dinamici.
D: perché nel riquadro degli attributi sono presenti solo alcuni attributi?
Per impostazione predefinita, il riquadro mostra solo gli attributi compilati. Seleziona l’icona delle impostazioni sopra il campo di ricerca e disattiva “Mostra solo attributi popolati” per visualizzare tutti gli attributi dello schema.