Documentation

Getting started with DataBloom

Install DataBloom on your website in under 2 minutes. No cookies, no consent banners, no complex configuration.

Quick start

1

Create your account

Sign up for StackBloom and purchase a DataBloom plan. Head to your analytics dashboard to get started.

2

Add your website

Click "Add Site" in your dashboard. Enter your website domain (e.g., example.com). DataBloom will generate a unique tracking ID for your site.

3

Install the tracking script

Copy the script tag and paste it into the <head> section of every page you want to track. The script is under 1KB and loads asynchronously — it won't slow down your site.

4

Verify installation

Visit your website in a new browser tab. Go back to your DataBloom dashboard — you should see a real-time visitor appear within seconds.

Tracking script

Add this script to the <head> section of your website. Replace YOUR_SITE_ID with the ID from your dashboard.

<script
  defer
  data-site="YOUR_SITE_ID"
  src="https://cdn.stackbloom.io/db.js"
></script>
Under 1KB gzipped • Async loading • No render-blocking • No cookies

Platform installation guides

WordPress

Go to Appearance → Theme File Editor → header.php. Paste the script tag just before the closing </head> tag. Alternatively, use a plugin like "Insert Headers and Footers" to add it without editing theme files.

Shopify

Go to Online Store → Themes → Actions → Edit Code. Open the theme.liquid file and paste the script tag in the <head> section.

Webflow

Go to Project Settings → Custom Code. Paste the script tag in the "Head Code" field. Publish your site to apply the changes.

Next.js / React

Add the script tag to your root layout file (app/layout.tsx) inside the <head> component, or use next/script with strategy="afterInteractive".

Static HTML

Paste the script tag directly into the <head> section of each HTML page, or into a shared header template if you use one.

Google Tag Manager

Create a new Custom HTML tag. Paste the script tag as the HTML content. Set the trigger to "All Pages" and publish.

Features reference

Traffic sources

DataBloom automatically detects whether visitors come from search engines, social media, direct visits, or referral links. UTM parameters (utm_source, utm_medium, utm_campaign) are tracked automatically.

Goal tracking

Set up goals based on pageview destinations (e.g., /thank-you) or custom events. Track conversion rates and see which traffic sources drive the most conversions. Available on Pro and Business plans.

Custom events

Track custom events from your JavaScript code. Call window.databloom.track("event_name") to record an event. Use this for button clicks, form submissions, or any user action you want to measure.

Privacy & compliance

DataBloom uses no cookies and collects no personally identifiable information. IP addresses are anonymized. You are fully GDPR, CCPA, and PECR compliant out of the box — no consent banner needed.

Custom events API

Track custom events from your JavaScript code. Available on Pro and Business plans.

// Track a custom event
window.databloom.track("signup_clicked");

// Track with metadata (Business plan)
window.databloom.track("purchase", {
  value: 49.99,
  currency: "USD"
});

REST API (Business Plan)

Access your analytics data programmatically. Generate an API key from your dashboard settings.

// GET /api/analytics/sites/:id/stats
// Returns pageview and visitor data for a date range

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://stackbloom.io/api/analytics/sites/SITE_ID/stats?from=2026-01-01&to=2026-01-31"

// Response
{
  "pageviews": 12450,
  "visitors": 3210,
  "bounce_rate": 42.5,
  "avg_duration": 185,
  "top_pages": [
    { "path": "/", "views": 4200 },
    { "path": "/pricing", "views": 1850 }
  ]
}

Need Help?

Can't find what you're looking for? Reach out to our support team.