# Connect your site

> Add a site in DataFirefly Server-Side, copy the dfss\_ connection key, activate tracking and diagnose the connection.

- Original page: https://server-side.datafirefly.com/en/docs/connect-your-site.html
- Language: en
- Updated: 2026-09-02
- Publisher: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/en/

---

Each site has its connection key: a single value to paste into your store's module.

## Add a site

1. In the client area, open the **Sites** menu and click **Add a site** (owner and admin roles only).
2. One field: the site name. Your plan's site quota is checked at creation.

## The connection key

On the site page, the **"Connect your shop module"** section shows the **Connection key**, in the `dfss_...` format. It carries everything the module needs: site identifier, HMAC secret and endpoint. Click **Copy** and paste it into your platform's module.

If your integration prefers separate values, expand **"Or enter the values manually"**:

| Value | Role |
| --- | --- |
| Site ID | Unique identifier of the site |
| HMAC secret | Secret that signs every request |
| Events endpoint | `https://serverside.datafirefly.com/v1/events` |
| Public pixel token | Token for the browser channel, designed to be exposed in your pages: it only accepts browsing events and refuses purchases and refunds |

**Rotate HMAC secret** regenerates the secret: the module stops working immediately until the new key is pasted in. Use it only on a suspected leak, and update the module right away.

## Activate tracking

The **"Activate my tracking"** button stays greyed out until at least one destination is saved. Until the site is activated, the module receives a 401 response: that is expected behaviour, not an outage. Connect at least one [destination](https://server-side.datafirefly.com/en/docs/meta-capi.html), save, then activate.

## Diagnose

The **"Diagnose my connection"** button checks in one click: site active, key present, a live test of every configured destination, and the timestamp of the last event received. It is the first thing to try when something seems not to come through.

## Managing the site

- **Rename**: rename the site at any time.
- **Pause**: suspend the site, which frees one slot on your plan.
- **Delete**: only possible on a paused site, to prevent accidental deletions.

Updated: September 1, 2026
