# Collegare Shopify

> Collegare un negozio Shopify a DataFirefly Server-Side: webhook Order payment firmato, signing secret, pixel DataFirefly per la navigazione.

- Pagina originale: https://server-side.datafirefly.com/it/docs/shopify.html
- Lingua: it
- Aggiornato il: 2026-09-01
- Editore: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/it/

---

Nessun modulo da installare: Shopify invia gli ordini tramite webhook firmati, e il pixel DataFirefly copre la navigazione.

## 1. Creare il webhook degli ordini

1. Admin Shopify: **Impostazioni > Notifiche**, poi **Webhook**.
2. Fai clic su **Crea webhook**, scegli l'evento **Order payment** e il formato JSON, verso:  
   `https://serverside.datafirefly.com/v1/shopify/TUO-SITE-ID`  
   sostituendo `TUO-SITE-ID` con il Site ID esatto della [pagina del tuo sito](https://server-side.datafirefly.com/it/docs/connect-your-site.html).
3. Consigliato: aggiungi anche **Refund creation** per trasmettere i rimborsi. **Checkout creation** e **Cart creation** sono utili solo finché il pixel DataFirefly non è installato.

Assicurati di scegliere **Order payment**, mai **Order creation**: quest’ultimo si attiva anche per ordini non pagati e provoca un doppio conteggio.

## 2. Incollare il signing secret

1. In fondo alla pagina Webhook, Shopify mostra il **signing secret**: copialo.
2. Incollalo nel campo **"Shopify webhook signing secret"** della pagina del tuo sito DataFirefly, poi salva.

## 3. Installare il pixel DataFirefly

1. Admin Shopify: **Impostazioni > Eventi dei clienti**, poi aggiungi un pixel personalizzato.
2. Incolla lo snippet fornito nella guida Shopify della tua area clienti (pagina [**Modules**](https://admin.datafirefly.com/app/connectors)).
3. Una volta attivo il pixel, elimina i webhook Checkout creation e Cart creation: il pixel li sostituisce.

## ChatGPT Ads

L'acquisto parte dal server, tramite il webhook firmato **Order payment**. Il riferimento del clic pubblicitario (`oppref` e `obref`) è catturato dal pixel DataFirefly del passaggio 3, incollato nell'admin di Shopify (**Impostazioni > Eventi dei clienti**) e non nel tema: collega il riferimento al checkout, e il server lo associa all'acquisto. Viene catturato solo con il consenso marketing.

Se usi anche un tuo pixel OpenAI, sostituisci la sua chiamata di acquisto con il codice indicato nella guida Shopify della tua area clienti, così l'acquisto lato browser porta lo stesso event ID di quello lato server (`shopify-order-` seguito dal numero d'ordine). Altrimenti, disattiva l'evento di acquisto del tuo pixel OpenAI.

## Consenso

Il pixel DataFirefly segue il consenso marketing registrato da Shopify. Quando un visitatore rifiuta il marketing, il pixel invia gli eventi di quel visitatore a DataFirefly, contrassegnati come rifiutati, senza alcun riferimento al clic pubblicitario, e nulla viene inoltrato alle piattaforme pubblicitarie. Gli ordini, invece, arrivano tramite webhook firmati che non trasmettono alcun segnale di consenso: per questi vale la politica di consenso del tuo negozio.

## Verificare

1. Effettua un ordine di prova pagato: deve comparire come **Delivered** nel Monitoring.
2. Il pulsante **"Diagnose my connection"** conferma la ricezione degli ultimi eventi.

## In caso di problemi

- Un webhook che fallisce per circa 48 ore viene **eliminato automaticamente da Shopify**. Se il webhook è scomparso, verifica il Site ID nell’URL, ricrealo e sorveglia il Monitoring.
- Ordini duplicati? Verifica che non resti alcun webhook **Order creation**.
- Le altre cause frequenti sono elencate nella [guida alla risoluzione dei problemi](https://server-side.datafirefly.com/it/docs/troubleshooting.html).

Aggiornato: 1 settembre 2026
