Estados de atribución
Cada clic en un enlace de referencia (y cada uso de código promocional) crea un evento de atribución — un registro de "este visitante puede convertir para este socio". El registro de atribución muestra el estado de cada evento y una explicación completa de por qué terminó así. Esta página es el glosario de esos estados.
Glosario de estados
| Estado | Qué significa |
|---|---|
| Pendiente | El visitante hizo clic (o usó un código) pero todavía no ha convertido. El evento permanece pendiente hasta que se agota la ventana de atribución del programa |
| Convertido | El visitante realizó una compra dentro de la ventana de atribución. Se creó una comisión para el socio |
| Expirado | La ventana de atribución pasó sin ninguna conversión. Nunca se creará ninguna comisión a partir de este evento |
| Duplicado | El evento se dejó de lado — sustituido por una referencia más reciente para el mismo visitante, o marcado por la detección de fraude (véase más abajo) |
Converted, expired y duplicate son finales — un evento nunca sale de ellos. Los pagos de renovación de una suscripción añaden conversiones adicionales al mismo evento converted sin cambiar su estado.
Cómo se mueve un evento entre estados
- Pendiente → Convertido — llega una conversión (webhook de Stripe o llamada a la API de conversión) y se atribuye a este evento dentro de la ventana de atribución del programa (de 1 a 365 días, configurada en Configuración del programa).
- Pendiente → Expirado — la ventana de atribución transcurre sin ninguna conversión. La expiración es un mantenimiento de fondo normal, no un error.
- Pendiente → Duplicado — el evento se sustituye o se marca; los motivos se explican a continuación.
Por qué un evento se vuelve Duplicado
El panel de detalle del registro muestra el motivo concreto de cada duplicado:
- Sustituido por una referencia más reciente — el mismo visitante fue reatribuido antes de convertir. El caso más habitual: el visitante llegó a través del enlace del socio A y después usó el código promocional del socio B al finalizar la compra. El código gana (es el contacto más reciente y más explícito), el evento basado en el clic se marca como duplicado, y el panel de detalle del evento ganador muestra ambas partes — qué socio ganó y cuál fue sustituido, con marcas de tiempo.
- Autorreferencia detectada — la detección de fraude relacionó la identidad del cliente con la del propio socio; el evento se deja de lado y no se crea ninguna comisión.
Hay un caso relacionado que nunca afecta a los estados de atribución: una conversión que llega con un external_transaction_id ya procesado se rechaza como conversión duplicada a nivel de conversión. El evento de atribución conserva su estado; el rechazo se sigue registrando en el registro con su propia explicación.
Marcas de fraude en el registro
Los eventos afectados por la detección de fraude llevan un indicador distintivo en el registro, y el panel de detalle explica la regla que se activó (autorreferencia, conversión duplicada) junto con la acción tomada. Los socios solo ven una nota simplificada ("Esta conversión se marcó para revisión") — el detalle técnico permanece del lado del comerciante.
Cuando algo parece ir mal
Si falta una conversión que esperaba, o un evento expiró cuando esperaba una conversión, revise Solución de problemas — cubre el snippet, los ID de clic y la API de conversión de principio a fin.