Documentation menu

Generación de códigos de descuento nativos de tienda

MailInApp admite la Generación de códigos de descuento nativos de tienda de forma dinámica para tiendas Shopify y WooCommerce conectadas.

En lugar de forzar a los compradores a pasar por un checkout de terceros o cupones públicos genéricos, MailInApp genera automáticamente códigos de descuento de un solo uso y restringidos al cliente directamente en tu tienda al momento del envío — mediante dos mecanismos independientes que un mismo proyecto puede usar juntos, por separado, o no usar en absoluto:

Ambos generan códigos a través de la misma conexión de tienda subyacente y comparten la mecánica de abajo; un descuento por producto simplemente además restringe el código a un artículo y mantiene su propio marcador de enfriamiento, separado del de la oferta a nivel de proyecto y del de cualquier otro bloque de Producto.


Cómo funciona

Cuando una campaña o recorrido incluye una oferta de descuento:

  1. Resolución dinámica del cliente:
    • Shopify: resuelve el ID de cliente de GraphQL del destinatario (gid://shopify/Customer/...) mediante Admin GraphQL antes de generar el nodo de descuento.
    • WooCommerce: restringe el cupón generado a la dirección de correo exacta del destinatario usando la API REST de WooCommerce.
  2. De un solo uso y seguro:
    • Los códigos llevan sufijos criptográficos aleatorios (por ejemplo, MIA-7F3A91B2).
    • Cada código está restringido a un solo uso (usage_limit: 1) y vinculado exclusivamente a la dirección de correo del destinatario, evitando la fuga de cupones en sitios de ofertas.
  3. Alcance de producto opcional:
    • Un código generado para toda la tienda aplica a cualquier compra. Uno restringido a un producto — el propio selector de Alcance de la oferta a nivel de proyecto, o el descuento por producto de un bloque de Producto — se restringe solo a ese artículo: Shopify mediante customerGets.items.products.productsToAdd sobre un GID de producto real, WooCommerce mediante el campo product_ids del cupón.
  4. Preaplicación en el checkout de la tienda:
    • El enlace de un código para toda la tienda o restringido a un proyecto lo aplica en tu checkout genérico (/cart/?coupon=MIA-... para WooCommerce, /discount/MIA-... redirigiendo a / para Shopify).
    • El propio descuento por producto de un bloque de Producto en cambio lleva al comprador directamente de vuelta a la página propia de ese producto con el código ya aplicado (?coupon=MIA-... agregado a la URL del producto para WooCommerce; /discount/MIA-...?redirect=<product path> para Shopify) — no a la raíz de la tienda, ya que el correo los dirigió a un artículo específico.
  5. Visible antes de que el comprador haga clic:
    • El lienzo del Estudio muestra la misma insignia de descuento y el precio tachado que el correo enviado y la Vista en vivo en el momento en que activas el descuento por producto de un bloque de Producto — sin necesidad de abrir la Vista en vivo para comprobarlo.
    • Para tiendas Shopify, un bloque de aplicación opcional insignia de descuento de MailInApp muestra esa misma insignia directamente en la página de producto en vivo para un comprador que hizo clic desde el correo, antes del pago — mira Mostrar el descuento en tu página de producto (Shopify) más abajo para la configuración. No hay equivalente para WooCommerce — los cupones de WooCommerce no tienen ningún mecanismo para cambiar lo que muestra la propia página de producto.

Mostrar el descuento en tu página de producto (Shopify)

El lienzo del Estudio ya muestra la insignia de descuento y el precio tachado en el momento en que activas el descuento por producto de un bloque de Producto — sin necesidad de configuración. Poner esa misma insignia en tu tienda Shopify en vivo es un paso manual único por tienda, ya que MailInApp nunca edita tu tema automáticamente:

  1. En el Admin de Shopify, ve a Online Store → Themes y haz clic en Customize en tu tema en vivo (o en un borrador).
  2. Cambia el selector de página en la parte superior a una página de Product.
  3. Haz clic en la sección que muestra el precio/botón de compra — normalmente Product information o Buy buttons.
  4. Haz clic en Add block dentro de esa sección (no en "Add section") y elige MailInApp discount badge bajo Apps.
  5. Arrástralo junto al precio, ajusta opcionalmente sus colores en el panel de configuración, y luego Save.

Si Apps no aparece en el selector de bloques de esa sección, esa sección aún no admite bloques de aplicación — prueba con otra sección, o pide a tu desarrollador de temas que añada {"type": "@app"} a su schema. La mayoría de los temas Online Store 2.0 (Dawn y sus derivados) ya lo admiten en la sección principal de producto. Requiere un tema Online Store 2.0.

La insignia permanece invisible en una visita normal a la tienda por diseño — solo se muestra cuando la página de producto se carga con el enlace firmado que produce un correo real de descuento por producto. Así que visitar la página tú mismo no la mostrará, y tampoco lo hará Enviar prueba (eso renderiza el correo directamente y omite el paso de generación de descuento que firma el enlace de la insignia). Para verla de verdad, haz un envío real a un destinatario — aunque sea a ti mismo — y haz clic en Comprar ahora desde el correo recibido. Es una vista previa de solo visualización calculada a partir del propio precio del producto; el descuento real solo se aplica en el pago mediante el código de un solo uso de todas formas.


Tipos de oferta admitidos

  • Porcentaje de descuento: por ejemplo, 15% o 20% para toda la tienda, una colección, o un descuento de un solo producto.
  • Monto fijo de descuento: por ejemplo, $10 o $25 de descuento sobre el valor total del carrito, o sobre un producto.
  • Ventanas de vencimiento: los códigos llevan una fecha de vencimiento calculada automáticamente (por ejemplo, 7 o 14 días desde el momento del envío) para reforzar la urgencia en la tienda del comerciante.
  • Enfriamientos por cuenta: marcadores de enfriamiento integrados evitan sobre-cuponear al mismo contacto en varias programaciones o proyectos — un marcador para la oferta a nivel de proyecto, y uno separado por cada bloque de Producto, así descontar un producto nunca bloquea el enfriamiento de otro ni el de la oferta a nivel de proyecto.

Configuración e integración de API

  • Shopify: requiere credenciales de tienda conectada con el permiso write_discounts (gestionado durante la conexión OAuth).
  • WooCommerce: requiere una clave de consumidor y un secreto de API REST de tienda conectada con permisos de lectura/escritura.

El descuento por producto de un bloque de Producto además requiere que ese bloque tenga un producto real importado mediante su selector Importar desde la tienda (no una URL externa escrita a mano) — generar el código necesita el propio id numérico de producto de tu tienda para restringirlo.