Docs for the push activity tracking

[Aviatorscode2]

Summary by CodeRabbit

• Documentation
  • Added “Push Notification Activity Tracking” guide outlining the end-to-end workflow to capture push interactions, forward events from backend, and view activity in the Activity Feed.
  • Provided client examples for Expo, FCM, APNs, OneSignal and server examples (TypeScript/JS) demonstrating event forwarding.
  • Updated docs navigation to surface the new page.

[linear]

MRK-1077 Build documentation for Push Inbound Webhooks using DX Guide

[coderabbitai]

Warning

Rate limit exceeded

@Aviatorscode2 has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 3 minutes and 3 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 7cb8754 and d5d6003.

📒 Files selected for processing (1)

• content/docs/platform/integrations/push/push-activity-tracking.mdx (1 hunks)

Walkthrough

Adds a new documentation page "push-activity-tracking" describing a client→backend→Novu workflow for forwarding push interaction events, and updates the push integration metadata to include the new page.

Changes

Cohort / File(s)	Summary of Changes
Push Docs Metadata content/docs/platform/integrations/push/meta.json	Added "push-activity-tracking" to the pages array.
Push Activity Tracking Doc content/docs/platform/integrations/push/push-activity-tracking.mdx	New documentation page describing enabling Push Activity Tracking, obtaining Environment/Integration IDs, client-side capture examples (Expo, FCM, APNs, OneSignal), backend forwarding via Novu API/SDK, and end-to-end flow to the Activity Feed.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  participant U as Client App
  participant B as App Backend
  participant N as Novu API
  participant F as Novu Activity Feed

  rect rgba(200,230,255,0.25)
    note over U: Step 2 — capture push interaction on device
    U->>B: POST /track-push {eventType,eventId,timestamp,content,deviceId,platform}
  end

  rect rgba(220,255,220,0.25)
    note over B: Step 3 — backend forwards to Novu
    B->>N: trackActivity({environmentId,integrationId,requestBody})
    N-->>B: HTTP 2xx/4xx
  end

  rect rgba(255,240,200,0.25)
    note over N,F: Step 4 — event appears in Activity Feed
    N-->>F: store/display event
  end

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

• Pay attention to: the new MDX content for accuracy and formatting, and the pages array update in meta.json for correct ordering/format.

Suggested reviewers

• djabarovgeorge
• DianaHackmamba
• jainpawan21

Poem

I thump my paws at every ping,
New tracks where push notifications sing.
From device to burrow, neat and quick,
Each event hops home — a tidy trick.
I log, I nibble, I bound with cheer. 🐇✨

Pre-merge checks and finishing touches

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The pull request title 'Docs for the push activity tracking' directly relates to the main changes in the changeset. The PR adds new documentation for push notification activity tracking, including a new documentation page and updates to the metadata file. The title accurately reflects the primary objective of adding documentation content for this feature.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[netlify]

👷 Deploy Preview for docs-novu processing.

Name	Link
🔨 Latest commit	d5d6003
🔍 Latest deploy log	https://app.netlify.com/projects/docs-novu/deploys/69088f307eb4020008416ea3

[coderabbitai]

Actionable comments posted: 3

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e96aa5b and 453e1cb.

⛔ Files ignored due to path filters (1)

• public/images/channels-and-providers/push/activity-tracking/enable-activity-tracking.png is excluded by !**/*.png

📒 Files selected for processing (2)

• content/docs/platform/integrations/push/meta.json (1 hunks)
• content/docs/platform/integrations/push/push-activity-tracking.mdx (1 hunks)

[coderabbitai]

Actionable comments posted: 2

🧹 Nitpick comments (2)

content/docs/platform/integrations/push/push-activity-tracking.mdx (2)

7-9: Fix the incomplete sentence in the introduction.

Line 9 is a sentence fragment that disrupts the flow. It should be restructured to form a complete sentence or better connected to the previous thought.

Suggested fix:

- Where your application captures and forwards push notification events to the Novu. Once received, Novu processes and displays these events alongside other channels for a unified tracking experience.
+ This is where your application captures and forwards push notification events to Novu. Once received, Novu processes and displays these events alongside other channels for a unified tracking experience.

---

151-151: Break up the long concluding sentence for readability.

The final sentence is dense and could be split into two shorter sentences for better flow:

- Once these steps are completed, your application will send push notification engagement data to Novu, giving you a complete, unified view of your notification performance in the Activity Feed.
+ Once these steps are completed, your application will send push notification engagement data to Novu. This gives you a complete, unified view of your notification performance in the Activity Feed.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 4f6240c and 7cb8754.

📒 Files selected for processing (1)

• content/docs/platform/integrations/push/push-activity-tracking.mdx (1 hunks)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: Build and Lint