# Hardal

## User Guide

- [Welcome](https://docs.usehardal.com/welcome.md): No description found
- [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.
- [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

- [Welcome](https://docs.usehardal.com/setup/overview.md): Technical documentation for integrating Hardal installation, server-side hosting, and self-hosted deployment.
- [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.
- [Overview](https://docs.usehardal.com/setup/installation/overview.md): Set up Hardal on your website, mobile app, or server — and configure a custom domain for first-party data collection.
- [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
- [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
- [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
- [GA4 Server-Side](https://docs.usehardal.com/setup/server-side/sgtm-setups/ga4-config.md): Learn how you can configure GA4 server-side tracking with Hardal to improve data collection accuracy, enhance privacy, and bypass ad blockers
- [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
- [Meta CAPI](https://docs.usehardal.com/setup/server-side/sgtm-setups/meta-capi-sgtm.md): Learn how you can send conversion data to Meta Conversions API via server-side Google Tag Manager for better ad optimization accuracy
- [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

## Analytics API

- [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

- [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

## Roadmap

- [Hardal's Product Roadmap](https://docs.usehardal.com/roadmap.md): See what we are working on and what is coming soon.