Changelog

New features

• Source verification redesign — Source setup now verifies browser events and agent events independently, with separate verified timestamps. A "Check hostname" button performs a live DNS/TLS probe of the collection hostname and reports pending or ready status. A "Check incoming data" button shows granular feedback, such as "Browser events: verified (42 observed)."
• Reactivate archived sources — Archived sources can now be restored from the Sources page without losing their identifier or historical analytics data.

Updates

• UUID-based identifiers — Tenant and source identifiers throughout the dashboard, API, and tracker are now UUIDs exclusively. Legacy slug and key fields have been removed from the dashboard UI, and source and tenant IDs are displayed as UUIDs throughout.
• Source deletion is now archiving — Removing a source now archives it instead of permanently deleting it, preserving its data. The button and confirmation dialog have been updated to reflect this.
• Domain validation for sources — Source domain input now validates and normalizes the domain, rejecting schemes, ports, paths, and IP addresses.
• Setup page improvements — Sources without a valid domain now show a configuration prompt instead of broken snippets. The collection hostname readiness status is shown inline. Setup steps are now split into Next.js 16 and Next.js 15 variants.

New features

• Acquisition traffic distribution table — The Acquisition report now includes a full-featured traffic distribution table with group-by (Source, Medium, or Campaign), expandable tree rows, column visibility controls, pagination, and sortable columns. An AI Focus toggle filters the table to AI crawler traffic, and a report type selector switches between Ecommerce and Leads column profiles.

Updates

• Traffic breakdown chart improvements — The traffic breakdown chart is now an unstacked area chart for clearer individual channel trends, and supports configurable time intervals (minute, hour, day, week, or month) instead of a fixed daily view.
• Unknown traffic values grouped as Direct — Channel and campaign values that are blank or labeled "unknown" or "not set" are now grouped and displayed as Direct in the traffic breakdown chart instead of appearing as a separate ambiguous series.
• Consistent channel labels — Traffic channel names in the Acquisition report now use uniform Title Case throughout charts, legends, and tooltips.
• Cleaner acquisition configuration panel — Option descriptions are now shown via tooltip icons instead of inline text, and the informational banner has been removed. The configuration summary no longer appends conversion event names, reducing visual clutter.
• Score card hover behavior — Non-clickable metric cards no longer show a hover lift effect that suggested they were interactive.

Bug fixes

• Chart annotation position — The annotation overlay on the traffic breakdown chart now extends correctly to the bottom of the chart content area instead of being cut off.
• Pagination resets on filter changes — Applying report filters or changing the timeframe on the Acquisition report now resets pagination to the first page.

Updates

• Traffic breakdown chart rebuilt — The acquisition report's traffic breakdown chart now uses an unstacked area visualization with a channels/campaigns toggle in the chart header. Channel labels display in Title Case (e.g., "Organic Search" instead of "organic search"), and unknown or (not set) traffic is grouped under Direct. The chart automatically uses hourly granularity for same-day ranges and daily granularity for all other date ranges.
• Interactive chart legend and tooltips — Charts across the dashboard now feature an interactive legend where you can click any series to hide or show it. Tooltips include color markers and aligned values, and series colors remain stable when toggling individual series on or off. Chart grid lines use a subtle dashed pattern.

Updates

• Acquisition report configuration dialog — The acquisition report's inline dropdowns for attribution model, lookback window, and scope have been replaced by a single Configuration button that opens a modal dialog. You can now select one or more conversion events to narrow the report to specific actions, and all attribution settings are saved per workspace. A summary badge shows the active configuration at a glance.

Updates

• Stable tracking identifier — The tracker setup snippet now uses a permanent identifier that stays the same even if you change your tenant URL, so tracking continues to work without reinstalling the tracker. The account page now shows the tracking ID and the editable tenant URL as separate fields for clarity.

New features

• Acquisition report — A new report page analyzes traffic by channel with configurable attribution models (Last touch, First touch, and Last non-direct touch), 7-, 14-, or 30-day attribution windows, and Consented only, Anonymous only, or Mixed scope filters. It includes score cards for visitors, sessions, conversions, and session duration, plus traffic breakdown and distribution views.

Updates

• Stronger privacy for anonymous visitors — GeoIP lookup is skipped when visitors have not granted consent, so IP-derived country data is not stored for anonymous sessions.
• Animated page report expansion — Rows in the AI Visibility page report animate smoothly when expanded to reveal per-agent details and respect reduced-motion preferences.
• AI Focus toggle tooltip — The AI Focus toggle now explains on hover that it filters the report to AI-related data.
• Clearer score card tooltips — Tooltip descriptions across Overview and AI Visibility are shorter and more accurate, including the use of median session duration.
• Cleaner Overview panels — “View more” links have been removed from Overview panels for a more focused layout.

