Skip to main content

​
Panoramica

Per il tracciamento di affiliazione inserisci due piccoli script nel tuo tema Shopify e registri quattro webhook nel tuo admin Shopify. Non serve installare nessuna app.
Questa guida configura solo la parte tecnica nel tuo negozio. Se clic e ordini vengano effettivamente registrati dipende inoltre dal tuo contratto di affiliazione, vedi Tracciamento di affiliazione.

​
Requisiti

  • Un contratto di affiliazione attivo con ID partner, vedi Accordo di partnership. Gli URL dei webhook vengono mostrati solo quando il tuo ID partner è stato assegnato.
  • Accesso al codice del tema del tuo negozio (Negozio online → Temi → Modifica codice).
  • Accesso admin a Impostazioni → Notifiche in Shopify, per creare i webhook.

​
Configurazione

1

Aprire l'integrazione

Nella dashboard vai su Affiliazione → Integrazione, scegli in alto a destra il tuo negozio online e apri il tab Script manuale.
2

Inserire lo script cookie nell'head

Copia lo Script cookie con Copia script. In Shopify apri Negozio online → Temi → … → Modifica codice e inserisci lo script in layout/theme.liquid subito prima di </head>. Lo script contiene già i tag <script>.
3

Inserire lo script principale prima della fine del body

Copia lo Script principale e inseriscilo nello stesso file subito prima di </body>. Salva il tema.
4

Registrare il Secret Webhook

In Shopify apri Impostazioni → Notifiche → Webhook. In fondo trovi la chiave di firma con cui Shopify firma i webhook. Copiala, inseriscila nella dashboard sotto Secret Webhook Shopify e clicca su Salva secret.
5

Creare i webhook in Shopify

Nella dashboard trovi sotto Webhook Shopify quattro URL. In Shopify crea, sotto Impostazioni → Notifiche → Webhook, un webhook per ogni URL (formato JSON):Come versione API del webhook scegli la versione stabile più recente offerta da Shopify (ad esempio 2025-10 o successiva). Highcovery legge solo i campi standard dell’ordine, presenti in tutte le versioni attuali.
6

Registrare i codici sconto (opzionale)

Sotto Codici sconto puoi inserire dei codici, separati da virgole. Se un cliente usa uno di questi codici, l’ordine viene attribuito a te anche quando non è presente alcun ID clic.
7

Verificare la configurazione

Apri un deeplink dall’app Highcovery e crea con esso un ordine di prova. Comparirà nella tua pagina Affiliazione sotto Attività recente.

​
Come funziona il tracciamento

  1. Un utente clicca nell’app Highcovery sul tuo prodotto e arriva nel tuo negozio con i parametri URL hc_cid (ID clic) e hc_pid (ID partner).
  2. Lo Script cookie salva entrambi i valori come cookie per 30 giorni. Rispetta la Shopify Customer Privacy API: senza consenso al marketing non viene impostato alcun cookie.
  3. Lo Script principale scrive l’ID clic come attributo del carrello nel carrello. Così finisce nell’ordine.
  4. I webhook comunicano a Highcovery ogni ordine. Highcovery legge l’ID clic dall’ordine e genera la conversione. Se manca, interviene il fallback sui codici sconto.
  5. Anche annullamenti e rimborsi vengono comunicati e correggono la commissione.
Se cambi tema, devi inserire di nuovo entrambi gli script nel nuovo tema. I webhook restano invariati.

​
Risoluzione dei problemi

  • Nessuna conversione nonostante gli ordini – verifica che entrambi gli script si trovino nel tema attivo e che i quattro webhook in Shopify puntino agli URL corretti.
  • I webhook vengono rifiutati – il Secret Webhook nella dashboard deve corrispondere esattamente alla chiave di firma di Shopify. Salvalo di nuovo.
  • Gli ordini con codice sconto non vengono attribuiti – il codice deve essere inserito sotto Codici sconto esattamente come si chiama in Shopify.
  • Stato del tracciamento inattivo – controlla i banner di stato nella tua pagina Affiliazione. Indicano il motivo, ad esempio un metodo di pagamento mancante.
In caso di problemi scrivi a support@highcovery.com indicando il dominio del tuo negozio e il momento approssimativo dell’ordine.