Документация

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. Раздавайте его со своего домена

Добавьте CNAME с поддомена вашего сайта на analytics-demo.altixcode.com, а затем укажите это имя хоста в панели управления. Мы подтверждаем его с помощью TXT-записи перед выдачей сертификата, поэтому никто не сможет привязать хост, который ему не принадлежит.

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

Затем измените src скрипта на собственное имя хоста. С этого момента запросы становятся first-party.

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. Что собирается

URL страницы и источник перехода
Пути страниц нормализуются: вероятные ID аккаунтов заменяются, параметры запроса удаляются кроме допустимых UTM-значений, а у источника перехода сохраняется только origin.
Браузер, ОС и тип устройства
Определяются из строки user-agent, после чего она удаляется.
Страна
Определяется по IP-адресу в момент запроса.
Свойства пользовательских событий
Простые свойства могут сохраняться. Перед отправкой удаляются известные чувствительные ключи, значения, похожие на email, сетевые адреса и длинные идентификаторы. Заголовки страниц, размеры экрана и явные ID посетителей опускаются. Фильтр не гарантирует удаление всех персональных данных.
Хеш, уникальный для каждого дня и сайта
Хеш с солью, который используется, чтобы учесть визит один раз. Он меняется ежедневно, его нельзя обратить в IP-адрес или сопоставить между сайтами.

А что — нет

На этой странице описано поведение трекера, который мы обслуживаем. Это не юридическая консультация, и ваши обязанности зависят от того, что ещё делает ваш сайт.