Quickstart: Web (snippet)
Add FounderHQ to any website with one script tag.
Add two script tags and see your first event in FounderHQ. About 2 minutes.
Before you start
You need a FounderHQ account and a publishable key. In the app, open Sequences → Settings → Event API keys, create a key for Browser/mobile, and copy it. The full key is shown only once.
Use this page when you can edit your site's HTML. If you build with npm, use Quickstart: Web (npm) instead.
Load the SDK
Paste this into your <head>, on every page you want to measure.
<script src="https://i.getfounderhq.com/events.js"></script>
<script>
founderhq.init("fhq_pk_XXXX");
</script>The script defines a global called founderhq. It also defines
FounderHQEvents, and FounderHQEvents.founderhq is the same object.
From here on, pageviews, page leaves, sessions, clicks, rage clicks, dead clicks, outbound clicks, scroll depth, and Core Web Vitals are captured for you.
Identify the person when they sign in
Call identify with your own user ID after a sign-in or sign-up.
<script>
founderhq.identify("user_8421", {
email: "jane@acme.com",
plan: "pro",
});
</script>FounderHQ merges the visitor's anonymous history into that contact.
Capture your first event
Capture a fact that matters to your business.
<script>
founderhq.capture("trial.started", { plan: "pro" });
</script>Use lowercase names you will still understand in six months. Event
names that start with $ are reserved.
Verify
- Load a page on your site and click the button that fires the event.
- In FounderHQ, open Sequences → Events.
- You see
trial.startedwithplan: pro, plus a$pageviewfor the page you loaded. - Open Sequences → Contacts. Jane is there with her email.
Events can take a few seconds to appear. The SDK batches them.
Troubleshoot
Nothing appears in Events
Open your browser console. If requests to /i/v2/e fail with a 401 or
403, the key is wrong or your site's origin is not allowed. Check the
key you pasted, and check Allowed origins on the key in
Sequences → Settings → Event API keys.
The person shows as a guest
identify must run after the person signs in, with a stable ID from
your database. Do not pass an email as the ID. See
Identity and contacts.
You see no bot traffic
That is deliberate. FounderHQ keeps crawler visits out of your metrics and your bill. See Bot traffic policy.