Adición de personalización build-personalization-expressions

En esta página: Aprenda a utilizar el editor de personalización para agregar, personalizar y validar expresiones de personalización de fuentes como atributos de perfil, audiencias, decisiones de oferta y atributos contextuales.

El editor de personalización es la pieza central de la personalización en Journey Optimizer. Está disponible en todos los contextos en los que necesita definir la personalización, como correos electrónicos, notificaciones push y ofertas.

En la interfaz del editor de personalización, puede seleccionar, organizar, personalizar y validar todos los datos para crear una personalización personalizada para el contenido.

¿Dónde puedo añadir la personalización? where

Puede agregar personalización en Journey Optimizer en todos los campos con el icono agregar personalización . Expanda las secciones siguientes para obtener más detalles.

Mensajes

En los mensajes, la personalización se puede agregar en diferentes ubicaciones de los mensajes, como en el campo Línea de asunto.

También se puede añadir en otras secciones del contenido. Por ejemplo, para notificaciones push, se puede agregar personalización en los campos Título, Cuerpo, Sonido personalizado, Insignias y Datos personalizados.

Diseñador de correo electrónico

Al editar el contenido del correo electrónico en Email Designer, puede añadir personalización en la mayoría de los elementos de texto mediante el icono de la barra de herramientas contextual.

URL

Journey Optimizer también le permite personalizar direcciones URL en sus mensajes. 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. Más información

{width="50%"}

note
NOTE
La personalización de URL está disponible para estos tipos de vínculos: Vínculo externo, Vínculo de baja y Exclusión.
Configuración de correo electrónico
Al crear una configuración de canal de correo electrónico, puede definir valores personalizados para subdominios, encabezados y parámetros de seguimiento de URL. Más información
Ofertas
Puede agregar personalización al usar contenido de tipo texto en las representaciones de ofertas. Aprenda a crear ofertas personalizadas

Fuentes de Personalization sources

El panel de navegación permite seleccionar el origen de la personalización. Los orígenes disponibles son:

NOTE
Si va a segmentar una audiencia con atributos de enriquecimiento generados mediante un flujo de trabajo de composición, puede aprovechar estos atributos de enriquecimiento para personalizar el mensaje. Aprenda a utilizar los atributos de enriquecimiento de audiencias

Adición de personalización add

En el espacio de trabajo central se crea la sintaxis de personalización. Para utilizar un atributo para personalizar el mensaje, localícelo en el panel de navegación izquierdo y haga clic en el botón + para agregarlo a la expresión.

El menú de los tres puntos situado junto al icono + le permite obtener más información sobre cada atributo y agregar a los favoritos los atributos utilizados con más frecuencia. Se puede acceder a los atributos agregados a favoritos desde el menú Favoritos del panel de navegación.

NOTE
De forma predeterminada, el panel Atributos solo muestra los atributos rellenados. Para mostrar todos los atributos, seleccione el botón situado encima del campo de búsqueda y desactive la opción Mostrar solo atributos rellenados.

Además, puede definir el texto de reserva predeterminado que se mostrará si un atributo de perfil de tipo cadena está vacío. Para ello, haga clic en el botón de puntos suspensivos situado junto al atributo y seleccione Insertar con texto de reserva. Escriba el texto que debería mostrarse de forma predeterminada si el valor del atributo está vacío para un perfil y, a continuación, haga clic en Agregar.

En el siguiente ejemplo, el editor de personalización le permite seleccionar los perfiles que tienen su cumpleaños hoy y luego completar la personalización insertando una oferta específica correspondiente a este día.

Opciones para la edición de expresiones options

El espacio de trabajo central proporciona varias herramientas para ayudarle a escribir su expresión de personalización.

