El widget de JeriCommerce es un botón flotante que da a tus clientes acceso directo a sus recompensas, su nivel y sus cupones desde cualquier página de tu tienda online. No hacen falta páginas adicionales.

Activa el widget ¶
Activa el app embed del SDK
Ve a Shopify Admin > Online Store > Themes > Customize > App embeds, activa SDK de la aplicación JeriCommerce y guarda el tema. Este app embed carga el widget y el Storefront SDK en tu tienda.
Configura el widget en JeriCommerce
En JeriCommerce, ve a Customize > Widget and webapp. En Widget settings, marca Show the widget, elige tus opciones y guarda. La etiqueta Active on your store confirma que el app embed está activado.
Los ajustes guardados llegan a tu tienda en un máximo de 5 minutos. El navegador de cada visitante conserva los ajustes del widget hasta 5 minutos, y las páginas que ya están abiertas los mantienen hasta que se recargan.
Ajustes del widget ¶

| Ajuste | Qué hace |
|---|---|
| Show the widget | Activa o desactiva el widget. Al desactivarlo solo se oculta el widget. El SDK sigue instalado, así que las páginas personalizadas que lo usan siguen funcionando |
| Open when the page loads | Abre el widget automáticamente cuando se carga una página |
| Launcher button | Cuándo aparece el botón flotante: Show to everyone, Show to logged-in customers, Show to guests o Don't show |
| Position | Bottom right o Bottom left |
| Opens on | La página que los clientes ven primero: Program advantages, Profile, Orders, Coupons, Rewards, Earning flows o Referrals. Los visitantes que no han iniciado sesión siempre ven las ventajas del programa |
| Button text for guests | Texto del botón para los visitantes que no han iniciado sesión |
| Button text for customers | Texto del botón para los clientes con sesión iniciada. Puedes añadir [tier_name], [tier_balance] y [balance] |
| Use the program's background color / Use the program's text color | Usa los colores de tu aplicación web. Desmárcalas para elegir un Button background color y un Button text color para el widget |
| Page after login | Una página de tu tienda, que empiece por /, a la que llegan los clientes después de iniciar sesión desde el widget. Déjalo vacío para devolverlos a la página en la que estaban, con el widget abierto de nuevo |
| Open the widget on that page | Abre el widget en la Page after login |
| Custom CSS | Da estilo al botón y al marco del widget en tu tienda. No cambia el contenido dentro del widget |
Con Don't show, el botón flotante nunca aparece, pero el widget sigue abriéndose desde tus propios botones y enlaces (consulta Disparadores personalizados). Para desactivar el widget por completo, desmarca Show the widget.
Los programas nuevos empiezan con el widget desactivado: marca Show the widget cuando quieras mostrarlo en tu tienda.
Enlaces profundos ¶
Abre el widget automáticamente desde emails o SMS añadiendo un parámetro de consulta jeri a cualquier URL de tu tienda.
Abrir la página de ventajas
https://www.your-store.com?jeri=advantages
Abrir la página de recompensas
https://www.your-store.com?jeri=loyalty/rewards
Abrir el formulario de perfil
https://www.your-store.com?jeri=complete-profile
Los visitantes sin sesión inician sesión primero y vuelven al formulario, que es el que creas en Complete customer profile.
Disparadores personalizados ¶
Abre el widget desde cualquier botón o enlace de tu sitio con un fragmento #jeri. Así se evita recargar la página.
Abrir el widget
<a href="#jeri">See your Level</a>
Abrir una página concreta
<a href="#jeri=coupons">Open my coupons</a>
Los desarrolladores también pueden abrir, cerrar, mostrar u ocultar el widget desde JavaScript con el Storefront SDK, por ejemplo jeri.widget.open({ page: "rewards" }).
Rutas disponibles ¶
Usa estas rutas con enlaces profundos o disparadores personalizados.
| Ruta | Descripción |
|---|---|
check |
Verificación de email |
profile |
Perfil del usuario |
orders |
Historial de pedidos |
coupons |
Lista de cupones canjeados o asignados |
coupons/:couponSlug/:couponCode |
Detalle de un cupón concreto |
loyalty |
Página principal de fidelización (por defecto, formas de ganar puntos) |
loyalty/rewards |
Catálogo de recompensas |
loyalty/rewards/:rewardId |
Detalle de una recompensa concreta |
loyalty/earning-flows |
Formas de ganar puntos |
loyalty/tiers |
Página de detalle de los niveles VIP |
advantages |
Beneficios del programa para visitantes sin sesión iniciada |
referrals |
Panel del programa de referidos |
complete-profile |
Formulario de perfil de Complete customer profile. Requiere iniciar sesión |