Sintassi di personalizzazione personalization-syntax
Personalization in Journey Optimizer si basa sulla sintassi del modello Handlebars.
Per una descrizione completa della sintassi Handlebars, consulta la documentazione HandlebarsJS.
Utilizza un modello e un oggetto di input per generare HTML o altri formati di testo. I modelli Handlebars hanno l’aspetto di un testo normale con espressioni Handlebars incorporate.
Esempio di espressione semplice:
{{profile.person.name}}
dove:
profile
è uno spazio dei nomi.person.name
è un token composto da attributi. La struttura degli attributi è definita in uno schema XDM di Adobe Experience Platform. Ulteriori informazioni.
Regole generali di sintassi general-rules
Gli identificatori possono essere qualsiasi carattere Unicode ad eccezione dei seguenti:
Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~
La sintassi fa distinzione tra maiuscole e minuscole.
Le parole true, false, null e undefined sono consentite solo nella prima parte di un'espressione di percorso.
In Handlebars, i valori restituiti da {{expression}} sono con escape di HTML. Se l'espressione contiene &
, l'output con escape di HTML restituito verrà generato come &
. Se non desideri che Handlebars sfugga a un valore, utilizza il "triplo-stash".
Per quanto riguarda gli argomenti delle funzioni letterali, il parser del linguaggio del modello non supporta una singola barra rovesciata senza escape (\
). Questo carattere deve essere preceduto da una barra rovesciata (\
). Esempio:
{%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}
Profilo
Questo spazio dei nomi consente di fare riferimento a tutti gli attributi definiti nello schema del profilo descritto nella documentazione di Adobe Experience Platform Data Model (XDM).
Gli attributi devono essere definiti nello schema prima di essere referenziati in un blocco di personalizzazione Journey Optimizer.
Riferimenti di esempio:
{{profile.person.name.fullName}}
{{profile.person.name.firstName}}
{{profile.person.gender}}
{{profile.personalEmail.address}}
{{profile.mobilePhone.number}}
{{profile.homeAddress.city}}
{{profile.faxPhone.number}}
Tipi di pubblico perso-segments
Scopri come sfruttare gli attributi del profilo nelle condizioni in questa sezione.
Offerte offers-syntax
Questo spazio dei nomi consente di fare riferimento alle decisioni sulle offerte esistenti.
Per fare riferimento a un’offerta è necessario dichiarare un percorso con le diverse informazioni che definiscono un’offerta.
Questo percorso ha la seguente struttura:
offers.Type.[Placement Id].[Activity Id].Attribute
dove:
offers
identifica l'espressione di percorso appartenente allo spazio dei nomi dell'offertaType
determina il tipo di rappresentazione dell'offerta. I valori possibili sono:image
,html
etext
Placement Id
eActivity Id
sono identificatori di posizionamento e attivitàAttributes
sono attributi specifici dell'offerta che dipendono dal tipo di offerta. Esempio:deliveryUrl
per le immagini
Per ulteriori informazioni sull'API Decisions e su Offers Representation, consulta questa pagina
Tutti i riferimenti vengono convalidati in base allo schema delle offerte con un meccanismo di convalida descritto in questa pagina
Riferimenti di esempio:
-
Posizione in cui è ospitata l’immagine:
offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].deliveryUrl
-
URL di destinazione quando fai clic sull’immagine:
offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].linkUrl
-
Contenuto del testo dell’offerta proveniente dal motore decisionale:
offers.text.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content
-
Contenuto HTML dell’offerta proveniente dal motore decisionale:
offers.html.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content
Helper helpers-all
Un helper Handlebars è un semplice identificatore che può essere seguito da parametri.
Ogni parametro è un'espressione Handlebars. È possibile accedere a questi helper da qualsiasi contesto in un modello.
Questi helper di blocco sono identificati da un # che precede il nome dell'helper e richiedono un / di chiusura corrispondente, con lo stesso nome.
I blocchi sono espressioni con apertura di un blocco ({{# }}) and closing ({{/}}).
Tipi letterali literal-types
Adobe Journey Optimizer supporta i seguenti tipi letterali:
Esempi:
"prospect"
, "jobs"
, "articles"
Esempi:
-201
, 0
, 412
Nota: non è possibile accedere direttamente alle proprietà degli elementi all'interno di un array.
Esempi:
[1, 4, 7]
, ["US", "FR"]
URL PERSONALIZATION perso-urls
Gli URL personalizzati indirizzano i destinatari verso pagine specifiche di un sito web o verso un microsito personalizzato, a seconda degli attributi del profilo. In Adobe Journey Optimizer, puoi aggiungere la personalizzazione agli URL nel contenuto del messaggio. La personalizzazione URL può essere applicata a testo e immagini e utilizzare dati di profilo o dati contestuali.
Journey Optimizer ti consente di personalizzare uno o più URL nel messaggio aggiungendo campi di personalizzazione. Per personalizzare un URL, effettua le seguenti operazioni:
-
Crea un collegamento nel contenuto del messaggio. Ulteriori informazioni
-
Dall’icona di personalizzazione, seleziona gli attributi. L'icona di personalizzazione è disponibile solo per i seguenti tipi di collegamenti: Collegamento esterno, Collegamento annullamento 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}}