Bug fixes

• Unknown countries labeled as “Anonymous” — The Location table now shows “Anonymous” when country data is unavailable, matching the existing treatment for unknown cities.

Updates

• Unified AI Visibility filtering — All AI Visibility filters are now consolidated in the global toolbar Filters button, replacing the per-table filter popover. Filter by agent type, agent name, agent platform, agent category, and page path — all in one place. Filter options update contextually based on active filters, and selections are saved in the URL for easy sharing.
• More accurate Page Report data — The Page Report table now pulls aggregate visit counts from a dedicated API instead of counting raw event rows, giving more accurate AI vs. non-AI visit totals and per-agent share percentages.
• Additional traffic channel icons — Nine new icons have been added for shopping, cross-network, affiliates, SMS, mobile push, and audio channels, completing the channel icon set.

Bug fixes

• Sticky overview toolbar — Fixed a bug where scrolling on the Overview page caused the top metric bar to duplicate. The toolbar is now sticky and stays in place while browsing.
• Live stats reset on scope change — The real-time activity strip now correctly resets when switching tenants or sources, preventing stale visitor and session counts from the previous scope.
• Per-panel error handling in AI Visibility — Each AI Visibility panel now handles data errors independently, showing a fallback message for the failed panel instead of crashing the entire report.

New features

• Interactive page-path visits chart — The Pages tab now includes an interactive area chart where you can select up to 8 page paths to compare side by side. A custom hover tooltip shows visit counts for all selected paths at each date point, sorted by volume. The top 5 paths by traffic are pre-selected by default.
• Searchable page report table — The page report table now has a search box and a structured filter popover (by agent type, platform, category, and top agent). Each page row expands to reveal a per-agent breakdown showing type, platform, category, visits, and share.

Updates

• Pages tab score cards with comparison deltas — Score cards on the Pages tab now show period-over-period change indicators. The Pages Covered card displays the absolute change (e.g., "+6 pages") instead of a static label.

Bug fixes

• Page-path graph respects AI Focus — The page-path visits chart now correctly filters to non-AI agents when the AI Focus toggle is off, instead of showing mixed data.
• Stale event workers auto-replaced — Background workers that stop processing events after a rebalance are now detected and automatically replaced, preventing silent gaps in event ingestion.

Updates

• AI Agent Visits chart upgrade — The stacked bar chart now sorts segments by volume so the largest agent sits at the bottom of each date's stack. A custom legend with agent platform icons lets you toggle individual agents on and off, and tooltips show the matching platform icon when hovering a segment.
• Agent category badges — "Service Bot" and "Uncategorized" agent categories now have distinct badge colors with improved contrast in dark mode.
• Human-readable channel names — Traffic channel names throughout the dashboard now display as readable words (e.g., "Mobile Push Notifications") instead of raw identifiers like "MobilePushNotifications".
• AI Visibility tab navigation — Switching between the Agents and Pages tabs now updates the URL, so the active tab is preserved on refresh and can be shared as a direct link. Tabs switch instantly with loading skeletons that match the selected tab's layout.

Bug fixes

• AI Visits score card stable across toggle — The AI Visits score card was incorrectly affected by the AI Focus toggle. It now always shows the total AI agent count regardless of toggle state, consistent with the "Always AI" badge.
• Blank chart edges removed — Stacked bar and area charts no longer show empty padding gaps at the left and right edges of the X-axis.

New features

• AI Visibility dashboard — The AI Visibility report now includes score cards for agent visits, platforms, and categories; a stacked bar chart with group-by (agent name, platform, or category); distribution donut cards for top agents, platforms, and categories; and a refreshable last events panel with rich detail columns.
• AI Focus toggle — Switch between AI-only and non-AI agent data in the AI Visibility dashboard. Charts, score cards, and the events panel all respond to the toggle, while fixed columns always show the full traffic split.
• Funnel reports — Create and analyze funnels with 2–5 ordered steps and up to 2 breakdown dimensions. Preview funnels ad-hoc, save them for reuse, and browse event and page options with autocomplete.

Updates

• Channel attribution reclassified — Traffic without recognizable UTM parameters is now classified as Direct instead of Unassigned. Source and medium values previously stored as "(not set)" are normalized to empty strings.

Bug fixes

