# Collegare il tuo sito

> Aggiungere un sito in DataFirefly Server-Side, copiare la chiave di connessione dfss\_, attivare il tracking e diagnosticare la connessione.

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

---

Ogni sito ha la sua chiave di connessione: un solo valore da incollare nel modulo del tuo negozio.

## Aggiungere un sito

1. Nell’area clienti, menu **Sites**, clicca **Aggiungi un sito** (riservato ai ruoli owner e admin).
2. Un solo campo: il nome del sito. La quota di siti del tuo piano viene verificata alla creazione.

## La chiave di connessione

Sulla pagina del sito, la sezione **"Connect your shop module"** mostra la **Connection key**, nel formato `dfss_...`. Contiene tutto ciò di cui il modulo ha bisogno: identificativo del sito, secret HMAC ed endpoint. Clicca **Copy** e incollala nel modulo della tua piattaforma.

Se la tua integrazione preferisce i valori separati, espandi **"Or enter the values manually"**:

| Valore | Ruolo |
| --- | --- |
| Site ID | Identificativo univoco del sito |
| HMAC secret | Secret che firma ogni invio |
| Events endpoint | `https://serverside.datafirefly.com/v1/events` |
| Public pixel token | Token del canale browser, concepito per essere esposto nelle tue pagine: accetta solo la navigazione e rifiuta acquisti e rimborsi |

**Rotate HMAC secret** rigenera il secret: il modulo smette immediatamente di funzionare finché la nuova chiave non viene incollata al suo interno. Usalo solo in caso di sospetta fuga del secret, e procedi subito dopo con l’aggiornamento del modulo.

## Attivare il tracking

Il pulsante **"Activate my tracking"** resta disattivato finché nessuna destinazione è registrata. Finché il sito non è attivato, il modulo riceve una risposta 401: è il comportamento previsto, non un guasto. Collega almeno una [destinazione](https://server-side.datafirefly.com/it/docs/meta-capi.html), salva, poi attiva.

## Diagnosticare

Il pulsante **"Diagnose my connection"** verifica in un clic: sito attivo, chiave presente, test reale di ogni destinazione configurata e data dell’ultimo evento ricevuto. È il primo controllo da fare quando qualcosa sembra non arrivare.

## Gestire il sito

- **Rename**: rinominare il sito in qualsiasi momento.
- **Pause**: sospendere il sito, il che libera uno slot del tuo piano.
- **Delete**: possibile solo su un sito in pausa, per evitare eliminazioni accidentali.

Aggiornato: 1 settembre 2026
