Documentación de Rekomi
Para marcas
Marcas

Atribución por código de cupón

Usa los códigos promocionales de Stripe como mecanismo de seguimiento junto a los enlaces de referido.

La atribución por código de cupón permite que tus afiliados compartan un código canjeable, en esencia un código de referido, en el checkout en lugar de una URL con seguimiento de clics. Es útil cuando:

  • Tu afiliado lo menciona en su podcast, video o newsletter y su audiencia va a escribir un código en lugar de hacer clic.
  • El cliente llega directo a tu sitio (buscador, notoriedad de marca) pero canjea un código en Stripe Checkout.
  • Quieres un rastro en Stripe que vincule los ingresos con un afiliado concreto.

Rekomi crea el cupón de Stripe por ti, genera un código promocional único por afiliado y acredita al afiliado correcto cada vez que un cliente canjea uno en el checkout. Los reembolsos anulan la comisión automáticamente.

La atribución por cupón funciona en las integraciones de Stripe, Shopify, Wix, BigCommerce, WooCommerce y Chargebee (en una tienda BigCommerce con varios storefronts, un código generado bajo una campaña limitada a ciertos storefronts solo funciona en esos storefronts) (los códigos son códigos promocionales o códigos de descuento reales en ese checkout, así que los clientes reciben el descuento de verdad). Los códigos de Stripe se crean desde este panel; los de Shopify, Wix y BigCommerce se crean desde la app integrada de Rekomi dentro del administrador de la tienda y aquí se listan; los de WooCommerce se crean aquí y el plugin los da de alta; los de Chargebee se crean aquí y se dan de alta como cupones en tu sitio de Chargebee (el código es el ID del cupón, lo que requiere una clave de API de acceso completo en la conexión). No está disponible en otros proveedores de facturación (Paddle, Lemon Squeezy y el resto) ni en configuraciones solo servidor a servidor; en esos casos, el área de cupones de la campaña en tu panel lo explica en lugar de ofrecer la función, y los afiliados siguen ganando a través de sus enlaces. La creación de códigos por parte del afiliado (afiliados que crean sus propios códigos personalizados) funciona en todos los canales con cupones.

Creas cupones desde el panel web en cualquier checkout conectado. La pestaña Cupones y el diálogo de creación indican en cuál se generan los códigos ("Los códigos se crean como cupones de Wix"), así que siempre sabes lo que estás creando: en Stripe y Chargebee los códigos son cupones en esa cuenta; en Shopify, BigCommerce, Wix y WooCommerce el código de cada afiliado se crea como un descuento real en tu tienda, sin necesidad de una cuenta de Stripe. Los códigos de BigCommerce y Wix se aplican a todo el pedido, así que ahí no se ofrece el límite por producto. Las apps de tienda (la app de Rekomi dentro de tu administrador de Shopify, BigCommerce, Wix o WordPress) crean los mismos cupones desde el otro lado; cualquiera de los dos sitios sirve.

La pestaña Cupones de la campaña con un cupón de campaña que muestra los códigos generados, el modo de autoservicio y el estado de prioridad sobre el clic

Si tu sitio de Chargebee ya tiene cupones de afiliado (de una plataforma anterior o creados a mano), no tienes que volver a crearlos: la pestaña Cupones de la campaña tiene Importar cupones existentes de Chargebee, que asigna esos ids de cupón exactos a tus afiliados sin tocar Chargebee. Consulta Instalar en Chargebee.

Cómo funciona

  1. La marca crea un cupón de campaña. Elige un descuento (% o importe fijo en $), una duración, y opcionalmente un máximo de canjes y una fecha de caducidad. Rekomi crea por debajo el coupon de Stripe correspondiente y guarda su id.
  2. La marca genera un código por afiliado. Desde la página de detalle de un afiliado, haz clic en "Generar" en la pestaña Cupones. Rekomi crea un promotion_code de Stripe que apunta al cupón de la campaña y lleva el id del afiliado en sus metadatos.
  3. El afiliado comparte el código. El código aparece en /a/campaigns/{id} para que lo copie. Opcionalmente, las marcas dejan que los afiliados creen sus propios códigos personalizados desde /a: cada cupón de campaña tiene un ajuste de autoservicio con tres modos (nadie, todos los afiliados aprobados, o una lista concreta de afiliados que tú eliges).
  4. El cliente canjea el código en el checkout. Stripe dispara invoice.paid o customer.subscription.created con el código promocional incluido. Rekomi lo ve, acredita al afiliado propietario y registra una conversión con attribution_method = "coupon".
  5. Lo ves como cualquier otra venta. La conversión llega a tu panel automáticamente, marcada en la columna Source como "Coupon" con el código canjeado (por ejemplo "Coupon · SARAH20"), junto a las conversiones por enlace y servidor a servidor. No hay nada que configurar: las conversiones por cupón nunca pasan en silencio. El mismo attribution_method (y el código) está en la API REST, en la exportación CSV (columnas attribution_method + coupon_code) y en el webhook conversion.created si sincronizas las conversiones con tus propios sistemas.
  6. Los reembolsos anulan la comisión. Un reembolso total resta uno al contador de canjes del afiliado y marca la conversión como reembolsada; los reembolsos parciales recuperan la comisión de forma proporcional y mantienen el canje contado.

