Stati di attribuzione
Ogni clic su un link di referral (e ogni utilizzo di un codice promozionale) crea un evento di attribuzione — un record che dice "questo visitatore potrebbe convertire per questo partner". Il Registro di attribuzione mostra lo stato di ogni evento e una spiegazione completa del perché sia finito in quello stato. Questa pagina è il glossario di questi stati.
Glossario degli stati
| Stato | Cosa significa |
|---|---|
| In attesa | Il visitatore ha cliccato (o usato un codice) ma non ha ancora convertito. L'evento resta in attesa finché non scade la finestra di attribuzione del programma |
| Convertito | Il visitatore ha effettuato un acquisto entro la finestra di attribuzione. È stata creata una commissione per il partner |
| Scaduto | La finestra di attribuzione è trascorsa senza una conversione. Da questo evento non verrà mai creata alcuna commissione |
| Duplicato | L'evento è stato accantonato — sostituito da un referral più recente per lo stesso visitatore, oppure segnalato dal rilevamento delle frodi (vedi sotto) |
Converted, expired e duplicate sono definitivi — un evento non ne esce mai. I pagamenti di rinnovo di un abbonamento associano ulteriori conversioni allo stesso evento converted senza cambiarne lo stato.
Come un evento passa da uno stato all'altro
- In attesa → Convertito — arriva una conversione (webhook Stripe o chiamata all'API di conversione) ed è attribuita a questo evento entro la finestra di attribuzione del programma (1–365 giorni, impostata in Impostazioni del programma).
- In attesa → Scaduto — la finestra di attribuzione trascorre senza conversione. La scadenza è normale manutenzione in background, non un errore.
- In attesa → Duplicato — l'evento viene sostituito o segnalato; i motivi sono di seguito.
Perché un evento diventa Duplicato
Il pannello dei dettagli del registro mostra il motivo specifico di ogni duplicato:
- Sostituito da un referral più recente — lo stesso visitatore è stato ri-attribuito prima di convertire. Il caso più comune: il visitatore è arrivato tramite il link del partner A, poi ha usato il codice promozionale del partner B al momento del pagamento. Il codice vince (è il tocco più recente e più esplicito), l'evento basato sul clic viene contrassegnato come duplicato, e il pannello dei dettagli dell'evento vincente mostra entrambe le parti — quale partner ha vinto e quale è stato scavalcato, con le relative marche temporali.
- Autoreferral rilevato — il rilevamento delle frodi ha fatto corrispondere l'identità del cliente a quella del partner stesso; l'evento viene accantonato e non viene creata alcuna commissione.
Un caso correlato non tocca mai gli stati di attribuzione: una conversione che arriva con un external_transaction_id già elaborato viene rifiutata come conversione duplicata a livello di conversione. L'evento di attribuzione mantiene il suo stato; il rifiuto viene comunque registrato nel registro con una propria spiegazione.
Segnali di frode nel registro
Gli eventi toccati dal rilevamento delle frodi hanno un indicatore distinto nel registro, e il pannello dei dettagli spiega la regola che è scattata (autoreferral, conversione duplicata) insieme all'azione intrapresa. I partner vedono solo una nota semplificata ("Questa conversione è stata segnalata per la revisione") — il dettaglio tecnico resta lato commerciante.
Quando qualcosa sembra sbagliato
Se manca una conversione che ti aspettavi, o un evento è scaduto quando ti aspettavi una conversione, consulta Risoluzione dei problemi — copre lo snippet, gli ID clic e l'API di conversione dall'inizio alla fine.