Ir al contenido principal

Cómo añadir widgets de Recompensas de Growave mediante marcadores de posición

Escrito por Simon Akhrameev

🚀 Disponibilidad de la función

Estos widgets del programa de Recompensas están disponibles para los usuarios de Growave 2.0 (aquellos que se unieron después del 22 de enero de 2024).

Growave ofrece múltiples formas de mostrar los widgets de recompensas en su tienda de Shopify. Usted puede utilizar la página de Widgets en el sitio en el panel de administración de Growave para colocar los widgets automáticamente o añadirlos a través del personalizador de temas de Shopify.

Para obtener más flexibilidad, usted puede insertar marcadores de posición de widgets directamente en el código de su tema. Esto le permite posicionar los widgets en ubicaciones personalizadas más allá de la configuración predeterminada. Cada widget requiere un nombre de clase específico y puede admitir atributos adicionales para su personalización.

Esta guía describe los códigos de los marcadores de posición y los atributos para cada widget del programa de Recompensas, ayudándole a integrarlos perfectamente en su tienda.


Uso de un marcador de posición con atributos de datos

Para insertar un widget de Recompensas, cree un elemento <div> vacío con el nombre de clase correspondiente. Shopify oculta los bloques <div> vacíos en el modo embebido, por lo que debe añadir style="display:block" para garantizar su visibilidad.

Algunos widgets de Recompensas requieren atributos de datos para funcionar correctamente. Estos atributos pasan información esencial, como detalles del cliente o ajustes. Consulte los detalles de cada widget a continuación para conocer los atributos requeridos.

  • Ejemplo:

<div class="widget-placeholder-class-name" style="display:block" data-gw-attribute1="value1" data-gw-attribute2="value2" ></div>

Añadir el widget a su tienda de Shopify

Usted puede añadir marcadores de posición a su tienda de Shopify de dos maneras:

  • Personalizador de temas: Vaya a Tienda en línea → Temas → Editar tema, seleccione la página correspondiente y añada una sección Liquid personalizado desde la pestaña de Secciones. Inserte el código del marcador de posición en el área de texto.

  • Editar código: Vaya a Tienda online → Temas → ⋮ (menú de tres puntos) → Editar código, seleccione el archivo de plantilla Liquid correspondiente y añada el código del marcador de posición directamente en el HTML.


Widget de saldo de puntos del cliente (inline)

Este widget muestra el saldo de puntos del cliente como un valor numérico simple seguido de la palabra "puntos". Se puede colocar en cualquier lugar de la página para facilitar el acceso al saldo actual del cliente.

Para este widget, se utiliza un elemento <span> en lugar de un <div> porque es un elemento de línea (inline), lo que significa que no creará espacios adicionales ni interrumpirá el flujo del texto circundante. Esto lo hace ideal para mostrar el saldo de puntos del cliente dentro de una oración o dentro de otro contenido en línea, como una barra de navegación o un botón.

  • Visibilidad del widget:

El widget no se mostrará si el cliente no ha iniciado sesión o no califica para el programa de Recompensas.

  • Código:

<span
class="gw-rd-customer-points-balance-inline-widget-placeholder"
data-gw-enable-points-name="true"
style="display: block"
></span>
  • Atributo: data-gw-enable-points-name (opcional) — controla si se muestra el nombre de los puntos.


Widget de ganar puntos en la página de producto

Este widget muestra los puntos potenciales que un cliente ganará al comprar un producto específico. También incluye un enlace al widget emergente de Recompensas, donde los clientes pueden aprender más sobre el programa de lealtad.

Para activar este widget, habilite el programa de Puntos y configure la acción recompensable Realizar pedido.

⚠️ Importante

  • Si el cliente forma parte de un Nivel VIP donde los puntos se multiplican, el widget reflejará el número actualizado de puntos cuando haya iniciado sesión.

  • El widget no considera los ajustes de Cálculo del importe de recompensa, como la exclusión de descuentos y tarjetas de regalo o la inclusión de impuestos y envío.

  • Este widget solo funciona con la acción recompensable Realizar pedido.

  • Código:

