> ## Documentation Index
> Fetch the complete documentation index at: https://docs.highcovery.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurare Shopify

> Configurare manualmente il tracciamento di affiliazione nel tuo negozio Shopify

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

<Note>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](/it/affiliate/tracking).</Note>

### Requisiti

* Un **contratto di affiliazione** attivo con ID partner, vedi [Accordo di partnership](/it/affiliate/contract). 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

<Steps>
  <Step title="Aprire l'integrazione">
    Nella dashboard vai su **Affiliazione → Integrazione**, scegli in alto a destra il tuo negozio online e apri il tab **Script manuale**.
  </Step>

  <Step title="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>`.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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**):

    | Evento Shopify      | URL Highcovery            |
    | ------------------- | ------------------------- |
    | Creazione ordine    | Webhook Ordine creato     |
    | Pagamento ordine    | Webhook Ordine pagato     |
    | Annullamento ordine | Webhook Ordine annullato  |
    | Rimborso creato     | Webhook Ordine rimborsato |

    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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

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

<Warning>Se cambi tema, devi inserire di nuovo entrambi gli script nel nuovo tema. I webhook restano invariati.</Warning>

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

<Tip>In caso di problemi scrivi a [support@highcovery.com](mailto:support@highcovery.com) indicando il dominio del tuo negozio e il momento approssimativo dell'ordine.</Tip>