Personalización en Journey Optimizer se basa en la sintaxis de plantilla denominada Handlebars.
Para obtener una descripción completa de la sintaxis de Handlebars, consulte Documentación de HandlebarsJS.
Utiliza una plantilla y un objeto de entrada para generar un HTML u otros formatos de texto. Las plantillas de Handlebars tienen el aspecto de texto normal con expresiones de Handlebars incrustadas.
Ejemplo de expresión simple:
{{profile.person.name}}
donde:
profile
es un área de nombres.person.name
es un token compuesto por atributos. La estructura de atributos se define en un esquema Adobe Experience Platform XDM. Más información.Los identificadores pueden ser cualquier carácter Unicode excepto los siguientes:
Whitespace ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~
La sintaxis distingue entre mayúsculas y minúsculas.
Las palabras true, false, null y undefined solo se permiten en la primera parte de una expresión de ruta.
En Handlebars, los valores devueltos por la variable {{expression}} are HTML escapado. Si la expresión contiene &
, la salida de escape del HTML que se devuelve se genera como &
. Si no desea que Handlebars escape un valor, utilice el "triple stash".
En cuanto a los argumentos de funciones literales, el analizador de lenguajes de plantilla no admite una sola barra invertida sin escape (\
). Se debe escapar este carácter con una barra invertida adicional (\
). Por ejemplo :
{%= regexGroup("abc@xyz.com","@(\\w+)", 1)%}
Este espacio de nombres le permite hacer referencia a todos los atributos definidos en el esquema de perfil descrito en Documentación del Modelo de datos de Adobe Experience Platform (XDM).
Los atributos deben definirse en el esquema antes de hacer referencia a ellos en un Journey Optimizer bloque personalizado.
Aprenda a aprovechar los atributos de perfil en condiciones de esta sección.
Referencias de muestra:
{{profile.person.name.fullName}}
{{profile.person.name.firstName}}
{{profile.person.gender}}
{{profile.personalEmail.address}}
{{profile.mobilePhone.number}}
{{profile.homeAddress.city}}
{{profile.faxPhone.number}}
Aprenda a aprovechar los atributos de perfil en condiciones de esta sección.
Para obtener más información sobre segmentación y servicio de segmentación, consulte esta sección.
Este espacio de nombres le permite hacer referencia a las decisiones de ofertas existentes.
Para hacer referencia a una oferta, debe declarar una ruta con la información diferente que define una oferta.
Esta ruta tiene la siguiente estructura:
offers.Type.[Placement Id].[Activity Id].Attribute
donde:
offers
identifica la expresión de ruta que pertenece al espacio de nombres de la ofertaType
determina el tipo de representación de la oferta. Los valores posibles son: image
, html
y text
Placement Id
y Activity Id
son identificadores de ubicación y actividadAttributes
son atributos específicos de oferta que dependen del tipo de oferta. Ejemplo: deliveryUrl
para imágenesPara obtener más información sobre la API de decisiones y sobre la representación de ofertas, consulte esta página
Todas las referencias se validan con el esquema de ofertas con un mecanismo de validación descrito en esta página
Referencias de muestra:
Ubicación en la que se aloja la imagen:
offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].deliveryUrl
Dirección URL de destino cuando haga clic en la imagen:
offers.image.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].linkUrl
Contenido de texto de la oferta procedente del motor de toma de decisiones:
offers.text.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content
contenido del HTML de la oferta procedente del motor de toma de decisiones:
offers.html.[offers:xcore:offer-placement:126f767d74b0da80].[xcore:offer-activity:125e2c6889798fd9].content
Un asistente de Handlebars es un identificador simple que puede ir seguido de parámetros.
Cada parámetro es una expresión Handlebars. Se puede acceder a estos asistentes desde cualquier contexto en una plantilla.
Estos ayudantes de bloque se identifican con un # que precede al nombre del ayudante y requieren un / de cierre coincidente, del mismo nombre.
Los bloques son expresiones que tienen una apertura de bloque ({{# }}) and closing ({{/}}).
Las funciones de ayuda se detallan en esta sección.
Adobe Journey Optimizer admite los siguientes tipos de literales:
Literal | Definición |
---|---|
Cadena | Tipo de datos compuesto por caracteres entre comillas dobles. Ejemplos: "prospect" , "jobs" , "articles" |
Booleano | Tipo de datos verdadero o falso. |
Número entero | Un tipo de datos que representa un número entero. Puede ser positivo, negativo o cero. Ejemplos: -201 , 0 , 412 |
Matriz | Tipo de datos que se compone como grupo de otros valores literales. Utiliza corchetes para agrupar y comas para delimitar entre valores diferentes. Nota: No se puede acceder directamente a las propiedades de los elementos de una matriz. Ejemplos: [1, 4, 7] , ["US", "FR"] |
El uso de xEvent no está disponible en expresiones de personalización. Cualquier referencia a xEvent producirá errores de validación.
Las direcciones URL personalizadas llevan a los destinatarios a páginas específicas de un sitio web o a un micrositio personalizado, según los atributos del perfil. En Adobe Journey Optimizer, puede añadir personalización a las direcciones URL en el contenido del mensaje. La personalización de URL se puede aplicar a texto e imágenes, y puede utilizar datos de perfil o datos contextuales.
Journey Optimizer le permite personalizar una o varias direcciones URL en el mensaje al agregarles campos de personalización. Para personalizar una dirección URL, siga los pasos a continuación:
En el editor de expresiones, al editar una URL personalizada, las funciones de ayuda y la pertenencia a segmentos se desactivan por motivos de seguridad.
URL personalizadas de ejemplo
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}}
Los espacios no se admiten en los tokens de personalización utilizados dentro de las direcciones url.