<div
class="gw-rd-earn-points-product-page-widget-placeholder"
data-gw-product-id="1234567890"
data-gw-variant-id="1234567890"
data-gw-widget-shadow-root-enabled="true"
style="display: block; --gw-background-color: #ffffff; --gw-font-color: #000000;"
></div>
  • Atributos:

    • data-gw-product-id: especifica el identificador único del producto cuyos puntos de recompensa se mostrarán.

    • data-gw-variant-id (opcional): especifica el identificador único de la variante del producto cuyos puntos de recompensa se mostrarán.

  • Variables CSS:

    • --gw-background-color: establece el color de fondo del widget.

    • --gw-font-color: establece el color de fuente del widget.


Widget de ganar puntos en el carrito

Este widget muestra la cantidad de puntos que un cliente puede ganar comprando todos los artículos que se encuentran actualmente en su carrito, basándose en la acción recompensable Realizar pedido.

Para activar este widget, habilite el programa de Puntos y configure la acción recompensable Realizar pedido.

⚠️ Importante

  • El widget de ganar puntos en el carrito calcula los puntos utilizando únicamente la acción recompensable Realizar pedido. No incluye puntos de Campañas de impulso, multiplicadores de Nivel VIP u otros modificadores.

  • Si su carrito se actualiza dinámicamente (ej., sin una recarga completa de la página), asegúrese de actualizar los atributos de datos dinámicos del widget para que muestre los puntos correctos.

Código:

<div
class="gw-rd-earn-points-cart-widget-placeholder"
data-gw-cart-total-price="##{{ cart.total_price }}"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>

Atributos:

  • data-gw-cart-total-price (dinámico): especifica el monto total del carrito en centavos para el cálculo de puntos.

  • data-gw-widget-shadow-root-enabled (opcional): habilita el Shadow DOM para encapsular los estilos del widget y evitar conflictos.


Widget de página de Formas de ganar

Este widget muestra todas las formas disponibles en las que los clientes pueden ganar puntos en el programa de lealtad. Proporciona una descripción general de acciones como realizar pedidos, dejar reseñas, suscribirse a boletines informativos, registrarse y celebrar cumpleaños. Los clientes pueden seguir su progreso, y las acciones completadas se marcan visualmente para mejorar la claridad.

  • Visibilidad del widget:

    • Este widget está disponible cuando el programa de Puntos está habilitado.

    • Es visible tanto para invitados como para clientes que han iniciado sesión (si no se han establecido restricciones de elegibilidad de clientes en los ajustes de Disponibilidad de recompensas), aunque la visualización del saldo y las acciones completadas solo se muestran al iniciar sesión.

  • Código:

<div
class="gw-rd-ways-to-earn-page-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
data-gw-show-points-balance="true"
style="display: block"
></div>
  • Atributos

    • data-gw-widget-shadow-root-enabled (opcional): habilita o deshabilita el uso del Shadow DOM. Establezca en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.

    • data-gw-show-points-balance (opcional): indica si se debe mostrar el saldo de puntos del cliente en la parte superior del widget. Establezca en "true" para mostrar el saldo o "false" para ocultarlo.


Widget de página de Formas de canjear

Este widget permite a los clientes canjear sus puntos ganados por las recompensas disponibles directamente desde la tienda en línea. Muestra opciones de canje como descuentos porcentuales, descuentos de monto fijo, envío gratis, productos gratuitos y tarjetas de regalo, junto con los puntos requeridos para cada recompensa. Si un cliente no tiene suficientes puntos para canjear una recompensa, el widget indica claramente el saldo requerido.

  • Visibilidad del widget:

    • Este widget está disponible cuando el programa de Puntos está habilitado.

    • Es visible tanto para los invitados como para los clientes que han iniciado sesión (si no se han establecido restricciones de elegibilidad de los clientes en los ajustes de Disponibilidad de recompensas), pero solo los clientes que han iniciado sesión pueden canjear puntos.

  • Código:

<div
class="gw-rd-ways-to-spend-page-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
data-gw-show-points-balance="true"
data-gw-redirect-to-cart-after-redeem="true"
style="display: block"
></div>
  • Atributos:

    • data-gw-widget-shadow-root-enabled (opcional): habilita o deshabilita el uso del Shadow DOM. Establézcalo en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.

    • data-gw-show-points-balance (opcional): indica si se debe mostrar el saldo de puntos del cliente en la parte superior del widget. Establézcalo en "true" para mostrar el saldo o en "false" para ocultarlo. El valor predeterminado es "false".

    • data-gw-redirect-to-cart-after-redeem (opcional): determina si el cliente es redirigido automáticamente a la página del carrito después de canjear una recompensa de producto gratuito. Establézcalo en "true" para habilitar la redirección automática, o en "false" para mantener al cliente en la página actual.


