Uso de campos de formulario editables en experiencias basadas en código code-based-form-fields
Para obtener más flexibilidad y control sobre las experiencias basadas en código, Journey Optimizer permite que su equipo de desarrollo cree plantillas de contenido JSON o HTML que contengan campos editables predefinidos específicos.
Al crear una experiencia basada en código, los especialistas en marketing no técnicos pueden editar directamente estos campos en la interfaz, sin necesidad de abrir el editor de personalización o de tocar cualquier otro elemento de código en su recorrido o campaña.
Esta capacidad ofrece una experiencia simplificada para los usuarios de marketing, a la vez que permite a los desarrolladores un mayor control sobre el contenido del código, lo que reduce el espacio para errores.
Comprender la sintaxis del campo de formulario form-field-syntax
Para poder editar partes de una carga útil de código HTML o JSON, debe utilizar una sintaxis específica en el editor de expresiones. Esto implica declarar una variable con un valor predeterminado que los usuarios pueden invalidar después de aplicar la plantilla de contenido a su experiencia basada en código.
Por ejemplo, supongamos que desea crear una plantilla de contenido para aplicarla a las experiencias basadas en código y permitir a los usuarios personalizar un color específico utilizado en diferentes ubicaciones, como marcos o colores de fondo de botones.
Al crear la plantilla de contenido, debe declarar una variable con un identificador único, por ejemplo "color", y llamarla a las ubicaciones deseadas en el contenido donde desee aplicar este color.
Al aplicar la plantilla de contenido a su contenido, los usuarios pueden personalizar el color utilizado siempre que se haga referencia a la variable.
Añadir campos editables a plantillas de contenido HTML o JSON add-editable-fields
Para poder editar parte de su código JSON o HTML, comience creando una experiencia basada en código plantilla de contenido en la que puede definir campos de formulario específicos.
➡️ Aprenda a agregar campos editables a plantillas de experiencia basadas en código en este vídeo
-
Cree una plantilla de contenido y seleccione el canal Experiencia basada en código. Aprenda a crear plantillas
-
Seleccione el modo de creación: HTML o JSON.
note caution CAUTION Si cambia el modo de creación, se perderá todo el código actual. Las experiencias basadas en código y basadas en esta plantilla deben utilizar el mismo modo de creación. -
Abra editor de personalización para editar el contenido del código.
-
Para definir un campo de formulario editable , vaya al menú Funciones de ayuda en el panel de navegación izquierdo y agregue el atributo inline. La sintaxis para declarar y llamar a la variable se agrega automáticamente al contenido.
-
Reemplace
"name"
con un identificador único para identificar el campo editable. Por ejemplo, introduzca "imgURL".note note NOTE El ID de campo debe ser único y no puede contener espacios. Este ID debe utilizarse en cualquier lugar del contenido donde desee mostrar el valor de la variable. -
Adapte la sintaxis para adaptarla a sus necesidades añadiendo parámetros detallados en la siguiente tabla:
table 0-row-3 1-row-3 2-row-3 Acción Parámetro Ejemplo Declarar un campo editable con un valor predeterminado. Al añadir la plantilla al contenido, se utiliza este valor predeterminado si no se personaliza. Agregue el valor predeterminado entre las etiquetas en línea. {{#inline "editableFieldID"}}default_value{{/inline}}
Defina una etiqueta para el campo editable. Esta etiqueta se muestra en el editor de código al editar los campos de la plantilla. name="title"
{{#inline "editableFieldID" name="title"}}default_value{{/inline}}
-
Haga clic en Vista previa de campos de formulario para comprobar cómo se mostrarán los campos de formulario editables en las experiencias basadas en código que apliquen esta plantilla.
-
Utilice la sintaxis
{{{name}}}
en su código en cada lugar donde desee mostrar el valor del campo editable. Reemplazarname
por el ID único del campo definido anteriormente. -
Continúe de forma similar para agregar otros campos editables, ajustando cada uno de ellos con las etiquetas
{{#inline}}
y{{/inline}}
. -
Edite el resto del código según sea necesario, incluidos los ID correspondientes a los campos editables definidos. Descubra cómo
-
Guarde la plantilla.
Usar directivas de decisión en formularios de campo editables decision-policy-in-form-fields
Al crear una plantilla de contenido de experiencia basada en código, puede utilizar una política de decisión para aprovechar las ofertas en los campos de formulario editables.
-
Cree una plantilla de experiencia basada en código como se describe arriba.
-
Haga clic en Agregar directiva de decisión mediante el icono Mostrar decisión del carril derecho de la pantalla de edición o en el editor de expresiones desde la sección Directiva de decisión del menú de la izquierda.
Aprenda a crear una directiva de decisión en esta sección.
-
Haga clic en el botón Insertar directiva. Se agrega el código correspondiente a la política de decisión.
-
Después de la etiqueta
{{#each}}
, inserte el código correspondiente a los campos de formulario editables que desee agregar mediante la sintaxis inline descrita anteriormente. Reemplace"name"
con un identificador único para identificar su campo editable. En este ejemplo, utilice "title". -
Haga clic en Vista previa de campos de formulario para comprobar cómo se mostrarán los campos de formulario editables en las experiencias basadas en código que apliquen esta plantilla.
-
Inserte el resto del código encima de la etiqueta
{{/each}}
. Utilice la sintaxis{{{name}}}
en su código en cada lugar donde desee mostrar el valor de su campo editable. En este ejemplo, reemplacename
por "title". -
Guarde la plantilla.
Ejemplos de código code-examples
A continuación se muestran algunos ejemplos de plantillas JSON y HTML, algunas de las cuales incluyen políticas de decisión.
Plantilla JSON:
{{#inline "title" name="Title"}}Best gear for winter is here for you!{{/inline}}
{{#inline "description" name="Description"}}Add description{{/inline}}
{{#inline "imgURL" name="Image Link"}}Add link{{/inline}}
{{#inline "number_of_items" name="Number of items"}}23{{/inline}}
{
"title": "{{{title}}}",
"description": "{{{description}}}",
"imageUrl": "{{{imgURL}}}",
"number_of_items": {{{number_of_items}}},
"code": "DEFAULT"
}
- Los campos de tipo cadena deben estar entre comillas dobles.
- Los números enteros o booleanos NO deben incluirse entre comillas dobles. (Consulte el campo
number_of_items
en el ejemplo anterior).
Plantilla JSON con toma de decisiones:
{
"offer": [
{{#each decisionPolicy.fff709b7-7fef-4e4e-83d7-594fbcf196c1.items as |item|}}
{{#inline "title" name="Title"}}{{item._mobiledx.Title1}}{{/inline}} {{#inline "description" name="Description"}}{{item._mobiledx.Title2}}{{/inline}} {{#inline "imgURL" name="Image Link"}}https://luma.enablementadobe.com/content/luma/us/en/experience/warming-up/_jcr_content/root/hero_image.coreimg.jpeg{{/inline}}
{
"title": "{{{title}}}",
"description": "{{{description}}}",
"imageUrl": "{{{imgURL}}}",
"link": "https://lumaenablement.adobe.com/web/luma/home", "code": "DEFAULT"
},
{{/each}}
]
}
{{#each}}
y {{/each}}
s.Plantilla de HTML:
{{#inline "title" name="Title"}}Please enter title here{{/inline}}
{{#inline "imgSrc" name="Image link"}}{{/inline}}
<div class="TopRibbon__content"><img style="padding: 5px 10px;" class="TopRibbon__image" src="{{{imgSrc}}}" />{{{title}}}</div>
<style> .theme-luma .TopRibbon { background-color: #200098; }</style>
Plantilla de HTML con toma de decisiones:
{{#each decisionPolicy.f112884a-5654-43ad-9d6d-dbd32ae23ee6.items as |item|}}
{{#inline "title" name="Title"}}Title is: {{item._mobiledx.Title1}}{{/inline}}
<div class="TopRibbon__content"><img style="padding: 5px 10px;" class="TopRibbon__image" src="{{item._mobiledx.HeroBannerImage.sourceURL}}" />{{{title}}}</div>
<style> .theme-luma .TopRibbon { background-color: #200098; }</style>
{{/each}}
Editar campos de formulario en una experiencia basada en código edit-form-fields
Ahora que se ha creado la plantilla de contenido que contiene campos de formulario editables predefinidos, puede crear una experiencia basada en código mediante esta plantilla de contenido.
Podrá editar fácilmente los campos de formulario desde un recorrido de experiencia o una campaña basados en código, sin abrir el editor de personalización.
-
En la actividad de recorrido o en la pantalla de edición de la campaña, seleccione la plantilla de contenido que contiene los campos de formulario editables. Aprenda a utilizar las plantillas de contenido
note caution CAUTION Las plantillas disponibles para elegir están enfocadas a HTML o JSON según la configuración de canal seleccionada previamente. Solo se muestran las plantillas compatibles. -
Los campos predefinidos en la plantilla de contenido seleccionada están disponibles en el panel derecho.
-
Desde la sección Campos de formulario editables, puede:
- Edite cada valor directamente dentro de los campos editables, sin abrir el editor de código.
- Haga clic en el icono de personalización para editar cada campo con el editor de código.
note note NOTE En ambos casos, solo se puede editar un campo a la vez y no se puede editar el resto del contenido de la experiencia basado en código. -
Si se agregó una directiva de decisión a la plantilla de contenido, viene con todos los atributos disponibles en el esquema catálogo de ofertas. Puede editar el elemento de decisión en línea o mediante el editor de expresiones.
-
Para editar el resto del código, haga clic en el botón Editar código y actualice el contenido completo de la experiencia basado en código, incluidos los campos de formulario editables. Más información
Vídeo explicativo video
Aprenda a añadir campos editables a plantillas de contenido de canal de experiencia basadas en código.