• Chart color alignment — Colors between stacked bar charts and matching donut cards are now consistent, so the same agent or platform appears in the same color across both.
• AI Visibility crash on load — Fixed a crash that occurred when the AI Visibility page first loaded.
• Stacked chart Y-axis scaling — Y-axis maximum values are now calculated correctly for stacked series, preventing misleading scale displays.

New features

• Real-time activity strip. The overview now shows live visitor, session, and event counts from the last 30 minutes. Stats auto-refresh every 30 seconds with smooth count-up animations, and pause when the browser tab is hidden.

Updates

• Bounce Rate card on overview. The Events score card has been replaced with a Bounce Rate card, showing the share of sessions that ended after a single page view without further interaction.
• Expanded location and traffic source tables. Row limits removed on the overview's Location and Traffic Sources tables, so all available rows are now visible.
• Refreshed icon system. Browser, operating system, device, country flag, and traffic channel icons have been rebuilt with proper brand assets for a cleaner visual experience.
• Immediate first page view. The tracker now sends the initial page view as soon as it loads instead of waiting for the full page to load, reducing missed page views on slow or quickly abandoned pages.
• Blank user-agent requests blocked. Requests with a missing or empty User-Agent header are now classified as bot traffic and excluded from reports.
• Organization switcher feedback. Switching organizations now shows a clear loading indicator during the transition.

Bug fixes

• Direct traffic in Overview. Visits without UTM tags are now correctly included in channel and source breakdowns instead of being omitted.
• Consent rate calculation fixed. Consent rate now measures identified sessions against all sessions instead of relying on consent event counts, giving a more accurate metric.
• Duplicate page paths merged. The Top Pages treemap normalizes trailing slashes and query strings, so the same page no longer appears as multiple entries.
• Turkish city names corrected. City names for Turkish locations now show the province (e.g., "İstanbul") instead of district-level names.
• Country code captured for all visitors. Geo country data is now recorded even when consent is denied, since country-level data is not personally identifiable.
• Unknown cities relabeled. Cities without geographic data now display "Anonymous" instead of "(unknown)" in the Location table.

New features

• Redesigned overview score cards. Metric cards now show period-over-period comparisons with directional change indicators, skeleton loaders, and accessible tooltips.
• Rebuilt report filters. Filters are now grouped by dimension with multi-select value pickers, active filter chips, and a built-in source switcher.
• Source management actions. Sources can be edited and deleted directly from the Dashboard, with confirmation dialogs and permission-based access control.
• Compact sticky header. Page headers transition to a compact toolbar on scroll, keeping filters and timeframe controls visible while browsing reports.
• Asynchronous agent event collection. Agent event ingestion now processes events in the background and returns immediately, extending the async model used for standard events.

Updates

• Session duration now uses median. Duration metrics exclude sessions under 5 seconds and report the median instead of the average, giving a more accurate picture of engagement.
• Sessions API response format. Response fields were standardized to camelCase for consistency across all Sessions endpoints.
• Navigation and sidebar restructure. Sidebar sections were reorganized for clearer grouping, and the tenant list now scrolls when long.
• Typography refresh. Headings and numeric values use refined font families across the Dashboard.
• Cleaner API responses. Unknown dimension values are returned as empty strings instead of (unknown), and the AI traffic channel key is standardized.

Bug fixes

• Source registry cache reliability. Corrupt or malformed cache entries are now detected and cleaned automatically, preventing stale source data from affecting event validation.
• Structured API error responses. Unhandled API errors now return consistent JSON error envelopes instead of ambiguous failures.

New features

• Guided onboarding flow. New workspaces now have a clearer path into tenant selection and setup, so teams can get from account access to first implementation steps with less back-and-forth.

Bug fixes

• Logout reliability. Signing out now clears the active session more consistently and avoids stale account state after logout.

New features

• AI Visibility report design. The Dashboard now has a dedicated AI Visibility experience for reviewing automated visits, agent activity, and the pages those agents request.
• Tenant selection and setup page. The Dashboard now gives users a clearer setup entry point after choosing a workspace.
• Overview filters. Overview metrics now support dynamic filters, acquisition breakdowns, and previous-period scorecard values.

Updates

• AI Visibility comparison values. Agent activity overview metrics now include previous-period values, making trend changes easier to read.
• Source selection is more flexible. Overview and AI Visibility queries no longer require a source ID for every request.
• Event API request context. Direct event requests use the Tenant ID header, with optional session and consent headers.
• Source validation for event collection. Event ingestion now validates source registry data before accepting traffic.

Bug fixes

• The Dashboard now handles unavailable API responses without crashing.
• Unknown sources and channels are excluded from overview breakdowns, keeping report totals cleaner.
• Worker deployment and browser tab metadata issues were fixed.

