Circle
Add Rybbit analytics to your Circle community
Circle has a Code snippets setting that injects custom code into the <head> of every page in your community, so the snippet goes there once and covers public pages and logged-in member pages alike.
Custom CSS/JavaScript snippets are included on all current Circle plans (Professional, Business and Circle Plus).
Get your tracking snippet
In your Rybbit dashboard, open Site Settings → Tracking Script and copy your snippet. It looks like this:
<script src="https://app.rybbit.io/api/script.js?siteId=YOUR_SITE_ID" defer></script>YOUR_SITE_ID is the numeric ID of your site. If you self-host Rybbit, app.rybbit.io is the domain of your own instance.
Add the snippet to Circle
- Open your community as an admin and go to Settings.
- Open Code snippets.
- Paste the snippet into the Head code snippets field.
- Click Save. Changes apply to the whole community immediately; there is no publish step.
Circle's own help article for this setting is Custom code snippets.
Circle is a single-page app: after the first load, navigating between spaces, posts and courses changes the URL without a full reload. The script tracks these client-side route changes automatically, so each space and post shows up as its own pageview.
Verify installation
Open your live site in a new tab and click through a few pages. Within a few seconds the pageviews appear in the Rybbit dashboard.
If nothing shows up:
- View the page source and search for
script.js?siteId=to confirm the snippet is on the page. - Open the browser Network tab and check that
script.jsreturns200and thatPOSTrequests go to/api/track. - Disable ad blockers, or set up a proxy so the script loads from your own domain.
- See the script troubleshooting guide for other common causes.
Troubleshooting
- Custom domain: the same head code is served on
yourcommunity.circle.soand on your custom domain. If both hostnames are in use, keep them under one site in Rybbit so sessions are not split. - Post embeds: custom HTML embedded inside a post is scoped to that post. Put the snippet in head code snippets, not in a post.
- Nothing tracked while logged in as admin: Circle applies head code to admins too, so check that your own IP or user is not excluded in Rybbit's site settings before assuming the snippet is missing.
Next steps
- Track custom events such as signups, purchases and button clicks.
- Identify users to connect sessions to accounts.
- Proxy the script through your own domain to bypass ad blockers.
- Script attributes let you skip or mask URLs and tag events.