Connect your site

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":

ValueRole
Site IDUnique identifier of the site
HMAC secretSecret that signs every request
Events endpointhttps://serverside.datafirefly.com/v1/events
Public pixel tokenToken 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, 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

Updated: September 1, 2026