Aggiungere personalizzazione build-personalization-expressions
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
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.
Quando modifichi il contenuto delle e-mail in E-mail Designer, puoi aggiungere la personalizzazione in blocchi di testo e in URL utilizzando l'icona nella barra degli strumenti contestuale.
Journey Optimizer ti consente inoltre di personalizzare URL nel messaggio. Gli URL personalizzati indirizzano i destinatari verso pagine specifiche di un sito web o verso un microsito personalizzato, a seconda degli attributi del profilo. La personalizzazione URL è disponibile per i seguenti tipi di collegamenti: Collegamento esterno, Collegamento per l'annullamento dell'abbonamento e Rinuncia.
URL personalizzati di esempio:
https://www.adobe.com/users/{{profile.person.name.lastName}}https://www.adobe.com/users?uid={{profile.person.name.firstName}}https://www.adobe.com/usera?uid={{context.journey.technicalProperties.journeyUID}}https://www.adobe.com/users?uid={{profile.person.crmid}}&token={{context.token}}
| note note |
|---|
| NOTE |
| Quando modifichi un URL personalizzato nell’editor di personalizzazione, le funzioni di assistenza e l’iscrizione a un pubblico vengono disabilitate per motivi di sicurezza. |
| Gli spazi non sono supportati nei token di personalizzazione utilizzati negli URL. |
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).
- Tipi di pubblico: elenca tutti i tipi di pubblico creati nel servizio di segmentazione di Adobe Experience Platform. Ulteriori informazioni sulla segmentazione sono disponibili qui.
- 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.
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 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.
Strumenti per la modifica delle espressioni
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 Profilo e Contesto. Se è disattivato tramite l’interruttore, l’editor fornisce il completamento automatico del codice nativo di HTML.
-
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.
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: content HTML: content |