Signals Docs

Quickstart

Install the tag and verify your first event in five minutes.

PixelFox tracks conversions on your store with one script tag and forwards them server-side to Facebook, TikTok, Google Analytics 4 and Microsoft Clarity - with browser↔server deduplication so nothing is counted twice.

1. Create a site and get your API key

In the dashboard, click Add site. A live API key (sig_live_…) is generated automatically - copy it now, it is shown only once. If you lose it, create a new key under Settings → API keys.

2. Add the script tag

Paste this before </head> on every page (most themes have a single layout/header file):

<script
  src="https://api.pixelfox.app/signals.min.js"
  data-signals-key="sig_live_YOUR_KEY"
  data-signals-host="https://api.pixelfox.app"
  defer
></script>
  • data-signals-key - your site's API key.
  • data-signals-host - the base URL of your Signals ingest API. It can be omitted when the script is served from the same origin as the ingest API.

Using WordPress, Laravel or Next.js? There's a dedicated integration for each - see Installation.

3. Verify your first event

  1. Open your site in a browser tab (with ad-blockers off for the test).
  2. In DevTools → Network, filter for ingest - you should see a POST /v1/ingest returning {"accepted": 1} within ~10 seconds (events batch client-side).
  3. Back in the dashboard, the site overview shows a $pageview row for today within a minute.

The tag also starts auto-discovering elements (buttons, links, forms) right away - check Discovered elements after browsing a page or two.

4. Define your first conversion

Go to Event definitions and either:

  • click AI suggest - PixelFox reads your discovered elements and proposes high-value events like add_to_cart_click, or
  • click New definition and pick a trigger (click, submit, visible, pageview), a CSS selector, and an optional URL pattern.

Definitions are matched in the browser on the next page load - no code deploy needed.

5. Connect destinations

Under Destinations, add credentials for Facebook CAPI, TikTok, GA4 and Clarity. From then on every conversion event fans out server-side, deduplicated against the browser pixels PixelFox injects.

On this page