# Hardal

> Index of the Hardal documentation.

## Current

- [Welcome](https://docs.usehardal.com/welcome.md): Hardal is a server-side measurement platform that connects your first-party data from any source to any destination for websites and mobile apps.
- [Concepts overview](https://docs.usehardal.com/user-guide/concepts/overview.md): Learn what metrics mean in the current Hardal Dashboard.
- [Metrics Glossary](https://docs.usehardal.com/user-guide/metrics.md): Simple definitions for metrics across the current Hardal Analytics reports.
- [Overview](https://docs.usehardal.com/user-guide/analytics/overview.md): Monitor traffic, events, and conversions from your Hardal signal.
- [Events](https://docs.usehardal.com/user-guide/analytics/event-tracking.md): Browse and inspect every event your signal receives, with filters, timeline charts, and full payload details.
- [Sessions](https://docs.usehardal.com/user-guide/analytics/session-monitoring.md): Browse individual user sessions, view their event timelines, and inspect device, location, and traffic source details.
- [Campaigns](https://docs.usehardal.com/user-guide/analytics/campaign-attribution.md): Measure revenue and conversions by traffic source, medium, and campaign.
- [Funnel](https://docs.usehardal.com/user-guide/analytics/funnel.md): Visualise drop-off across a multi-step conversion flow and break down results by source, device, and more.
- [Items](https://docs.usehardal.com/user-guide/analytics/items-report.md): Analyse product performance — conversion sessions, items sold, and revenue — by name, SKU, brand, and category.
- [Debug a Missing Event](https://docs.usehardal.com/user-guide/analytics/how-tos/debug-events.md): Step-by-step guide to diagnosing why an event isn't showing up in your Hardal signal dashboard.
- [Set Up a Conversion Funnel](https://docs.usehardal.com/user-guide/analytics/how-tos/set-up-funnel.md): How to build a multi-step funnel in Hardal to track drop-off across your checkout or lead flow.
- [AI Visibility](https://docs.usehardal.com/user-guide/ai-visibility/overview.md): Monitor AI agents, AI search bots, LLM crawlers and classic search crawlers visiting your website.
- [Overview](https://docs.usehardal.com/user-guide/destinations/overview.md): Forward your Hardal events to ad platforms and analytics tools — server-side, in real time.
- [Meta CAPI](https://docs.usehardal.com/user-guide/destinations/meta.md): Send conversion events to Meta Conversions API from Hardal, server-side.
- [TikTok Events API](https://docs.usehardal.com/user-guide/destinations/tiktok.md): Send conversion events to TikTok Events API from Hardal, server-side.
- [Snapchat CAPI](https://docs.usehardal.com/user-guide/destinations/snapchat.md): Send conversion events to Snapchat Conversions API from Hardal, server-side.
- [Reddit CAPI](https://docs.usehardal.com/user-guide/destinations/reddit.md): Send conversion events to Reddit Conversions API from Hardal, server-side.
- [Pinterest CAPI](https://docs.usehardal.com/user-guide/destinations/pinterest.md): Send conversion events to Pinterest Conversions API from Hardal, server-side.
- [Google Analytics 4](https://docs.usehardal.com/user-guide/destinations/google-analytics.md): Send events to GA4 via Measurement Protocol from Hardal, server-side.
- [Custom Webhook](https://docs.usehardal.com/user-guide/destinations/custom-webhook.md): Forward Hardal events to any HTTPS endpoint with custom headers.
- [LinkedIn CAPI](https://docs.usehardal.com/user-guide/destinations/linkedin.md): Send conversion events to LinkedIn Conversions API from Hardal for B2B campaign optimization.
- [Spotify Conversions API](https://docs.usehardal.com/user-guide/destinations/spotify.md): Send conversion events to Spotify Ads from Hardal, server-side.
- [OpenAI Ads (ChatGPT)](https://docs.usehardal.com/user-guide/destinations/openai-ads.md): Send web conversion events to OpenAI Ads (ChatGPT) from Hardal, server-side.
- [Consent Mode](https://docs.usehardal.com/user-guide/destinations/consent-mode.md): Control when Hardal forwards events to destinations based on user consent.
- [Verify a Destination is Working](https://docs.usehardal.com/user-guide/destinations/verify-delivery.md): Confirm that a Hardal destination is successfully receiving your events.
- [Set Up Your First Destination](https://docs.usehardal.com/user-guide/destinations/x.md): A step-by-step walkthrough from zero to your first working server-side destination.
- [Custom Conditions](https://docs.usehardal.com/user-guide/destinations/x-1.md): Filter which events a Custom Webhook forwards using field-level rules.
- [Overview](https://docs.usehardal.com/user-guide/settings/overview.md): Manage your Hardal projects, signals, team members, and API credentials.
- [Signal](https://docs.usehardal.com/user-guide/settings/signal-settings.md): Configure your signal's name, currency, timezone, and tracker installation.
- [Project](https://docs.usehardal.com/user-guide/settings/project-settings.md): Update your project name and description.
- [Team](https://docs.usehardal.com/user-guide/settings/team-members.md): Invite collaborators to your project and manage their permission levels.
- [API Keys](https://docs.usehardal.com/user-guide/settings/api-key-management.md): Find your Signal ID, API key, and database password.
- [Overview](https://docs.usehardal.com/user-guide/data-export/overview.md): Access your raw Hardal data via direct database connection and BI tools.
- [Data Model](https://docs.usehardal.com/user-guide/data-export/data-model.md): Hardal's ClickHouse database schema — core raw tables and pre-aggregated analytics tables for fast querying.
- [Database Connection](https://docs.usehardal.com/user-guide/data-export/database-connection.md): Find your Hardal database host, port, username, and password so you can connect directly with any MySQL or ClickHouse-compatible tool.
- [Connect to Looker Studio](https://docs.usehardal.com/user-guide/data-export/bi-connections/looker.md): Connect Hardal analytics to Looker Studio using the MySQL connector so you can build custom dashboards and schedule automated reports
- [Connect to Hex](https://docs.usehardal.com/user-guide/data-export/bi-connections/hex.md): Set up a MySQL database connection from Hex to your Hardal project so you can query analytics data in collaborative data science notebooks
- [Connect to Tableau](https://docs.usehardal.com/user-guide/data-export/bi-connections/tableau.md): Connect your Hardal analytics data to Tableau Desktop via MySQL so you can build interactive visualizations and publish workbooks to your team
- [Connect to Power BI](https://docs.usehardal.com/user-guide/data-export/bi-connections/powerbi.md): Connect your Hardal analytics to Power BI Desktop using the MySQL connector so you can create interactive reports and share dashboards
- [FAQ](https://docs.usehardal.com/user-guide/faq.md): Common questions about Hardal — privacy-first measurement, server-side tracking, and first-party data.
- [Setup Overview](https://docs.usehardal.com/setup/overview.md): Install Hardal on web, Shopify, or mobile, configure server-side hosting, and explore report setup guides.
- [Send an Event](https://docs.usehardal.com/push/hardal.md): Send events to Hardal using the Events API.
- [Send an Agent Event](https://docs.usehardal.com/push/agent-events.md): Send AI Visibility agent events to Hardal.
- [Installation Overview](https://docs.usehardal.com/setup/installation/overview.md): Compare Hardal installation options for websites, Shopify stores, mobile apps, AI Visibility, custom domains, and self-hosted deployments.
- [Web Setup](https://docs.usehardal.com/setup/installation/web.md): Install the Hardal script on your website to auto-track page views and send e-commerce, lead generation, and custom conversion events
- [Shopify Setup](https://docs.usehardal.com/setup/installation/shopify.md): Install the Hardal Shopify app to create a Signal automatically, start tracking your store, and optionally use a first-party URL.
- [Mobile Setup](https://docs.usehardal.com/setup/installation/mobile.md): Send analytics events from your iOS or Android mobile app to Hardal using the HTTP POST API with JSON payloads and custom event fields
- [AI Visibility Setup](https://docs.usehardal.com/setup/installation/ai-visibility.md): Send request metadata to Hardal for AI agent, AI search bot, LLM crawler, and classic crawler analysis
- [Hardal MCP](https://docs.usehardal.com/mcp.md): Connect Claude or ChatGPT to query your Hardal analytics.
- [Custom Domain](https://docs.usehardal.com/setup/installation/custom-domain.md): Set up a custom CNAME so your Hardal tracking script and all event traffic runs under your own domain as first-party data.
- [Self-Hosted Deployment](https://docs.usehardal.com/setup/installation/self-hosted.md): Deploy Hardal on your own Linux server with full data ownership, covering system requirements, required ports, and network configuration
- [Campaigns Report](https://docs.usehardal.com/setup/installation/reports/campaigns.md): What the Campaigns report needs to work and how to ensure your UTM data is captured correctly.
- [Funnel Report](https://docs.usehardal.com/setup/installation/reports/funnel.md): What the Funnel report needs to work and how to track each step of your conversion journey.
- [Items Report](https://docs.usehardal.com/setup/installation/reports/items.md): What the Items report needs to work and how to structure your product data correctly.
- [Leads Report](https://docs.usehardal.com/setup/installation/reports/leads.md): What the Leads report needs to work and how to structure your lead event data.
- [Custom Views](https://docs.usehardal.com/setup/installation/reports/custom-views.md): Request a custom data view to display your Hardal analytics exactly the way you need.
- [Overview](https://docs.usehardal.com/setup/server-side/overview.md): Route events through your own server infrastructure using Server-Side Google Tag Manager, Meta CAPI, or TikTok's Events API Gateway.
- [Google Tag Manager](https://docs.usehardal.com/setup/server-side/sgtm.md): Route your analytics data through a server-side Google Tag Manager container to gain better data control and first-party data collection
- [Meta Conversions API](https://docs.usehardal.com/setup/server-side/meta-capi.md): Set up server-side Meta Pixel tracking through the Conversions API or Signals Gateway to bypass ad blockers and improve conversion data quality
- [TikTok Events API Gateway](https://docs.usehardal.com/setup/server-side/tiktok.md): Deploy the TikTok Events API Gateway on a custom domain to enable server-side conversion tracking and first-party analytics data collection
- [Google Analytics 4 - Server Tag](https://docs.usehardal.com/google-analytics-4-server-tag.md): Server GA4 Tag Setup
- [Meta CAPI Server GTM Setup](https://docs.usehardal.com/setup/server-side/sgtm-setups/meta-conversion-api-sgtm.md): Setup Meta Conversion API Server GTM Tag
- [Google Ads Server-Side](https://docs.usehardal.com/setup/server-side/sgtm-setups/google-ads.md): Learn how you can set up Google Ads server-side conversion tracking with Hardal for improved measurement accuracy and privacy compliance
- [LinkedIn CAPI](https://docs.usehardal.com/setup/server-side/sgtm-setups/linkedin-capi.md): Learn how you can configure LinkedIn Conversions API with server-side Google Tag Manager to track and attribute ad conversions accurately
- [TikTok sGTM](https://docs.usehardal.com/setup/server-side/sgtm-setups/tiktok-sgtm.md): Learn how you can send conversion data to the TikTok Events API through server-side Google Tag Manager for improved ad tracking accuracy
- [Login](https://docs.usehardal.com/api-reference/post-auth-login.md): Validate a signalId/signalToken pair and return a JWT that can be used to authorize other requests. The login token expires according to the returned ttl, expiresAt, and expiresIn fields; call this endpoint again when the token expires.
- [Overview](https://docs.usehardal.com/api-reference/get-analytics-overview.md): Fetch aggregated overview data for the analytics page.
- [Events](https://docs.usehardal.com/api-reference/get-analytics-events.md): List raw event records and grouped time series data for the requested date range.
- [Event Counts](https://docs.usehardal.com/api-reference/get-analytics-events-counts.md): List event counts for the requested date range.
- [Event Fields](https://docs.usehardal.com/api-reference/get-analytics-events-fields.md): List available event columns and event data fields with sample values.
- [Event Data](https://docs.usehardal.com/api-reference/get-analytics-events-eventid-data.md): List event data key-value pairs for a specific event occurrence.
- [Sessions](https://docs.usehardal.com/api-reference/get-analytics-sessions.md): Get session analytics for Sessions analytics
- [Session Details](https://docs.usehardal.com/api-reference/get-analytics-sessions-details.md): Get detailed information for a specific session
- [Campaign Report](https://docs.usehardal.com/api-reference/get-analytics-campaign.md): Analyze campaign performance. Returns aggregated attribution data along with time series data for charting; the time series shape is controlled by the `interval`, `breakdown`, and `metric` query parameters. When comparison is enabled (`isCompareEnabled=true` with `compareStartDate` and `compareEndDate`), the response also includes a `compareTimeSeries` array containing the same time series shape for the comparison period so charts can plot both ranges together.
- [Events](https://docs.usehardal.com/api-reference/get-analytics-funnel-events.md): Get distinct event names for funnel configuration
- [Funnel Analysis](https://docs.usehardal.com/api-reference/post-analytics-funnel-events.md): Analyze event funnel performance
- [Items Aggregation Fields](https://docs.usehardal.com/api-reference/get-analytics-items-aggregation-fields.md): List available aggregation fields for items endpoints.
- [Items Report](https://docs.usehardal.com/api-reference/get-analytics-items.md): Aggregate item performance metrics.
- [Items Report with Attribution](https://docs.usehardal.com/api-reference/get-analytics-items-attribution.md): Aggregate item metrics by attribution dimensions.
- [Leads Aggregation Fields](https://docs.usehardal.com/api-reference/get-analytics-leads-aggregation-fields.md): List available aggregation fields for leads endpoints.
- [Leads Report](https://docs.usehardal.com/api-reference/get-analytics-leads.md): Aggregate lead performance metrics.
- [Leads Report with Attribution](https://docs.usehardal.com/api-reference/get-analytics-leads-attribution.md): Aggregate lead metrics by attribution dimensions.
- [Views](https://docs.usehardal.com/api-reference/get-analytics-views.md): Get views
- [View Columns](https://docs.usehardal.com/api-reference/get-analytics-views-name.md): Get column information for a specific view
- [View Data](https://docs.usehardal.com/api-reference/get-analytics-views-name-data.md): Query data from a specific view with date filtering
- [Export View Data as CSV](https://docs.usehardal.com/api-reference/get-analytics-views-name-data-csv.md): Export all data from a specific view as a CSV file
- [Health Check](https://docs.usehardal.com/api-reference/get-system-health.md): Check if the API is running
- [Root Info](https://docs.usehardal.com/api-reference/get-system.md): Get API information
- [Changelog](https://docs.usehardal.com/changelog.md): Stay up to date with every Hardal platform release, including new destinations, analytics features, API updates, and important bug fixes
- [Hardal's Product Roadmap](https://docs.usehardal.com/roadmap.md): Explore what Hardal has shipped, what is being built, and what is coming soon.

## Upcoming

- [Welcome](https://docs.usehardal.com/upcoming/welcome.md): Start with the current Hardal Dashboard reports, setup, organization, and account pages.
- [Concepts overview](https://docs.usehardal.com/upcoming/user-guide/concepts/overview.md): Learn the rules behind current Hardal metrics, consent, identity, and privacy.
- [Metrics Glossary](https://docs.usehardal.com/upcoming/user-guide/metrics.md): Plain-language definitions for the metrics shown in the Hardal Dashboard.
- [Consent & Privacy](https://docs.usehardal.com/upcoming/user-guide/concepts/consent.md): How Hardal handles anonymous collection, consent signals, identity fields, and first-party cookies.
- [Reports overview](https://docs.usehardal.com/upcoming/user-guide/reports/overview.md): Use the current Dashboard reports to understand website analytics and agent traffic.
- [Dashboard Overview](https://docs.usehardal.com/upcoming/user-guide/reports/dashboard-overview.md): Use Overview to check visitors, sessions, page views, bounce rate, consent rate, session duration, and traffic breakdowns.
- [AI Visibility](https://docs.usehardal.com/upcoming/user-guide/reports/ai-visibility.md): Use AI Visibility to see AI agents, crawlers, platforms, and the pages they visit.
- [Check traffic and event health](https://docs.usehardal.com/upcoming/user-guide/reports/guides/check-performance-health.md): Use Overview scorecards and charts to check traffic, page views, consent, channels, and pages.
- [See which AI agents visit key pages](https://docs.usehardal.com/upcoming/user-guide/reports/guides/inspect-ai-agent-traffic.md): Use AI Visibility to check which AI agents visit your site and whether they reach important pages.
- [Organization overview](https://docs.usehardal.com/upcoming/user-guide/organization/overview.md): Use Organization to manage sources, tenants, organizations, members, and roles.
- [Sources](https://docs.usehardal.com/upcoming/user-guide/data/sources.md): Use Sources to manage where Hardal collects events from.
- [Tenants](https://docs.usehardal.com/upcoming/user-guide/organization/tenants.md): Use Tenants to create tenants and monitor their provisioning status.
- [Organizations](https://docs.usehardal.com/upcoming/user-guide/organization/organizations.md): Use Organizations to review organization details, ownership, and workspace-level access.
- [Members & Roles](https://docs.usehardal.com/upcoming/user-guide/organization/members-roles.md): Use Members & Roles to manage organization members, invitations, and roles.
- [Invite a Member](https://docs.usehardal.com/upcoming/user-guide/organization/guides/invite-member.md): Invite a teammate from Members & Roles.
- [Account overview](https://docs.usehardal.com/upcoming/user-guide/account/overview.md): Use Account docs to sign in or create an account for the Hardal Dashboard.
- [Account Settings](https://docs.usehardal.com/upcoming/user-guide/account/account-settings.md): Review your signed-in profile and the current Dashboard context.
- [Log In](https://docs.usehardal.com/upcoming/user-guide/account/log-in.md): Sign in to the Hardal Dashboard with email and password.
- [Create Account](https://docs.usehardal.com/upcoming/user-guide/account/create-account.md): Create a Hardal account from the Dashboard access screen.
- [Sign In to the Dashboard](https://docs.usehardal.com/upcoming/user-guide/account/guides/sign-in-dashboard.md): Sign in to the Hardal Dashboard with email and password.
- [Create a Hardal Account](https://docs.usehardal.com/upcoming/user-guide/account/guides/create-hardal-account.md): Create an owner account or join an organization from an invitation.
- [Setup Overview](https://docs.usehardal.com/upcoming/setup/overview.md): Technical setup for Hardal: install on web, mobile, or your backend, send events, and track AI agents.
- [Installation Overview](https://docs.usehardal.com/upcoming/setup/installation/overview.md): Choose a Hardal setup for web, mobile, backend, or AI crawler traffic, then configure your first-party collection domain.
- [Web Setup](https://docs.usehardal.com/upcoming/setup/installation/web.md): Install the Hardal tracker script on your website to collect page views through your first-party URL.
- [Mobile Setup](https://docs.usehardal.com/upcoming/setup/installation/mobile.md): Send events from your iOS or Android app to Hardal with an HTTP POST to the /collect endpoint.
- [API & Server-side Setup](https://docs.usehardal.com/upcoming/setup/installation/api.md): Send events from your backend or any server to Hardal with an HTTP POST to the /collect endpoint.
- [AI Visibility Setup](https://docs.usehardal.com/upcoming/setup/installation/ai-visibility.md): Send request metadata to Hardal to analyze AI agent, AI search bot, and crawler traffic.
- [Custom Domain](https://docs.usehardal.com/upcoming/setup/installation/custom-domain.md): Configure a CNAME so Hardal serves tracker and collection requests through a first-party subdomain you control.
- [Set Up Your First-Party URL](https://docs.usehardal.com/upcoming/setup/installation/guides/first-party-url.md): Configure and verify a CNAME for Hardal's first-party collection URL before installing a source.
- [Verify Your Setup](https://docs.usehardal.com/upcoming/setup/installation/guides/verify-setup.md): Use the Dashboard Onboarding page to review workspace, source installation, and first-data verification progress.
- [Events Overview](https://docs.usehardal.com/upcoming/setup/events/overview.md): How events work in Hardal: the event model, standard vs custom events, identify, and consent.
- [Standard Events](https://docs.usehardal.com/upcoming/setup/events/standard-events.md): Use consistent Hardal event names and parameters for commerce, lead, account, and engagement activity.
- [Custom Events](https://docs.usehardal.com/upcoming/setup/events/custom-events.md): Send custom events to Hardal when the standard event catalog does not fit.
- [Identify Visitors](https://docs.usehardal.com/upcoming/setup/events/identify.md): Link a consented visitor's sessions to an identity after login, signup, or consent.
- [Consent Signals](https://docs.usehardal.com/upcoming/setup/events/consent.md): Tell Hardal when a visitor grants tracking, and see what each signal adds on top of privacy-first analytics.
- [Track a Purchase](https://docs.usehardal.com/upcoming/setup/events/guides/track-purchase.md): Send a purchase event with a stable transaction ID and item details.
- [Send Consent on Decision](https://docs.usehardal.com/upcoming/setup/events/guides/send-consent.md): Wire hrd.consent into your consent banner so signals fire the moment a visitor decides.
- [Send Events](https://docs.usehardal.com/upcoming/push/hardal.md): Send events to Hardal with an HTTP POST to the /collect endpoint.
- [Send Agent Events](https://docs.usehardal.com/upcoming/push/agent-events.md): Send request metadata to Hardal so AI Visibility can analyze AI agent, crawler, and bot traffic.
- [Changelog](https://docs.usehardal.com/upcoming/changelog.md): Stay up to date with Hardal platform releases, including Dashboard updates, event collection, AI Visibility, destinations, and API improvements.
- [Hardal's Product Roadmap](https://docs.usehardal.com/upcoming/roadmap.md): Explore what Hardal has shipped, what is being built, and what is coming soon.