Entre las opciones disponibles se encuentran:

  1. Buscar / Buscar y reemplazar: Busca a través de tu expresión y reemplaza automáticamente partes de código.

  2. Deshacer / Rehacer: Deshacer / Rehacer la última operación.

  3. Completar automáticamente: sugiere y completa automáticamente el código mientras escribe. Esta función solo está disponible en los formatos HTML y texto, y admite atributos de perfil y contexto. Si se desactiva mediante el conmutador, el editor proporcionará el autocompletado de código HTML nativo en su lugar.

    {align="center" width="70%" modal="regular"}

  4. HTML / JSON / Text: identifique el formato de su código. Esto permite al sistema adaptar la función de validación y autocompletar en función del idioma seleccionado.

  5. Validar: compruebe la sintaxis de su expresión. Obtenga más información en esta sección.

  6. Guardar como fragmento: guarde la expresión como un fragmento de expresión. Obtenga más información en esta sección

  7. Tamaño de fuente: Ajusta el tamaño de fuente del contenido dentro del editor para mejorar la legibilidad.

  8. Ajuste de palabras: habilita o deshabilita el ajuste de palabras, lo que permite que las expresiones largas se muestren en una sola línea o se ajusten dentro del editor. Las opciones incluyen:

    • Desactivado (Predeterminado) - Sin ajuste de palabras. Las líneas largas se extienden más allá de la vista del editor y requieren un desplazamiento horizontal.
    • Activado: ajusta líneas en la anchura del editor.
    • Columna de ajuste de línea: ajusta las líneas cuando los caracteres de una línea alcanzan los 80 caracteres.
    • Redondeado: ajusta las líneas en la anchura del editor o en 80 caracteres, el valor que sea menor.
  9. Pills: muestra los atributos como “píldoras” compactas para mejorar la legibilidad al ocultar rutas de atributos largas. Haga clic en un atributo para mostrar su ruta completa.

    note
    NOTE
    Esta opción solo está disponible para atributos de perfil, atributos contextuales y medios dinámicos.

En el panel de navegación, hay disponibles funciones adicionales que le ayudarán a crear su expresión de personalización.

  • Funciones de ayuda: las funciones de ayuda le permiten realizar operaciones en los datos, como cálculos, conversiones o formato de datos, condiciones y manipularlos en el contexto de la personalización. Más información sobre las funciones de ayuda disponibles

  • Favoritos: los atributos que agregó a los favoritos se muestran en esta lista. Esto le permite acceder rápidamente a los elementos utilizados con más frecuencia. Para agregar un atributo a tus favoritos, haz clic en el menú de los tres puntos y elige Agregar a favoritos.

  • Condiciones: aproveche las reglas condicionales creadas en la biblioteca para agregar contenido dinámico a los mensajes. Esto le permite crear varias variantes del mensaje en función de las condiciones. Aprenda a crear contenido dinámico

  • Fragmentos: aproveche los fragmentos de expresiones que se han creado o guardado en la zona protegida actual. Un fragmento es un componente reutilizable al que se puede hacer referencia en Journey Optimizer campañas y recorridos. Esta funcionalidad permite generar previamente varios bloques de contenido personalizados que los usuarios de marketing pueden utilizar para ensamblar contenido rápidamente en un proceso de diseño mejorado. Aprenda a utilizar fragmentos de expresiones para la personalización

TIP
¿Busca expresiones listas para usar? La página Fórmulas de Personalization proporciona patrones de copiar y pegar para los casos de uso más comunes: formato de fecha, temporizadores de cuenta atrás, reserva condicional, visualización de solo tiempo y más.

Una vez que la expresión personalizada está lista, el editor de personalización debe validarla. Obtenga más información en esta sección.

Mecanismos de validación validation-mechanisms

La validación de la expresión se ejecuta automáticamente al hacer clic en el botón Agregar para cerrar la ventana del editor. También puede usar el botón Validar para comprobar la sintaxis de personalización.

Expanda la sección siguiente para ver los errores comunes que pueden producirse al validar la personalización.

Errores comunes
  • No se encontró la ruta “XYZ”

Al intentar hacer referencia a un campo que no está definido en el esquema.

En este caso firstName1 no está definido como atributo en el esquema de perfil:

code language-none
{{profile.person.name.firstName1}}
  • No coinciden los tipos para la variable “XYZ”. Matriz esperada. Se encontró la cadena.

Al intentar repetir una cadena en lugar de una matriz.

En este caso product no es una matriz:

code language-none
{{each profile.person.name.firstName as |product|}}
 {{product.productName}}
{{/each}}
  • Sintaxis de handlebars no válida. Se encontró'[XYZ}}'

Cuando se utiliza sintaxis de handlebars no válida.

Las expresiones Handlebars están rodeadas por {{expression}}

code language-none
   {{[profile.person.name.firstName}}
  • Definición de segmento no válida
code language-none
No segment definition found for 988afe9f0-d4ae-42c8-a0be-8d90e66e151

En el caso de las ofertas, pueden producirse errores específicos. Expanda la sección siguiente para obtener más detalles:

Errores específicos relacionados con las ofertas

Los errores relacionados con la integración de ofertas en un mensaje de correo electrónico o push tienen el siguiente patrón:

code language-none
Offer.<offerType>.[PlacementID].[ActivityID].<offer-attribute>

La validación se realiza durante la validación del contenido de personalización en el editor de personalización.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Título del error Validación/resolución
No se ha encontrado el recurso con ID de colocación y tipo OfferPlacement
No se ha encontrado el recurso con ID de actividad y tipo de actividad de oferta
Comprobar si ActivityID o PlacementID están disponibles
No se ha podido validar el recurso. El componentType de Placement debe coincidir con la oferta de offerType
La URL pública no está presente en offerId. Las ofertas de imágenes (todas personalizadas y de reserva asociadas con el par de decisión y ubicación) deben tener rellenada una URL pública (deliveryURL no debe estar vacío).
La decisión contiene atributos que no son de perfil. El uso del modelo de ofertas debe contener solo los atributos de perfil.
Error al recuperar el uso de decisión. Este error se puede producir cuando la API intenta recuperar el modelo de oferta.
Offer Attribute offer-attribute no es válido. Compruebe si el atributo de oferta al que se hace referencia en la colocación de oferta es válido. A continuación se muestran los atributos válidos:
Imagen: deliveryURL, linkURL
Texto: content
HTML: content

Referencia rápida quick-reference

Esta sección contiene conocimientos estructurados destinados a apoyar la interpretación, la recuperación y la respuesta a preguntas relacionadas con este tema.

Para una comprensión completa, esta información debe combinarse con la documentación de esta página. Ninguna de las fuentes pretende ser independiente; la página describe la función, mientras que esta sección proporciona contexto adicional que ayuda a desambiguar la terminología, la intención, la aplicabilidad y las restricciones.

Información general

TL;DR

En esta página se explica cómo utilizar el editor de personalización de Journey Optimizer para seleccionar, generar, personalizar y validar expresiones de personalización de fuentes de datos, incluidos atributos de perfil, audiencias, decisiones de oferta y atributos contextuales.

Intenciones

  • Saber dónde se puede añadir la personalización en Journey Optimizer (mensajes, correo electrónico, Designer, direcciones URL, configuración de correo electrónico, ofertas)
  • Seleccione el origen de personalización adecuado para una expresión
  • Añadir atributos y expresiones de compilación en el espacio de trabajo del editor
  • Usar herramientas del editor: Buscar/Reemplazar, Completar automáticamente, Validar, Pastillas, Guardar como fragmento
  • Usar funciones del panel de navegación: funciones de ayuda, Favoritos, Condiciones, Fragmentos
  • Validar expresiones y resolver errores comunes
Glosario
  • Editor de Personalization: La herramienta de interfaz de usuario central de Journey Optimizer para crear, personalizar y validar expresiones de personalización; disponible siempre que se pueda definir la personalización. (específico del producto)
  • Fuentes de Personalization: Las categorías de datos disponibles para crear expresiones: atributos de perfil, atributos de destino, audiencias, decisiones de oferta y atributos contextuales.
  • Atributos contextuales: los datos específicos de Recorrido o campaña (eventos, propiedades, respuestas de acciones personalizadas) solo están disponibles para su personalización cuando se utiliza una acción de canal en un recorrido o campaña. (específico del producto)
  • Pills: modo de visualización del editor de personalización que procesa las rutas de atributos largas como tokens compactos en los que se puede hacer clic para mejorar la legibilidad. Disponible solo para atributos de perfil, atributos contextuales y medios dinámicos. (específico del producto)
  • Completado automático: característica del editor que sugiere y completa automáticamente el código mientras escribe; disponible sólo para formatos de HTML y texto, sólo admite atributos de perfil y contexto. (específico del producto)
  • Fragmento de expresión: un componente de expresión de personalización reutilizable al que se puede hacer referencia en campañas y recorridos. (específico del producto)
  • Texto de reserva: cadena predeterminada que se muestra cuando un atributo de perfil de tipo cadena está vacío para un perfil determinado; configurada por atributo mediante “Insertar con texto de reserva”.
Terminología
  • Nombre canónico: editor de personalización
  • No confunda: El editor de Personalization (utilizado para generar expresiones de contenido en mensajes, correos electrónicos, notificaciones push y ofertas, admite la sintaxis de Handlebars y PQL) ≠ el editor de expresiones avanzadas (utilizado en el recorrido para condiciones en fuentes de datos e información de evento, actividades de espera personalizadas y asignación de parámetros de acción) proporciona funciones y operadores integrados que difieren de los del editor de personalización
  • No confunda: Atributos de perfil (basados en esquemas XDM, disponibles en todos los contextos) ≠ Atributos contextuales (específicos de recorrido/campaña, solo disponibles en ese contexto) ≠ Atributos de destino (solo campañas orquestadas)
  • No confundir: Finalización automática para HTML/Texto (sugiere finalizaciones de atributos de personalización) ≠ finalización automática de código HTML nativo (el editor es el predeterminado cuando se deshabilita la opción)
Protecciones y limitaciones
  • Completar automáticamente solo está disponible para los formatos HTML y Texto; solo admite atributos de perfil y contexto.
  • El modo de visualización de pastillas solo está disponible para atributos de perfil, atributos contextuales y medios dinámicos.
  • La personalización de URL solo está disponible para los tipos de vínculo Vínculo externo, Vínculo de baja y Vínculo de no participación.
  • De forma predeterminada, el panel de atributos muestra solo los atributos rellenados; desactive “Mostrar solo atributos rellenados” para mostrar todos los atributos de esquema.
  • El uso del modelo de ofertas solo debe contener atributos de perfil; los atributos que no sean de perfil en una decisión provocarán un error de validación.
Preguntas más frecuentes

Q: ¿Dónde se puede agregar la personalización en Journey Optimizer?

En cualquier campo con el icono de añadir personalización, incluida la línea de asunto del correo electrónico, los campos de notificación push (Título, Cuerpo, Sonido personalizado, Distintivos, Datos personalizados), los elementos de texto de Designer de correo electrónico, las direcciones URL (vínculo externo, vínculo de baja, exclusión), los subdominios/encabezados de configuración de correo electrónico/parámetros de seguimiento de URL y las representaciones de tipo de texto de ofertas.

Q: ¿Cuáles son las fuentes de personalización disponibles?

Atributos de perfil, atributos de Target (solo campañas orquestadas), audiencias, decisiones de oferta y atributos de contexto (eventos de recorrido/campaña y respuestas de acciones personalizadas).

Q: ¿Cómo se valida una expresión?

La validación se ejecuta automáticamente al hacer clic en Agregar para cerrar el editor. También puede almacenarla en déclencheur manualmente con el botón Validar. Los errores comunes incluyen: ruta no encontrada (campo no en esquema), discrepancia de tipos (iteración de una cadena como matriz), sintaxis de Handlebars no válida y definición de segmento no válida.

Q: ¿Qué hace la opción Píldoras?

Procesa las rutas de atributos largas como tokens compactos en los que se puede hacer clic para mejorar la legibilidad en el editor. Disponible solo para atributos de perfil, atributos contextuales y medios dinámicos.

Q: ¿Por qué sólo veo algunos atributos en el panel de atributos?

De forma predeterminada, el panel solo muestra los atributos rellenados. Seleccione el icono de configuración situado encima del campo de búsqueda y active la opción “Mostrar solo atributos rellenados” para mostrar todos los atributos de esquema.

recommendation-more-help
journey-optimizer-help