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.

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.