API ReferenceEvent Referenceanalytics.event.tracked.v1

analytics.event.tracked.v1

Constant

import { EVENT_NAMES } from "@platform/contracts";
 
EVENT_NAMES.ANALYTICS_EVENT_TRACKED_V1;

Publishers

Subscribers

No service currently subscribes to this event.

Payload schema

z.object({
  event_id: z.string(),
  event_name: z.string(),
  distinct_id: z.string(),
  brand_id: z.string(),
  properties: z.record(z.unknown()).optional(),
  ip_address: z.string().nullish(),
  user_agent: z.string().nullish(),
  tracked_at: z.string().datetime(),
  posthog_status: z.enum(["forwarded", "failed", "skipped", "pending"]),
}

Delivery semantics

  • At-least-once delivery. Consumers must dedupe by event ID.
  • Fanned out to both NATS (in-cluster) and EventBridge (durable). See Events concept.