Widget de página de Recompensas disponibles

Este widget muestra todas las recompensas que un cliente ha canjeado pero que aún no ha utilizado, como envío gratis, productos gratuitos, descuentos o tarjetas de regalo. Cada recompensa se muestra como una tarjeta, y al hacer clic en ella se abre una ventana emergente con el título de la recompensa, las condiciones (si las hay) y un código o un botón de acción para aplicarla.

Ejemplo de widget
  • Visibilidad del widget:

    • Solo visible para clientes que han iniciado sesión y son elegibles.

  • Código:

<div
class="gw-rd-available-rewards-page-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • data-gw-widget-shadow-root-enabled (opcional) — habilita el uso del Shadow DOM. Establézcalo en "true" para encapsular los estilos del widget y evitar conflictos con el resto de la página.


Widget de raíz del popup de Recompensas

Este widget muestra la información del programa de Recompensas directamente en la página en lugar de como una ventana emergente. Los clientes pueden interactuar con el widget para ganar y canjear puntos, ver las recompensas disponibles, acceder a los detalles del programa de referidos y consultar el estado de su nivel VIP. A diferencia del widget emergente de Recompensas regular, que se abre cuando se activa, este widget permanece incrustado en el diseño de la página, lo que hace que los detalles del programa de lealtad sean continuamente visibles.

  • Código:

<div
class="gw-rd-popup-root-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • data-gw-widget-shadow-root-enabled (opcional ) — habilita o deshabilita el uso del Shadow DOM para el widget. Establézcalo en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.


Widget de página de preguntas frecuentes de Recompensas

Este widget muestra las preguntas frecuentes relacionadas con su programa de Recompensas. Ayuda a los clientes a entender cómo ganar y canjear puntos, las reglas para los niveles VIP, cómo funciona el programa de referidos y otros detalles clave. El contenido de las preguntas frecuentes se gestiona en el Panel de administración de Growave y se renderiza automáticamente en la tienda en línea cuando se coloca el widget.

Para cambiar el texto en el widget de preguntas frecuentes de Recompensas:

  1. En su Panel de administración de Growave, vaya a MarcaPreguntas más frecuentes.

  2. Edite el texto predeterminado para las preguntas existentes.

  3. Añada nuevas preguntas y respuestas según sea necesario.

  • Código:

<div
class="gw-rd-faq-page-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • data-gw-widget-shadow-root-enabled (opcional ) — habilita o deshabilita el uso del Shadow DOM para el widget. Establézcalo en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.


Widget de página del programa de Referidos

Este widget proporciona una visión general del proceso de referidos, mostrando detalles sobre las recompensas disponibles tanto para el cliente que refiere como para el amigo referido. Incluye un enlace de referido único para cada cliente y opciones para compartir a través de canales de redes sociales.

🚀 Disponibilidad de la función

El widget de página del programa de Referidos es parte de la función de página de Recompensas disponible a partir del plan Growth.

  • Visibilidad del widget:

Este widget está disponible tanto para usuarios que han iniciado sesión como para invitados. Los clientes que han iniciado sesión verán su enlace de referido único, mientras que a los invitados se les pedirá que se registren o inicien sesión para acceder a las funciones de referidos.

  • Código:

<div
class="gw-rd-referral-program-page-widget-placeholder"
data-gw-img-url="https://example.myshopify.com/cdn/shop/files/example.jpg"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • Atributos:

    • data-gw-img-url (opcional): especifica la URL de la imagen que se mostrará en el widget.

    • data-gw-widget-shadow-root-enabled (opcional): habilita o deshabilita el uso del Shadow DOM para el widget. Establezca en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.


Widget de página de Referidos

Este widget permite a los clientes realizar un seguimiento de sus amigos referidos y sus detalles clave, como nombres, direcciones de correo electrónico, estados de los referidos (ej., pendiente o completado) y fechas de los referidos. Si existen múltiples referidos, los clientes pueden navegar a través de la lista utilizando controles de flecha.

🚀 Disponibilidad de la función

El widget de página de Referidos es parte de la función de página de Recompensas disponible a partir del plan Growth.

  • Visibilidad del widget:

    • Este widget es visible únicamente para los clientes que han iniciado sesión.

    • El programa de referidos debe estar activo para que se muestren los detalles de los referidos.

  • Código:

<div
class="gw-rd-referrals-page-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • data-gw-widget-shadow-root-enabled (opcional ) — habilita o deshabilita el uso del Shadow DOM para el widget. Establézcalo en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.


🚀 Disponibilidad de la función

Los widgets del programa Niveles VIP están disponibles a partir del plan Growth .

Widget de tarjeta de Niveles VIP

Este widget proporciona una representación visual del programa VIP de una tienda, mostrando los diferentes niveles y sus beneficios asociados. Cada nivel destaca beneficios clave, como multiplicadores de puntos, recompensas exclusivas y privilegios especiales, motivando a los clientes a participar en el programa de lealtad y avanzar hacia niveles superiores.

  • Visibilidad del widget:

Este widget está disponible para todos los visitantes, pero los clientes que han iniciado sesión verán su nivel actual y su progreso hacia el siguiente nivel.

  • Código:

<div
class="gw-rd-vip-tiers-card-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • data-gw-widget-shadow-root-enabled (opcional ) — habilita o deshabilita el uso del Shadow DOM para el widget. Establézcalo en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.


Widget de página de Niveles VIP

Este widget proporciona a los clientes una visión general de su progreso en el programa de niveles VIP. Muestra su nivel actual, la fecha en que se alcanzó, los puntos acumulados y los puntos requeridos para alcanzar el siguiente nivel. Los clientes también pueden ver beneficios exclusivos como multiplicadores de puntos, ventajas especiales y recompensas únicas asociadas con cada nivel.

  • Visibilidad del widget:

    • Este widget solo está disponible cuando el Programa de Niveles VIP está habilitado.

    • Los clientes deben haber iniciado sesión para ver su nivel actual y su progreso.

  • Estilo:

    • El color de fondo de la tarjeta del nivel actual utiliza el Color principal del tema, con el color del texto siempre configurado en blanco.

    • El color de fondo de las tarjetas de otros niveles aplica el Color principal del tema con transparencia, mientras que el color del texto se adapta a partir del Color principal del tema.

  • Código:

<div
class="gw-rd-vip-tiers-page-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • data-gw-widget-shadow-root-enabled (opcional ) — habilita o deshabilita el uso del Shadow DOM para el widget. Establézcalo en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.


Widget de progreso individual de Niveles VIP

Este widget proporciona a los clientes una visión clara de su progreso dentro del programa de Niveles VIP. Muestra su nivel actual, los puntos acumulados y los puntos restantes requeridos para alcanzar el siguiente nivel. Esta representación visual ayuda a fomentar la participación continua en el programa de lealtad.

  • Visibilidad del widget:

    • Este widget solo está disponible cuando el Programa de Niveles VIP está habilitado.

    • Los clientes deben haber iniciado sesión para ver su nivel actual y su progreso.

  • Código:

<div
class="gw-rd-vip-tiers-single-progress-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • data-gw-widget-shadow-root-enabled (opcional ) — habilita o deshabilita el uso del Shadow DOM para el widget. Establézcalo en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.


Widget de progreso múltiple de Niveles VIP

Este widget muestra a los clientes su progreso a través de múltiples niveles VIP. Muestra cada nivel, los puntos o acciones requeridos para alcanzar el siguiente nivel basándose en los hitos configurados, y el progreso actual del cliente. Esto ayuda a motivar a los clientes a participar más y a desbloquear beneficios de niveles superiores.

  • Visibilidad del widget:

    • Este widget solo está disponible cuando el Programa de Niveles VIP está habilitado.

    • Los clientes deben haber iniciado sesión para ver su nivel actual y su progreso.

  • Código:

<div
class="gw-rd-vip-tiers-multi-progress-widget-placeholder"
data-gw-widget-shadow-root-enabled="true"
style="display: block"
></div>
  • data-gw-widget-shadow-root-enabled (opcional ) — habilita o deshabilita el uso del Shadow DOM para el widget. Establézcalo en "true" para encapsular los estilos y la estructura del widget dentro del Shadow DOM, evitando conflictos de estilo con el resto de la página.


Si tienes alguna pregunta o necesitas más ayuda, ponte en contacto con nuestro equipo de soporte en [email protected] o utiliza el icono de chat en la esquina inferior derecha de tu panel de administración de Growave.

¿Ha quedado contestada tu pregunta?