New features

• Asynchronous event ingestion. Event collection now accepts incoming events quickly and processes them in the background, improving reliability for high-volume websites and applications.
• Batch event publishing. Batched events can now be published to the event bus for downstream processing.
• Parameter uniqueness validation. Event parameters now have stronger validation so duplicate natural keys are caught earlier.

Updates

• Configurable rate limits. Rate limit values can now be adjusted through environment configuration.
• Ingestion logging cleanup. High-volume enqueue logs now use debug-level logging, keeping production logs easier to scan.
• Kafka timeout tuning. Event pipeline timeouts were tuned for more predictable delivery behavior under load.

New features

• Leads data storage. Hardal now stores lead-related event data for reporting and standard event analysis.
• Items data storage. Item-level ecommerce data is stored in the event warehouse for commerce reporting.

Bug fixes

• Missing table creation paths were fixed for new tenants.
• ClickHouse errors now return clearer server errors instead of ambiguous failures.
• Error middleware messages were corrected so API failures are easier to diagnose.

New features

• AI Visibility analytics. New analytics endpoints power AI Visibility metrics, recent agent events, and time-range based inspection in the Dashboard.

Updates

• AI Visibility query logic was consolidated for more consistent pagination, time ranges, and metric descriptions.
• Agent activity routes were renamed and clarified so the Dashboard can request overview metrics and recent events more predictably.

Updates

• Server-side AI Visibility collection. Agent event collection now supports stricter request validation using IP and user-agent context.
• Expanded AI agent classification. Detection logic now uses crawler and agent signals to classify AI agents more accurately.
• Safer external data handling. HTTP fetches used by agent classification now have response-size limits and safer pattern checks.

New features

• Bot event storage model. Automated traffic is now stored in a dedicated event model, giving AI Visibility reporting a stable source for bot and crawler activity.

Updates

• Agent event requests now use a clearer POST-based collection path.
• Agent categories and types were moved into stricter models, improving consistency for downstream reports.
• IP and user-agent validation were split into clearer request checks.

Updates

• Richer destination activity. Delivery traces now include event IDs, source labels, raw event names, event parameters, and grouped destination details.
• Custom destination names. Destinations can carry a display name, making delivery activity easier to read in the Dashboard.
• Outbound event name mapping. Events sent to destinations now resolve platform-specific event names more consistently.

Updates

• Event IDs in activity rows. Delivery traces now retain the original event ID, making it easier to connect a Dashboard row to the source event.
• Web and mobile source labels. Delivery traces now include source information so teams can distinguish traffic origin while debugging destination delivery.

New features

• More destination coverage. Hardal added support work for Google Analytics, LinkedIn, Meta, Pinterest, Reddit, Snapchat, Spotify, TikTok, X, and custom webhooks.
• Standardized outbound event mapping. Events are mapped into destination-specific names for more consistent reporting and delivery.
• User match verification logging. Destination processing now records whether usable user match signals are present before delivery.

Updates

• Custom webhook configuration. Webhook destinations can now store URL, method, headers, and type-specific configuration.
• TikTok, Reddit, Pinterest, and Snapchat matching improvements. User identifiers, click IDs, phone normalization, locale, and hashing behavior were improved across supported destinations.
• Batch processing controls. Destination processing can consume messages in larger chunks and process partitions concurrently for higher throughput.
• Structured delivery errors. Destination processors now return clearer skip and validation reasons when an event cannot be delivered.

New features

• Custom HTTP destinations. Destination configuration now supports webhook-style delivery with type-specific credentials.

Updates

• Destination API responses now expose type-specific configuration in a more consistent shape.
• Request and response logging can be tuned so health-check traffic does not add unnecessary noise.

New features

• Tenant-aware event storage. Hardal introduced tenant-specific event warehouse setup so each workspace can collect and query its own event data.

Updates

• Request handling now extracts tenant, IP, and user-agent context earlier in the ingestion path.
• Timestamp formatting and database setup paths were tightened for more reliable event storage.

New features

• Expanded destination validation. Event payloads can now be validated for Meta, TikTok, Pinterest, Snapchat, Reddit, and Google Analytics style destinations before delivery.

Updates

• Meta test-event handling and API request formatting were improved.
• Destination topic routing was expanded for more supported platforms.

New features

• Event pipeline foundation. Hardal introduced a new event pipeline for receiving events, publishing them to processing queues, and consuming them for destination delivery.

Updates

• The pipeline gained topic management, message retrieval, graceful startup and shutdown handling, and deployment automation.
• Consumer performance settings were added so processing can be tuned as event volume grows.