Analytics

Privacy & Data handling

Understand how @zeitgg/analytics collects anonymous data to provide insights while respecting user privacy.

Privacy & Data handling

@zeitgg/analytics provides valuable insights into your website's traffic and performance while prioritizing user privacy through anonymous data collection.

Our Privacy Pledge

  • Anonymity by Design: We do not track individuals. All data collected is aggregated and anonymized, making it impossible to identify specific users.
  • No Cookies or Persistent IDs: We do not use cookies, localStorage, or any browser fingerprinting techniques. Each page view is treated as a new, anonymous event.
  • No PII Collection (by Default): The core service automatically collects only essential, non-personally identifiable information about page views and performance.
  • Transparent Data Usage: Data is used solely to provide you with analytics insights about your website's performance and traffic patterns.

What Data is Collected?

To provide insights without compromising privacy, @zeitgg/analytics collects the following anonymous data points:

  1. Page Views:
    • URL Path: The path of the page being viewed (e.g., /blog/my-post)
    • Referrer: The referring site (e.g., google.com, x.com
    • Hostname: Your site's hostname (e.g., yourdomain.app)
  2. Web Vitals:
    • Metric Name: The name of the Web Vital (e.g., LCP, FID, CLS).
    • Value: The measured value of the metric.
    • ID: A temporary identifier for the specific metric instance (not linkable across page views).
    • Associated URL path and hostname.
  3. General Context:
    • Country: Derived from the request IP address before the IP is discarded (see below).
    • Browser & OS: Basic, aggregated browser (e.g., Chrome, Firefox) and OS (e.g., Windows, macOS) information.

What We Don't Collect: IP Addresses (see below), precise User Agent strings, unique device identifiers, screen resolution details, or any other information that could be used to identify or track an individual user.

Handling of IP Addresses

IP addresses are never stored. They are used momentarily in memory solely to derive the country of origin for the request and are then immediately discarded before any data is logged or stored.

Custom Event Data

The track() function allows you to send custom event data.

import { track } from "@zeitgg/analytics";
 
// Example: Tracking a feature usage event
track("feature_used", { feature_name: "dark_mode_toggle" });

Your Responsibility: While the core service is anonymous, you control the data sent via custom events. Do not include Personally Identifiable Information (PII) like user IDs, emails, names, or other sensitive details in your custom event payloads. Keep custom data focused on application interactions, not individuals. Misusing custom events to send PII undermines the privacy focus of the service.

Data Usage & Retention

  • Collected anonymous data is processed and aggregated to generate the reportsd visible in your ZEIT Dashboard.
  • Data is used exclusively for providing analytics related to your configured domain.
  • Aggregated data is typically retained for a defined period. (e.g., 7 days, 30 days) to allow for trend analysis, after which raw event logs may be deleted.

GDPR & Compliance

@zeitgg/analytics is designed to aligh with the principles of GDPR and other privacy regulations by focusing on anonymous data.

  • No Personal Data (by Default): Since the core service does not collect PII or use tracking mechanisms like cookies, the requirements for user consent under GDPR are typically not triggered for the automatic data collection.
  • Data Minimization: We collect the minimum data necessary to provide useful performance and traffic insights.
  • Transparency: This page outlines our data practices. You should still reference your use of analytics tools in your own site's privacy policy.
  • Custom Events: If you choose to send potentially identifying information via custom events (which is strongly discouraged), you become responsible for ensuring you have the necessary legal basis (e.g., consent) for doing so.

This documentation provides information but does not constitute legal advice. While @zeitgg/analytics aims to be privacy-friendly, consult with legal counsel to ensure your overall website and data handling practices comply with all applicable regulations.

Your Responsibilities

  1. Configure Correctly: Ensure you are using the package as intended.
  2. Use Custom Events Wisely: Avoid sending PII via the track() function.
  3. Maintain Your Privacy Policy: Inform your users about the analytics tools you use.

By leveraging anonymous data collection, @zeitgg/analytics helps you understand your audience and improve your site without compromising user privacy.

On this page