App embed

El app embed («incrustación de la app») de DiscountOS es un único interruptor en el editor de temas. Con él activado, la app puede pintar cosas en tu tienda online: Sale Badges, Price Drops y el regalo añadido al carrito automáticamente en un descuento de regalo por compra. Con él desactivado, esos tres no muestran nada — tus descuentos se siguen aplicando, así que los compradores siguen recibiendo el dinero.

Configuración

Abre Promotions en la app de DiscountOS.

En la barra lateral del admin de Shopify, dentro de Apps, DiscountOS tiene tres entradas: Manage discounts, Block codes y Promotions (Beta).
Haz clic en Enable in theme editor.

Mientras el embed está desactivado, la página Promotions muestra una tarjeta App embed que dice “Sale Badges and Price Drops need the app embed enabled in your theme”, con un botón Enable in theme editor. El botón abre tu editor de temas directamente en el panel de app embeds.

En la página de una promoción, el mismo estado aparece en la columna derecha como una fila App embed permanente con un botón Enable o Disable.
Activa el app embed Promotions y guarda el tema.

En el panel App embeds del editor de temas, activa Promotions y haz clic en Save.

Actívalo en el tema que tienes publicado. Un app embed activado solo en un tema sin publicar o en borrador no llega a los compradores, y la app no lo cuenta.
Vuelve a la app y comprueba que el estado indica Enabled.

La insignia de estado junto a App embed cambia a Enabled. Mientras la app todavía está averiguando la respuesta, muestra un indicador de carga en lugar de una insignia.

Ajustes

El app embed tiene dos ajustes propios, en el editor de temas, bajo el encabezado Free gift. Solo importan si tienes un descuento de regalo por compra.

Refresh cart pages after gift changes

Activado de forma predeterminada. Después de que la app añada o quite un regalo, la página del carrito se recarga para que tu tema muestre el carrito nuevo. Desactívalo solo si tu tema actualiza su carrito sin recargar — la nota del propio ajuste dice que, cuando está desactivado, la página nunca se refresca tras los cambios de regalo, así que combínalo con el evento de abajo o los compradores podrían ver líneas de regalo desactualizadas hasta su siguiente interacción.

Custom cart update event

Opcional. El nombre del evento de actualización del carrito de tu tema. La app lo dispara tras los cambios de regalo para que el tema pueda actualizar su carrito en el sitio en lugar de recargar.

Cómo averigua la app el estado

Dos cosas le dicen a la app si el embed está activado, y se respaldan mutuamente.

La comprobación de la tienda online. La app abre la página de inicio de tu tienda online y busca la marca que Shopify imprime en la página para cada app embed activado. Es una respuesta definitiva, activado o desactivado, y no te cuesta nada — es la misma página pública que ve un comprador. La app la vuelve a leer como mucho una vez por minuto y por tienda.

El informe del propio embed. Cuando el embed se ejecuta, informa — desde tu tienda online publicada y desde la vista previa del editor de temas en el momento en que lo activas. Por eso el estado suele cambiar a Enabled a los pocos instantes de guardar el tema.

Las dos se combinan:

Marca encontrada → Enabled.
Falta la marca, pero el embed informó en los últimos 10 minutos → Enabled. Un informe en directo es el embed ejecutándose de verdad, y eso pesa más que una página que no mostró la marca.
Falta la marca y no hay ningún informe reciente → Not enabled.
La app no pudo leer la página en absoluto — tu tienda online está protegida con contraseña, o la solicitud agotó el tiempo de espera → deciden los informes por sí solos: un informe de las últimas 48 horas se lee como Enabled, y sin ningún informe el estado queda sin decidir y la app sigue comprobándolo.

En una tienda online protegida con contraseña la app no puede leer la marca, así que el informe es la única señal. Abre tu tienda online una vez con el embed activado y después recarga la app. Hasta que eso ocurra, el estado puede ir por detrás de lo que ya tiene tu tema.

Límites y notas

Los cuatro bloques de widgets no necesitan el embed. Quantity Break Table, Quantity Break Picker, Spend More Save More y Cart Goal Bar son bloques de tema que colocas en una sección; cada uno se muestra por su cuenta. Consulta Widgets de la tienda online.
Desactivar el embed nunca detiene un descuento. Shopify sigue comprobando el carrito y sigue aplicando el descuento. Lo que se detiene es la parte visual: las insignias, los precios tachados y el regalo puesto en el carrito en nombre del comprador. En un descuento de regalo por compra, los compradores pueden seguir añadiendo el regalo ellos mismos y sigue saliendo gratis.
Lo que cuenta es el tema publicado. La app lee tu tienda online publicada.
Los cambios tardan un momento en verse. Las promociones suelen llegar a tu tienda en un minuto, a veces hasta en 15.

Relacionado

Sale Badge — una insignia como “20% off” sobre las imágenes de tus productos.
Price Drop — el precio antiguo tachado junto al precio con descuento.
Regalo por compra — el descuento cuyo regalo añade el embed al carrito.
El app embed aparece como desactivado — qué hacer cuando el interruptor está activado pero la app dice lo contrario.