ISMS Copilot Docs

PromoteKit Affiliate Tracking & Consentimento

ISMS Copilot utilizza PromoteKit per tracciare i referral degli affiliati. Quando visiti un link di affiliazione, vedrai un banner di consenso che chiede di abilitare il tracciamento.…

ISMS Copilot utilizza PromoteKit per tracciare i referral degli affiliati. Quando visiti un link di affiliazione, vedrai un banner di consenso che chiede di abilitare il tracciamento. Accettare il banner garantisce che il tuo referral venga applicato quando esegui l'upgrade a un piano a pagamento.

I link di affiliazione utilizzano il formato https://ismscopilot.promotekit.com/?via=partner-slug. Quando ne clicchi uno:

  1. Il parametro via (slug del partner) viene catturato e memorizzato temporaneamente nella sessione del browser.
  2. Un banner di consenso appare nella parte inferiore della pagina chiedendo il permesso di abilitare il tracciamento.
  3. Se clicchi "Accetta", PromoteKit imposta un cookie di tracciamento (promotekit_referral) valido per 60 giorni.
  4. Se clicchi "No grazie", non avviene alcun tracciamento e il referral non verrà applicato.

Devi accettare il banner di consenso affinché il referral venga registrato. Declinare o ignorare il banner significa che l'affiliato non riceverà credito per il tuo upgrade.

Il banner di consenso

Il banner visualizza: "Questo link di affiliazione utilizza un cookie di tracciamento (60 giorni)."

Lo vedrai nelle pagine autenticate (dashboard, chat threads) se sei arrivato tramite un link di affiliazione e non hai ancora effettuato una scelta di consenso. Il banner rimane fino a quando non clicchi "Accetta" o "No grazie".

  • Accetta: Carica lo script di tracciamento di PromoteKit e memorizza un cookie con lo slug dell'affiliato per 60 giorni.
  • No grazie: Blocca completamente il tracciamento. La tua scelta di consenso viene salvata localmente; il banner non riapparirà per questo link di affiliazione.

Il banner appare solo se hai effettuato l'accesso e navighi nelle route autenticate. Se non hai effettuato l'accesso, il parametro di referral viene catturato ma il banner di consenso non verrà visualizzato fino a quando non esegui il login.

Come i referral vengono passati a Stripe

Quando clicchi "Upgrade" dalla navigazione superiore o dalla finestra di dialogo delle impostazioni, ISMS Copilot recupera lo slug dell'affiliato memorizzato e lo include nella sessione di Stripe Checkout. Ecco il flusso:

  1. Clicchi "Upgrade" per avviare il checkout.
  2. L'app legge il cookie promotekit_referral o la variabile del browser.
  3. Lo slug del referral viene inviato a Stripe Checkout come parte dei metadati della sessione.
  4. PromoteKit riceve i dati del referral al completamento della transazione, accreditando l'affiliato.

Questo avviene automaticamente—non è necessaria alcuna azione oltre all'accettazione iniziale del banner di consenso.

I dati del referral persistono per 60 giorni. Se accetti il tracciamento oggi e esegui l'upgrade tre settimane dopo, l'affiliato riceverà comunque il credito.

Il tracciamento di PromoteKit memorizza i seguenti dati nel tuo browser:

  • Cookie (promotekit_referral): Contiene solo lo slug dell'affiliato. Scade dopo 60 giorni.
  • Session storage (ismscopilot_promotekit_via): Memorizzazione temporanea del parametro via, cancellato quando chiudi la scheda.
  • Local storage (ismscopilot_promotekit_consent): Registra la tua scelta di consenso ('accepted' o 'declined'). Persiste tra le sessioni.

ISMS Copilot rispetta i requisiti GDPR richiedendo il consenso esplicito prima di impostare i cookie di tracciamento. Nessun dato degli affiliati viene utilizzato per addestrare modelli di AI o condiviso oltre PromoteKit e Stripe per l'attribuzione delle transazioni.

Verifica che un referral sia applicato

Non esiste un indicatore in-app che mostri un referral attivo. Per confermare che il tracciamento funzioni:

  1. Apri gli strumenti per sviluppatori del browser (F12 o clic destro → Ispeziona).
  2. Vai alla scheda Application (Chrome/Edge) o Storage (Firefox).
  3. Sotto Cookies, trova il dominio e controlla la presenza di un cookie promotekit_referral.
  4. Il valore del cookie dovrebbe corrispondere al parametro via del link di affiliazione.

Se il cookie esiste e corrisponde allo slug dell'affiliato, il referral verrà applicato quando esegui l'upgrade.

Gli affiliati possono verificare i referral andati a buon fine nel loro dashboard di PromoteKit su ismscopilot.promotekit.com dopo il completamento di una transazione.

Risoluzione dei problemi

Se il tuo referral non viene applicato o il checkout fallisce, controlla questi problemi comuni:

Il banner di consenso non appare

  • Non hai effettuato l'accesso: Il banner viene visualizzato solo nelle route autenticate. Effettua l'accesso, poi rivisita il link di affiliazione o aggiorna la pagina.
  • Hai già declinato: La tua precedente scelta "No grazie" è salvata. Cancella il local storage del sito per resettare il consenso.
  • **Nessun parametro via: Assicurati che il link di affiliazione includa ?via=partner-slug. Gli URL puliti (senza il parametro) non attivano il tracciamento.

Referral non applicato al checkout

  • Consenso declinato: Se hai cliccato "No grazie", nessun cookie viene impostato. Rivisita il link di affiliazione e clicca "Accetta".
  • Cookie scaduto: Il cookie promotekit_referral dura 60 giorni. Se hai aspettato più a lungo, il referral è perso.
  • Cookie cancellati: Le modalità privacy del browser o la cancellazione dei cookie rimuovono il referral. Rivisita il link di affiliazione.

Errori di checkout

  • "Effettua l'accesso per eseguire l'upgrade": Non sei autenticato. Effettua l'accesso e riprova.
  • "Impossibile avviare il processo di checkout": Problema di connessione con Stripe. Aggiorna la pagina e riprova, o contatta l'assistenza se il problema persiste.
  • "Pagamento non completato con successo": Il checkout è stato annullato o fallito. Controlla il metodo di pagamento e riprova.

Se lo script di PromoteKit non riesce a caricarsi (problema di rete, ad blocker), il tracciamento non funzionerà. Controlla la console del browser per errori, disabilita temporaneamente gli ad blocker e rivisita il link di affiliazione.

Articoli correlati

In questa pagina