Documentation
Quickstart (5 minutes)
- Sign up at /signup — no credit card required.
- After signup you receive a public key (
pk_live_) and secret key (sk_live_...).
- Add the one-line snippet to every page you want to track.
- Open your dashboard to see events, sources, funnels, and weekly AI reports.
- Install the snippet to start seeing live events within seconds.
Snippet guide
Add this line to the <head> of every page template:
<script async src="https://app.launchlens.dev/lpa-v2.js" data-project-key="pk_live_"></script>
This origin serves the production snippet.
The snippet sends page_view automatically. To track scroll depth, clicks, or signups, use the event API below.
FAQ (20 questions)
- How do I track events? Add the snippet and events are sent automatically.
- Is this cookie-free? Yes, no cookies and no fingerprinting.
- What counts as a pageview? Every page load with the snippet counts as page_view.
- How do I track scroll depth? The snippet sends scroll_25/50/75/90 events automatically.
- How do I track signups? Use event_type=signup_started via the collect API.
- Do you store PII? No, PII is rejected at ingestion.
- What is the free plan? 1 project and 10,000 events per month.
- Can I upgrade my plan? Yes, plans are Starter 9 EUR, Pro 29 EUR, Business 79 EUR.
- How do I get my API keys? They are shown immediately after signup.
- How do I reset my API key? Contact support.
- What are funnels? Funnels show where visitors drop off.
- How do I create a funnel? Go to the Funnels view in your dashboard.
- What are weekly reports? AI-generated analysis of your traffic.
- Why is my report blocked? Free plan has 0 reports; upgrade to Starter.
- How long is data kept? Aggregates are kept per billing period.
- Can I export my data? Yes, export CSV/JSON from Settings.
- What sources are tracked? Referrer, UTM campaign, source, medium.
- How do I track campaigns? Use UTM parameters in your links.
- Is the API RESTful? Yes, full API reference below.
- How do I get support? Use the contact form on /support.
API reference
POST /v1/collect - send an event. Body: project_key, event_type, url?, referrer?, utm?, ts?POST /v1/projects - create a project. Body: name, owner_email, plan?POST /v1/auth/login - login with sk_live_ key. Returns access_token.POST /v1/auth/refresh - refresh an expired access_token.GET /v1/projects/{id}/overview - overview stats.GET /v1/projects/{id}/sources - top sources.GET /v1/projects/{id}/funnels - funnels.GET /v1/projects/{id}/reports - weekly reports.GET /v1/projects/{id}/usage - usage counters.GET /v1/health - service health.
Troubleshooting
- No events? Verify the snippet is on the page and the page was loaded after installation.
- Events show in Usage but not Overview? Clear browser cache and refresh.
- Install view shows pk_... placeholder? Replace pk_... with the public key shown when you created your project.
- Report blocked? Upgrade to Starter to enable weekly reports.
- Login fails? Use the sk_live_ secret key, not the pk_live_ public key.