DocumentazioneJourney OptimizerGuida di Journey Optimizer

Sintassi di personalizzazione personalization-syntax

Last update: Mon Mar 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Intermedio
  • Sviluppatore

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:

    code language-none 
    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 HTML. Se l'espressione contiene &, l'output con escape HTML restituito verrà 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 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)%}

Spazi dei nomi disponibili namespaces

  • 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.

    Per ulteriori informazioni su come sfruttare gli attributi del profilo nelle condizioni, consulta questa sezione.

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

  • Destinatari

    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 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 sulle rappresentazioni di offerte, consulta questa pagina

    Tutti i riferimenti vengono convalidati in base allo schema delle offerte con un meccanismo di convalida descritto in questa pagina

    accordion
    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 un blocco di apertura ({{# }}) e chiusura ({{/}}).

Per ulteriori informazioni sulle funzioni di supporto, fare riferimento a questa sezione.

Tipi letterali literal-types

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"]
CAUTION
L'utilizzo della variabile xEvent non è disponibile nelle espressioni di personalizzazione. Qualsiasi riferimento a xEvent provocherà errori di convalida.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76