Push notification tracking
Track push notification opens and attribute session revenue.
Last updated June 3, 2026
Track push_opened events when users tap notifications so push campaigns can receive engagement attribution without replacing the visitor's original install source.
Prerequisites
- A mobile SDK installed
- Push notifications configured
- Campaign ID or title included in the push payload
Steps
Attach the notification callback
Call Grometrics only after the user opens the notification, not when it is merely received.
Send push_opened
React Native exposes trackPush; native SDKs send the same event with trackEvent. Source, medium, and campaign remain event-level engagement properties.
push-opened.ts
1await tracker.trackPush({2type: 'opened',3notificationId: payload.id,4source: 'reminder',5campaign: 'summer-sale-2026',6deepLink: '/promo/summer'7});
Resume before sending
Send the event after the app resumes so it uses the active app session.
Options / Configuration
| Option | Type | Required | Description |
|---|---|---|---|
| campaign | string | no | Groups push revenue by campaign |
| title | string | no | Displayed in Realtime and Push tab |
| deepLink | string | no | Screen opened by the notification |
Event model
| Event | Used for |
|---|---|
| push_opened | Realtime feed, Push tab, campaign attribution |
What happens next
Tap a test notification and confirm Push appears in Realtime, then build a push_opened to conversion-event funnel filtered by source.
Verify your setup
Verify your setup
Troubleshooting
Push row is untitled
Include campaignId or title in the notification payload.
Was this page helpful?