Cuándo el cupón gana a la atribución por clic

Cada cupón de campaña tiene un interruptor Overrides click attribution (activado por defecto). Cuando está activo, el canje de un cupón acredita al afiliado del cupón aunque el cliente también haya hecho clic en el enlace de seguimiento de otro afiliado. Úsalo cuando:

  • Quieres que los afiliados que trabajan con códigos (influencers, presentadores de podcast) ganen frente al tráfico genérico del sitio.
  • Quieres una ruta de atribución determinista y observable, sin ambigüedad de cookies.
  • Tus afiliados generan intención de compra a través de audio o video, donde los clics son raros.

Desactívalo cuando:

  • El seguimiento por clic es tu canal principal y los códigos son secundarios.
  • Gestionas flujos con varios afiliados en contacto con el cliente, donde debe ganar el primer clic y el cupón es un mecanismo de "gracias por canjearlo".

Varios códigos por afiliado

Puedes generar tantos códigos como quieras para un mismo afiliado. Todos se suman en las estadísticas de ese afiliado; cada código tiene su propio contador de canjes. Es útil para:

  • Códigos por campaña (SARAH-BLACKFRIDAY frente a SARAH-SPRING).
  • Pruebas A/B del texto ("Prueba SARAH20" frente a "Prueba SARAHSPRING").
  • Dejar que el afiliado personalice variantes sin perder la atribución.

Limitar un cupón a productos concretos

Por defecto, un cupón de campaña descuenta el pedido completo. Puedes limitarlo a productos concretos, de modo que el descuento (y la atribución) solo se aplique a esas líneas.

En el canal de Stripe, usa "Limitar a productos concretos" en el diálogo de creación del cupón: un selector lista tus productos activos de Stripe (nombre, imagen e id) con buscador, para que elijas en lugar de escribir. El selector muestra tus 100 productos activos más recientes; para catálogos más grandes, o si lo prefieres, "Pegar IDs de producto" acepta ids prod_... separados por comas, y la API usa el mismo campo productRefs (consulta Seguimiento por código de cupón). En una tienda Shopify, usa "Limitar a productos" al crear una oferta de cupón en la app de Rekomi dentro de tu administrador de Shopify: elige los productos con el propio selector de productos de Shopify, y cada código generado bajo esa oferta hereda el alcance.

Nivel de plan

Los cupones están disponibles para todas las marcas desde el panel. Gestionar cupones a través de la API pública requiere un plan de pago (Starter o superior). Los usuarios en prueba (prueba gratuita de 14 días en cualquier nivel) pueden usarlo todo.

Qué se crea en Stripe

Por cada cupón de campaña, Rekomi crea:

  • Un coupon de Stripe con el descuento que elegiste, un redeem_by (caducidad) opcional y metadata.rekomi_campaign_coupon_id con el id de la fila en Rekomi.

Por cada cupón de afiliado, Rekomi crea:

  • Un promotion_code de Stripe vinculado al cupón de la campaña, con el código que indicaste (o uno generado por nosotros), un max_redemptions opcional heredado del cupón padre y metadata.rekomi_affiliate_coupon_id con el id de la fila en Rekomi.

Si eliminas una fila en Rekomi, Rekomi desactiva o elimina el objeto de Stripe en la medida de lo posible. La fila de Rekomi es la fuente de verdad para la atribución.

Acceso por API

