Event reference
For anyone wiring an integration that consumes Zellify's funnel events. You'll have a single source of truth for every event name, when it fires, and what it carries. You need the canonical names before you look up the per-integration mapping.
Event list#
| Event | When it fires | Value |
|---|---|---|
PageView | Every funnel page render | — |
Lead | Visitor submits email at the registration step | — |
ViewContent | Paywall renders | — |
InitiateCheckout | Paywall form opens | value, currency, product_id |
Purchase | Payment confirmed | value, currency, product_id, transaction_id |
SubscriptionStarted | Subscription begins (incl. after trial) | value, currency, product_id |
Renewal | Subscription renewed (server-side only) | value, currency, product_id |
Cancellation | Subscription canceled (server-side only) | product_id |
Funnel navigation events#
PageView fires on every page render, including refreshes. Lead fires once per funnel session when the visitor advances past the registration step.
Lead capture events#
Lead events carry email and app_user_id. Any quiz answers collected before the registration step are attached as event properties.
Checkout and payment events#
ViewContent fires before InitiateCheckout. InitiateCheckout fires when the visitor opens the payment form. Purchase fires only on successful payment. A failed payment does not fire Purchase.
Subscription lifecycle events#
SubscriptionStarted fires at the start of a subscription — either immediately on checkout (no trial) or at trial end (with trial). Renewal and Cancellation fire server-side from the payment provider's webhooks; they are not browser-visible.
Event data shapes#
All events carry these context fields:
| Field | Always present |
|---|---|
app_user_id | Yes |
funnel_id | Yes |
campaign_id | Yes |
experiment_id | If the campaign runs an experiment |
page_location | Yes |
How integrations map these events#
Each integration page maps this canonical list to its own event vocabulary. Do not restate the taxonomy there; link here.
| Canonical | Meta | TikTok | GTM | PostHog | Amplitude | Klaviyo |
|---|---|---|---|---|---|---|
| PageView | PageView | ViewContent | page_view | $pageview | Page Viewed | — |
| Lead | Lead | CompleteRegistration | generate_lead | Lead | Lead | Signed Up |
| ViewContent | ViewContent | — | view_item | Viewed Paywall | Viewed Paywall | Viewed Paywall |
| InitiateCheckout | InitiateCheckout | InitiateCheckout | begin_checkout | Started Checkout | Started Checkout | Started Checkout |
| Purchase | Purchase | CompletePayment | purchase | z:revenue | Revenue | Placed Order |
| SubscriptionStarted | Subscribe | Subscribe | subscribe | z:revenue | Revenue | Started Subscription |