Configurare Shopify

Panoramica

Per il tracciamento di affiliazione registri l'indirizzo del tuo negozio, copi gli script di tracciamento nel tuo tema e crei quattro webhook nel tuo admin Shopify. Non esiste un'app per questo. La configurazione avviene interamente tramite il tuo tema e il tuo admin Shopify, e un assistente nella dashboard ti guida attraverso i quattro passaggi.

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.
• Un negozio raggiungibile pubblicamente. Finché la protezione con password è attiva, Highcovery non può verificare gli script e il tracciamento resta inattivo.

Configurazione

Nella dashboard vai su Affiliazione → Integrazione e scegli in alto a destra il tuo negozio online. Il riepilogo mostra per ogni passaggio se è completato. Con Inizia la configurazione o Continua la configurazione apri l'assistente, che salta direttamente al primo passaggio ancora aperto. I pulsanti all'interno dell'assistente ti portano alla pagina corrispondente nel tuo admin Shopify.

1. Registrare l'indirizzo del negozio

   Inserisci il tuo indirizzo Shopify nella forma ilmionegozio.myshopify.com. Da questo la dashboard costruisce i link alla tua area admin, e la verifica quotidiana sa quale negozio richiamare.

2. Inserire gli script di tracciamento

   L'assistente mostra due frammenti. Lo script principale è obbligatorio: trasmette l'ID clic al carrello ed è la base perché gli ordini vengano attribuiti a te. Lo script cookie è facoltativo ma consigliato: ricorda l'ID clic per le visite successive.

   Copia entrambi i frammenti con Copia script, apri in Shopify Negozio online → Temi → … → Modifica codice e inseriscili in layout/theme.liquid subito prima di </body>. I frammenti contengono già i tag <script>. Salva il tema e clicca nell'assistente su Verifica ora la configurazione.

3. Registrare il Secret Webhook

   In Shopify apri Impostazioni → Notifiche → Webhook. In fondo trovi la chiave di firma con cui Shopify firma i webhook. Copiala e inseriscila nell'assistente. Senza questo secret Highcovery rifiuta ogni webhook, perché non può verificarne l'autenticità.

4. Creare i webhook

   L'assistente mostra quattro URL. In Shopify, sotto Impostazioni → Notifiche → Webhook, crea un webhook per ogni URL:

   Evento Shopify	Topic	URL Highcovery
   Creazione ordine	orders/create	Webhook Ordine creato
   Pagamento ordine	orders/paid	Webhook Ordine pagato
   Annullamento ordine	orders/cancelled	Webhook Ordine annullato
   Rimborso creato	refunds/create	Webhook Ordine rimborsato

   Come formato scegli JSON e come versione API del webhook la versione stabile più recente offerta da Shopify. Highcovery legge solo i campi standard dell'ordine, presenti in tutte le versioni attuali.

   La dashboard può capire che un webhook funziona solo quando arriva il primo evento. Fino ad allora mostra Nessun evento finora. Puoi provocarlo subito, perché Shopify offre per ogni webhook una notifica di prova.

5. 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.

6. 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.

La verifica quotidiana degli script

Una volta al giorno Highcovery richiama la pagina iniziale del tuo negozio e vi cerca le firme dei due script. Il tag script contiene inoltre un'impronta nell'attributo data-hc-tracking. Da questa la dashboard riconosce quale versione dello script è in esecuzione nel tuo negozio.

Una verifica superata vale come prova per 14 giorni. Dopo conta solo il risultato dell'ultima verifica. Con Verifica ora la configurazione avvii subito un controllo, invece di aspettare il passaggio quotidiano successivo.

Se lo script manca, è obsoleto oppure il tuo negozio non può essere richiamato, ti inviamo al massimo una volta a settimana una mail al riguardo. Il nostro team riceve la stessa segnalazione. Non appena la verifica torna a essere superata, il promemoria si interrompe da sé.

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 principale scrive l'ID clic nel carrello come attributo del carrello. Così finisce nell'ordine.
3. Lo script cookie salva inoltre entrambi i valori come cookie per 30 giorni, in modo che l'attribuzione funzioni anche in una visita successiva senza ID clic. Rispetta la Shopify Customer Privacy API: senza consenso al marketing non viene impostato alcun cookie.
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.

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 prima il passaggio Inserire gli script di tracciamento nell'assistente e poi i banner di stato nella tua pagina Affiliazione. Indicano il motivo, ad esempio uno script mancante o un negozio che non siamo riusciti a raggiungere.