Los endpoints de cupones están documentados en la referencia para desarrolladores. Tanto /api/campaigns/{programId}/coupons como /api/affiliates/{affiliateId}/coupons están expuestos bajo /api/v1/* para quienes llaman a la API pública con claves rk_live_*.

Autoservicio para afiliados

Cada cupón de campaña tiene un modo de autoservicio que controla quién puede crear sus propios códigos:

  • Todos los afiliados aprobados (el valor por defecto para los cupones nuevos creados en el panel o en la app de Shopify): cualquier afiliado aprobado en la campaña puede crear códigos personalizados desde /a/campaigns/{id}. Esa es la idea del autoservicio: tú defines la oferta y los afiliados se encargan de sus propios códigos.
  • Nadie: solo tú generas códigos, desde la página de detalle del afiliado. (Sigue siendo el valor por defecto para quienes llaman a la API y omiten el campo, así que las integraciones existentes conservan su comportamiento.)
  • Afiliados concretos: una lista que tú eliges, en el panel o en la app de Shopify; quitar a un afiliado de la lista revoca los códigos que creó.

Los códigos siguen teniendo que cumplir ^[A-Z0-9_-]{3,32}$ y ser únicos dentro de la marca. El autoservicio es útil en programas con influencers donde cada creador controla su propia marca personal, o en flujos sin supervisión donde prefieres no tener que aprobar cada código desde el lado de la marca. Puedes cambiar el modo en cualquier momento; los códigos ya creados siguen funcionando a menos que los revoques.

Tarifas de comisión por cupón

Un cupón de campaña puede llevar su propia tarifa de comisión. Cuando defines "Los códigos de este cupón ganan" en un cupón, cada venta hecha con uno de sus códigos paga esa tarifa en lugar de la tarifa de la campaña (y en lugar de cualquier tarifa por afiliado, de grupo, de nivel o por producto). Cero es un valor real: "los códigos no ganan nada" es la forma de gestionar un código de solo descuento, por ejemplo un código de Black Friday que no debe pagar comisión.

El diálogo de creación del cupón con el campo opcional de lo que ganan los códigos de este cupón

Dos detalles que conviene saber:

  • La tarifa se aplica a las ventas hechas con el código. Si el mismo afiliado comparte su enlace de seguimiento en su lugar, las ventas por enlace pagan la escala normal de la campaña.
  • En suscripciones, Stripe adjunta el código a cada factura que descuenta. Un cupón "once" paga la tarifa del cupón en la primera factura; las renovaciones (que ya no llevan el descuento) vuelven a la escala de la campaña. Los cupones "forever" y los "repeating" aún vigentes siguen pagando la tarifa del cupón en cada factura con descuento.

Elección del afiliado: deja que cada afiliado elija su reparto

Algunos programas dan a sus embajadores un beneficio fijo y dejan que cada persona decida cómo usarlo: regalar todo el descuento a su audiencia, o repartirlo y quedarse con una comisión. El interruptor Elección del afiliado del diálogo de creación del cupón hace exactamente eso. Defines de 2 a 4 opciones, cada una un par de descuento para el comprador y comisión para el afiliado, por ejemplo:

  • Opción A: los compradores tienen un 10% de descuento, el afiliado no gana nada (la opción regalo).
  • Opción B: los compradores tienen un 5% de descuento, el afiliado gana un 5% por venta.

Cuando un afiliado crea su código, elige una opción; esa elección decide tanto el descuento que reciben sus compradores como lo que le paga su código, y cada código muestra sus propias condiciones ("5% de descuento · te paga un 5% por venta"). El diálogo muestra una vista previa de las opciones exactas que verán los afiliados, generadas a partir de tus números, así que nadie tiene que redactar ni revisar el texto.

El diálogo de creación del cupón con Elección del afiliado activada, dos filas de frase y la vista previa en vivo de lo que ven los afiliados

Cuando un afiliado crea su código, las mismas opciones aparecen en su flujo de creación:

El flujo de creación del afiliado con las tarjetas de elección de cómo debe funcionar tu código

Reglas que conviene conocer:

  • Los cupones con elección permiten por defecto 5 códigos por afiliado (ajustable en la configuración del cupón, incluso hasta 1). Cada código fija la opción con la que se creó, y cada venta paga según el código que se usó; las ventas pasadas conservan la tarifa con la que se ganaron.
  • Las opciones no se pueden cambiar después de crear el cupón, igual que el descuento. Archiva el cupón y crea uno nuevo para cambiarlas.
  • En suscripciones aplica la misma regla de renovación de arriba: el reparto elegido paga en las facturas que el código descuenta. Un cupón "once" lo paga en la primera factura; las renovaciones vuelven a la tarifa habitual del afiliado.
  • Tanto la tarifa por cupón como las opciones funcionan en todos los canales con cupones. El panel de la app dentro de Stripe todavía no ofrece cupones con elección; créalos desde el panel o deja que los afiliados creen los suyos.

Ver también

  • Reclutamiento de subafiliados: la otra función de red de afiliados, un programa de 2 niveles con una comisión extra acotada sobre la comisión normal, con un solo nivel de reclutamiento. Funciona junto con la atribución por cupón; la comisión extra se dispara tanto si la venta del afiliado reclutado se atribuyó por clic como por cupón.
  • Tarifas de comisión por producto: fija una comisión distinta para productos concretos, además de la atribución por cupón.