Sintassi di personalizzazione

Ultimo aggiornamento: 2023-08-17
  • Argomenti:
  • Personalization
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Intermediate
    Developer

Personalizzazione in Journey Optimizer si basa sulla sintassi del modello Handlebars.
Per una descrizione completa della sintassi Handlebars, fare riferimento a Documentazione di 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

Gli identificatori possono essere qualsiasi carattere Unicode ad eccezione dei seguenti:

Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~

La sintassi fa distinzione tra maiuscole e minuscole.

Le parole true, false, nulle e non definito sono consentiti solo nella prima parte di un'espressione di percorso.

In Handlebars, i valori restituiti da {{expression}} sono con escape HTML. Se l’espressione contiene &, quindi l’output con escape HTML restituito viene generato come &amp;. 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 dei modelli non supporta una singola barra rovesciata senza escape (\). Questo carattere deve essere preceduta da una barra rovesciata (\). Esempio :

{%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}

Profilo

Questo spazio dei nomi ti consente di fare riferimento a tutti gli attributi definiti nello schema del profilo descritto in Documentazione di Adobe Experience Platform Data Model (XDM).

Gli attributi devono essere definiti nello schema prima di essere referenziati in un Journey Optimizer blocco di personalizzazione.

NOTA

Scopri come sfruttare gli attributi di profilo nelle condizioni in questa sezione.

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

Scopri come sfruttare gli attributi di profilo nelle condizioni in questa sezione.

NOTA

Per ulteriori informazioni sul servizio di segmentazione, consulta questa documentazione.

Offerte

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’offerta
  • Type determina il tipo di rappresentazione dell’offerta. I valori possibili sono: image, html e text
  • Placement Id e Activity Id sono identificatori di posizionamento e di 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

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 che presentano un’apertura di blocco ({{# }}) and closing ({{/}}).

NOTA

Le funzioni helper sono descritte in questa sezione.

Tipi letterali

Adobe Journey Optimizer supporta i seguenti tipi letterali:

Letterale Definizione
Stringa Tipo di dati costituito da caratteri racchiusi tra virgolette doppie.
Esempi: "prospect", "jobs", "articles"
Booleano Tipo di dati true o false.
Intero Tipo di dati che rappresenta un numero intero. Può essere positivo, negativo o zero.
Esempi: -201, 0, 412
Array Tipo di dati composto da un gruppo di altri valori letterali. Utilizza parentesi quadre per raggruppare e virgole per delimitare tra valori diversi.
Nota: Non è possibile accedere direttamente alle proprietà degli elementi all’interno di un array.
Esempi: [1, 4, 7], ["US", "FR"]
ATTENZIONE

L'uso di xEvent variabile non disponibile nelle espressioni di personalizzazione. Qualsiasi riferimento a xEvent provocherà errori di convalida.

Personalizzazione URL

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:

  1. Crea un collegamento nel contenuto del messaggio. Ulteriori informazioni

  2. Dall’icona di personalizzazione, seleziona gli attributi. L’icona di personalizzazione è disponibile solo per i seguenti tipi di collegamenti: Collegamento esterno, Collegamento per annullare l’iscrizione e Rinuncia.

NOTA

Nell’editor espressioni, quando modifichi un URL personalizzato, le funzioni di assistenza e l’iscrizione ai tipi di pubblico vengono disabilitate per motivi di sicurezza.

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}}
ATTENZIONE

Gli spazi non sono supportati nei token di personalizzazione utilizzati negli URL.

In questa pagina