Dokumentation

Full documentation and integration guides for Altix Analytics and our 100% drop-in PostHog SDK wire compatibility.

1. Integration & SDK Quick Start

Choose your preferred SDK or embed our lightweight tracker. If you are already using PostHog, you do not need to install any new packages—simply replace your API host.

⚡

100% Drop-In PostHog Wire Compatibility

Already using PostHog? Keep all your existing SDK calls (posthog.capture, posthog.identify, posthog.isFeatureEnabled). Simply point api_host to https://analytics-demo.altixcode.com and use your Website ID as the key.

analytics.ts
// 1. Install official PostHog JS library
npm install posthog-js

// 2. Initialize with Altix Analytics as the api_host
import posthog from 'posthog-js'

posthog.init('YOUR_WEBSITE_ID', {
  api_host: 'https://analytics-demo.altixcode.com',
  autocapture: true, // or false if you prefer manual tracking
  // Keeps posthog-js from writing a cookie or localStorage. Each page load then
  // starts a new anonymous visitor until you call identify(). Remove this line to
  // keep visitors across pages, but that stores an identifier on the device, which
  // usually needs your visitors' consent.
  persistence: 'memory',
})

// 3. Track events and pageviews
posthog.capture('signup_completed', {
  plan: 'pro',
  billing_cycle: 'annual',
})

// 4. Identify logged-in users
posthog.identify('usr_12345', {
  plan: 'pro',
  company: 'Acme Corp',
})

// 5. Evaluate Feature Flags & Remote Config
if (posthog.isFeatureEnabled('dark-mode-v2')) {
  const config = posthog.getFeatureFlagPayload('dark-mode-v2')
  console.log('Active theme payload:', config)
}
✓Feature Flags & Rollouts

Deterministic HMAC hashing, user target whitelists, percentage rollouts, and multivariate variants evaluated instantly via /decide.

✓People & Identity Links

posthog.identify() maps distinct IDs and merges $set attributes into tenant-isolated People profiles.

✓Privacy & Ad-Block Immunity

Requests route directly through your domain or Altix endpoints, bypassing third-party tracker blocklists while staying 100% GDPR compliant.

2. Über deine eigene Domain ausliefern

Richte einen CNAME von einer Subdomain deiner Website auf analytics-demo.altixcode.com ein und füge den Hostnamen anschließend im Dashboard hinzu. Wir prüfen ihn über einen TXT-Eintrag, bevor ein Zertifikat ausgestellt wird — so kann niemand einen Hostnamen einbinden, der ihm nicht gehört.

analytics.yoursite.com.        CNAME  analytics-demo.altixcode.com.
_altix-verify.analytics.yoursite.com.  TXT  "altix-site-verification=…"

Ändere danach das src des Skripts auf deinen eigenen Hostnamen. Ab diesem Moment laufen alle Anfragen als First-Party-Anfragen.

3. Wire Compatibility Endpoints

Standard PostHog client and server SDKs communicate with these endpoints transparently:

POST /decide/?v=3Evaluates feature flags, percentage rollouts, user targeting, and multivariate payloads using deterministic HMAC-SHA256 hashing.
POST /batch/Ingests single and batched events, `$pageview`, custom actions, and `$identify` calls with gzip and LZString decompression support.
POST /e/ & /capture/Alternate ingestion routes for lightweight beacon and client captures.
GET /static/array.jsFirst-party CDN proxy for HTML snippet users, preventing ad-blocker filtering.

3. Was erfasst wird

Seiten-URL und Referrer
Seitenpfade werden bereinigt: wahrscheinliche Konto-IDs werden ersetzt, Abfrageparameter bis auf zulässige UTM-Werte entfernt und von Referrern bleibt nur der Ursprung.
Browser, Betriebssystem und Gerätetyp
Wird aus dem User-Agent abgeleitet und danach verworfen.
Land
Wird zum Zeitpunkt der Anfrage aus der IP-Adresse abgeleitet.
Eigenschaften benutzerdefinierter Events
Einfache Event-Eigenschaften können erhalten bleiben. Bekannte sensible Schlüssel, E-Mail-ähnliche Werte, Netzwerkadressen und lange Kennungen werden vor der Weiterleitung entfernt. Seitentitel, Bildschirmmaße und explizite Besucher-IDs werden ausgelassen. Dieser Filter kann nicht garantieren, dass jede Form personenbezogener Daten entfernt wird.
Ein Hash pro Tag und pro Website
Ein gesalzener Hash, mit dem ein Besuch genau einmal gezählt wird. Er wird täglich rotiert, lässt sich nicht in eine IP-Adresse zurückrechnen und nicht über mehrere Websites hinweg zusammenführen.

Und was nicht

Diese Seite beschreibt das Verhalten des von uns betriebenen Trackers. Sie stellt keine Rechtsberatung dar, und welche Pflichten für dich gelten, hängt davon ab, was deine Website darüber hinaus tut.