Skip to main content
Las plantillas de código le permiten escribir el JavaScript, el CSS y el HTML del widget. Después, los miembros del equipo completan un formulario de configuración que usted diseña para cada widget.
Utilice un widget listo para usar, o pida ayuda a su desarrollador si no se siente cómodo programando.

Crear una nueva plantilla

Siga estos pasos para crear una nueva plantilla de widget con código:
  1. Haga clic en Studio > Widgets > New widget.
  2. Seleccione Using code.
  3. Asigne un nombre a su plantilla, asocie un sitio web y, opcionalmente, escriba una descripción y añada etiquetas.
  4. Haga clic en Create.

El editor de plantillas

El editor de plantillas tiene un panel izquierdo y una zona de contenido.

Panel izquierdo

La esquina superior izquierda muestra el título de su plantilla. Pase el cursor sobre el título y haga clic en el pencil icon para renombrar la plantilla. Este panel contiene los dos pasos para crear su plantilla:
  • Code to run
  • Configuration form

Zona de contenido

Zona de contenido del editor de plantillas donde introduce el código de la plantilla
Introduzca el código de su plantilla en esta área.

Codificar la plantilla

Utilice el área central de contenido para codificar su plantilla de widget. Este código genera el widget en la página de su sitio web. El editor proporciona tres pestañas para distintos tipos de código:
  • JS (JavaScript)
  • CSS
  • HTML
De forma predeterminada, la pestaña JS está activa. Escriba su código en el área en blanco. Para validar su plantilla, introduzca al menos 10 caracteres en la pestaña JS. JavaScript es suficiente para crear su plantilla, pero también puede añadir HTML o CSS. Utilice este CSS predeterminado para dar formato a elementos, como listas y campos de texto, según la hoja de estilos de Kameleoon:
Después de escribir el código, haga clic en Configuration form en el panel izquierdo para pasar al paso de configuración.

Caso especial: variables

Para utilizar un campo (una variable) que completa el miembro del equipo, añada el atributo templateData al campo correspondiente en el paso Configuration form. Ejemplo:
Para recuperar la variable, utilice UserData en el paso Code to run. Ejemplo:

Create the configuration form

Interfaz del formulario de configuración
Utilice el paso Configuration form para crear el formulario que los miembros del equipo utilizan para configurar su widget. En este paso solo están disponibles las pestañas HTML y CSS.

HTML tab

Introduzca el código HTML de su formulario de configuración en la pestaña HTML. Los miembros del equipo utilizan este formulario para configurar su plantilla y crear un widget. Cada campo del formulario debe incluir un atributo con la siguiente sintaxis: templateData="[NameOfYourChoice]".

CSS tab

Los estilos que añade en la pestaña CSS se aplican al formulario de configuración. Este paso es opcional.

Activate the template

Para finalizar su plantilla, haga clic en Activate en la esquina superior derecha de la página del editor.
Si introduce menos de 10 caracteres en la pestaña JS, Activate no estará disponible.

Gestionar plantillas creadas

Después de crear una plantilla, aparece como una tarjeta en el panel de Widgets.

Utilizar el widget en un experimento

Para asociar un widget de código a un experimento:
  1. Abra o cree un experimento utilizando el Graphic editor.
  2. En la barra lateral izquierda, haga clic en Add junto a Elements.
  3. En la barra lateral Add element que se abre, haga clic en Widgets.
  4. Seleccione su widget personalizado de la lista y configúrelo.
Añadir widget

Previsualizar el widget

Las plantillas de widget basadas en código no tienen una acción Simulate directa. El menú de tres puntos del panel de Widgets ofrece solo Rename, Manage tags, Duplicate, Activate y Delete para un widget basado en código, y el encabezado del editor de plantillas ofrece solo Activate.
Menú de tres puntos para un widget basado en código, sin opción de Simulate
Para previsualizar un widget basado en código, añádalo a un experimento en borrador utilizando el Graphic editor: haga clic en Add junto a Elements en la barra lateral izquierda, haga clic en Widgets y seleccione su widget de la lista. A continuación, haga clic en Simulate en el Graphic editor para probar la campaña, incluido su widget, en un entorno similar al de producción antes de publicarla en directo. Para más información sobre el panel de simulación, consulte Simular una campaña.