# Embed Chipp Insights Beacon Add Chipp Insights to your website to track user presence, identify logged-in users, and monitor client-side errors. --- Add Chipp Insights to any website to track anonymous and authenticated user presence, identify logged-in users after authentication, and automatically capture client-side errors. The beacon is lightweight (~1.5KB gzipped) and designed to be invisible: it never blocks your page or logs to the console. > **Note:** **For software factory projects (end-user tracking).** This is analytics for YOUR deployed app's end-users. If you're tracking your own builder's activation at build.chipp.ai, see [Builder Analytics & Activation Tracking](/docs/guides/builder-analytics) instead. ## What is Chipp Insights? Chipp Insights helps you understand how your end-users interact with your Chipp-powered app. It automatically: - **Tracks page views**: See which pages your end-users visit and how they navigate - **Identifies users**: Link anonymous sessions to real users after login - **Captures errors**: Monitor client-side JavaScript errors in production - **Respects privacy**: Uses anonymous session IDs until you explicitly call `identify()` --- ## Where You'll See This Data There isn't a full Chipp Insights dashboard yet. Today, the data this beacon collects surfaces in these places: - **Project Usage tab** - your project's **Usage** tab shows a globe of where your end-users are, by country, over the last 7 days. - **Alchemist chat** - ask the assistant for your project's analytics. It can report event volume, unique and identified visitors, top pages, top countries, and top client-side errors. It also surfaces inside **Chipp Mail** (your team's shared inbox at email.chipp.ai), in two places: - **Contact panel**: open any email thread with someone, and if that person's email shows up in your project's telemetry, you'll see a "Chipp Insights" section on their contact profile: which of your projects they've been active on, and when they were last seen. - **Notifications feed**: new activity from a known contact (an `identify()` call on one of your projects) shows up as a notification alongside your unread mail and Slack mentions. This is a soft signal, not a verified fact (see "How It Works" below for why). Per-person activity only shows up in Chipp Mail. Aggregate numbers show up in the Usage tab and in Alchemist chat. --- ## Quick Start Add a single ` ``` The beacon automatically: 1. Creates a random, persistent session ID on first load 2. Sends a pageview ping on every page load and navigation 3. Captures uncaught JavaScript errors and promise rejections To identify a user after login, call: ```javascript chippInsights.identify("user@example.com"); ``` That's it. The beacon will include the user's email on all subsequent pageviews and errors. --- ## Getting Your Project Key **If your site was generated by Chipp (a software factory project), you don't need to do anything.** Every new software factory project ships with its own key already wired into the site's shared layout: the beacon is active out of the box, with no manual step. The plaintext key lives in your project's own repo at `chipp-insights.json` (root of the repo) if you ever need to reference it directly. **If you want to add the beacon to a different website** (one Chipp didn't generate for you, or a second site you want the same project tracked under), copy the key from the dashboard: **1.** Open your project's Usage tab In the Alchemist, open the project and click **Usage**. **2.** Find the Beacon key card Below the activity globe, the **Beacon key** card shows your `tk_pub_` key and a ready-to-paste snippet. **3.** Copy the key or the snippet Click **Copy key** or **Copy snippet**, then paste the snippet before the closing `