Update Superwall Events table to match current SDKs - #264
Merged
Conversation
Add paywall_page_view and other events tracked by the current iOS and Android SDKs (attribution_match, stripeCheckout_*, redemption_*, enrichment_*, permission_*, paywallPreload_*, testModeModal_*, paywallWebviewLoad_timeout, paywallProductsLoad_missingProducts, paywallResourceLoad_fail, review_requested, customerInfo_didChange, integration_attributes, networkDecoding_fail). Correct event names to the raw values the SDKs emit (e.g. config_refresh, restore_start, shimmerView_start, survey_close, identity_alias, adServicesTokenRequest_*) and add the newer paywall event parameters (presentation_id, close_reason, cache_key, build_id, and friends).
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
superwall-docs | 165c612 | Commit Preview URL Branch Preview URL |
Aug 13 2026, 06:26 PM |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Jordan Morgan · Slack thread
Before / After
Before: The "Superwall Events" page (shared across the iOS, Android, Flutter, Expo, and React Native docs) was missing about two dozen events the current SDKs actually track — most notably
paywall_page_view, which fires when a user views a page in a multi-page paywall. A customer asking "which event tells me a paywall screen was presented?" couldn't find the answer on this page. Several rows also listed event names that don't match what the SDKs emit (e.g. the docs saidconfigRefresh,restoreStart, andsurveyClose, while the SDKs sendconfig_refresh,restore_start, andsurvey_close), so searching an analytics destination for the documented name would come up empty.After: The table lists every event tracked by the current iOS (4.16.2) and Android (2.8.1) SDKs under the exact raw name each SDK emits, including
paywall_page_viewwith its page-navigation parameters, and the newer paywall event parameters (presentation_id,close_reason,cache_key,build_id, and friends) on thepaywall_closefamily of events.How
Compared the table in
content/shared/3rd-party-analytics/tracking-analytics.mdx(hand-maintained, included into all five per-SDK "Superwall Events" pages) against the event definitions in the SDK source:SuperwallEvent.swift/SuperwallEventObjc.swift/TrackableSuperwallEvent.swift/PaywallInfo.swiftin Superwall-iOS, andSuperwallEvents.kt/TrackableSuperwallEvent.kt/PaywallInfo.ktin Superwall-Android. Added the missing rows (attribution_match,customerInfo_didChange,enrichment_*,integration_attributes,networkDecoding_fail,paywall_page_view,paywallPreload_*,paywallProductsLoad_missingProducts,paywallResourceLoad_fail,paywallWebviewLoad_timeout,permission_*,redemption_*,review_requested,stripeCheckout_*,testModeModal_*), corrected the mis-named rows to the raw event strings, updated parameter lists where the source showed different keys (e.g.error_messageinstead oferror), and re-alphabetized the table. Events declared in an SDK but never tracked (Android'sreview_granted/review_denied) were deliberately left out. Prose outside the table is untouched. Verified withbun install,bun run build, andbun test(64 pass, 0 fail).Generated by Claude Code