Platform Event Mapping

TrackStack maps each canonical event to platform-native names at the edge. The dashboard Configure → Events tab shows the mapped name as a subtitle when you select events.

Core mappings (blueprint §4)

Canonical	Meta	Google	LinkedIn	SignUp family
SignUp	CompleteRegistration	sign_up	Sign Up	—
StartTrial	StartTrial	begin_checkout	Start Trial	—
Purchase	Purchase	purchase	Purchase	—
LeadCaptured	Lead	generate_lead	Lead	—
DemoBooked	Schedule	generate_lead	Lead	—
PageView	PageView	page_view	PageView	—
ContentView	ViewContent	view_item	ViewContent	—
AddPaymentInfo	AddPaymentInfo	add_payment_info	—	—
PlanUpgrade	Purchase	purchase	Purchase	Maps to purchase family
SubscriptionRenew	Subscribe	purchase	Purchase	—

Refund and chargeback events map internally but are excluded from default platform allowlists — route to warehouse/CRM only unless you explicitly enable them.

Default platform allowlists (blueprint §15)

These are applied when you click Reset to platform defaults in the dashboard. A blank allowlist means all 66 canonical events.

Platform	Default events
Meta	PageView, ContentView, LeadCaptured, DemoBooked, SignUp, StartTrial, FirstAction, AddPaymentInfo, Purchase, PlanUpgrade, SubscriptionRenew
Google Ads	LeadCaptured, DemoBooked, SignUp, StartTrial, FirstAction, Purchase, PlanUpgrade, SubscriptionRenew (PageView/ContentView via GA4 separately)
LinkedIn	PageView, ContentView, LeadCaptured, DemoBooked, SignUp, StartTrial, SalesQualifiedLead, OpportunityCreated, Purchase
Reddit	PageView, ContentView, LeadCaptured, SignUp, Purchase
TikTok	PageView, ContentView, LeadCaptured, SignUp, Purchase
Microsoft	PageView, LeadCaptured, DemoBooked, SignUp, Purchase
Quora	LeadCaptured, DemoBooked, SignUp, Purchase
Pinterest	PageView, ContentView, SignUp, Purchase
Snapchat	PageView, SignUp, Purchase
X	PageView, ContentView, LeadCaptured, SignUp, Purchase

Mapping templates

Events not listed in §4 use logical templates:

Template	Used for	Example platforms
Page view	HighIntentPageView, AdLandingPageView, ReturningVisitor	Meta PageView, Google page_view
Content view	DocsInteraction, IntegrationViewed, ApiDocsViewed	Meta ViewContent
Lead	FeatureUsed, DemoIntent, activation events	Meta Lead, Google generate_lead
Schedule	DemoBooked, MeetingHeld	Meta Schedule
Sign up	SSOLogin, EmailVerified, WorkspaceCreated	Meta CompleteRegistration
Checkout	CheckoutStarted	Meta InitiateCheckout
Purchase	Revenue events, CreditsPurchased	Meta Purchase, TikTok PlaceAnOrder
Custom	Product ops events, Churned	Platform custom event names

Overrides

Override per capture when your ad account requires specific IDs:

trackstack.capture("SignUp", {
  eventId: "evt_001",
  email: "user@example.com",
  platformParams: {
    linkedin: { conversionRuleId: "12345678" },
    google: { sendTo: "AW-XXXX/YYY" },
    meta: { test_event_code: "TEST12345" },
  },
});

Related docs

• Supported platforms — Credentials and CAPI status
• Routing policy — Ads vs warehouse
• Event payload — Full payload contract