Skip to main content

Deliveries Overview

Deliveries represent individual notifications sent to your subscribers. Every notification—whether sent manually, via RSS automation, or as part of an A/B test—creates a delivery record you can track.

Accessing Deliveries​

  1. Navigate to your app
  2. Click Deliveries in the app menu

Delivery List​

The deliveries page shows all notifications for your app:

The main Deliveries dashboard showing notification history and statuses

List and Calendar Views​

Toggle between List and Calendar at the top of the page. Calendar view (with Month/Week options) plots deliveries by date, useful for spotting scheduling gaps or clusters at a glance. List view is better for filtering and scanning details — the columns and filters below apply to List view.

Columns​

ColumnDescription
NameInternal name (required on every delivery, including RSS and A/B test rollouts)
TitleNotification headline
SourceManual, RSS, A/B Test Variant, or A/B Test Rollout — see Delivery Sources below
CategoryColor-coded category badge
SegmentTarget segment or "All"
StatusCurrent delivery status
CreatedWhen the delivery was created

Filtering​

Filter your deliveries by:

  • Name - Search by internal name
  • Title - Search by notification title
  • Status - Filter by delivery status (Pending, Scheduled, Queued, Processing, Partial, Success, Failed, Cancelled)
  • Source - Filter by Manual, RSS, A/B Test Variant, or A/B Test Rollout
  • Category - Filter by category (including "Uncategorized")
  • Segment - Filter by which segment a delivery was targeted at

Using filters to find specific notifications in OCM Pulse

Click Clear to remove all filters.

Delivery Status​

Each delivery has a status indicating where it is in the lifecycle:

StatusBadgeDescription
PendingGrayJust created, about to be queued
ScheduledPurpleWaiting for scheduled time
QueuedGrayIn queue, waiting to be processed
ProcessingYellowCurrently being sent
SuccessGreenAll notifications delivered
PartialYellow/GreenSome delivered, some failed
FailedRedAll notifications failed
CancelledOrangeManually cancelled

Status Flow​

Created → Pending → Queued → Processing → Success/Partial/Failed
↓ ↑
Scheduled → [wait] → Processing-┘
↓
Cancelled (any time before Success)

Delivery Details​

Click any row to open the details panel.

Viewing detailed notification content, metrics, and timeline in OCM Pulse

Content Section​

  • Name - Internal identifier
  • Category - With color indicator
  • Title - Notification headline (bold)
  • Body - Full message text
  • URL - Click destination
  • Image - Hero image URL (if set)
  • Segment - Target audience

Frequency Cap Indicator​

If the delivery bypassed frequency capping, you'll see a notification:

"This delivery ignored frequency capping"

Metrics​

MetricDescription
Total SubscribersNumber targeted
CappedNumber excluded by frequency cap
DeliveredSuccessfully sent
FailedFailed to deliver
ClicksTotal clicks received
Click RatePercentage who clicked

Timeline​

See exactly when each stage happened:

EventDescription
Created atWhen delivery was initiated
Scheduled forPlanned send time (if scheduled)
Queued atWhen added to processing queue
Started atWhen sending began
Completed atWhen all sends finished

Error Messages​

If a delivery had failures, a Delivery Errors panel appears showing a Failed Sends count alongside human-readable summaries (e.g. "Some endpoints were no longer valid," "Unexpected delivery error"). Below that, raw worker error codes are also shown — these are more specific and useful for troubleshooting:

ErrorMeaning
subscription expired (410 Gone)The subscriber's push endpoint is no longer valid — typically means they uninstalled, cleared site data, or the browser revoked it. These subscriptions are automatically marked inactive.
unexpected status: 413 Request Entity...The notification payload (likely the hero image) was too large for the push service to accept.

If you see a high volume of 413 errors, check that hero images are within the documented size limits before troubleshooting further.

Cancelling a Delivery​

You can cancel deliveries that haven't completed:

  1. Click the delivery to open details
  2. Click Cancel button
  3. Confirm in the dialog

What can be cancelled:

  • Scheduled deliveries (before send time)
  • Pending deliveries
  • Processing deliveries (stops remaining sends)

What cannot be cancelled:

  • Completed deliveries (Success, Partial, Failed)
  • Already cancelled deliveries

Real-Time Updates​

The deliveries list automatically refreshes when deliveries are in progress:

  • Updates every 5 seconds
  • Shows live status changes
  • Displays updated metrics

This stops when all deliveries reach a final state.

Understanding Metrics​

Detailed breakdown of delivery metrics and click rates in OCM Pulse

Delivered vs. Success Count​

Delivered (Success Count) means the notification was:

  • Accepted by the push service
  • Sent to the subscriber's device

It does NOT guarantee the user saw it (they may have Do Not Disturb on).

Failed Count​

Failed means the notification could not be delivered:

  • Subscription expired (user unsubscribed via browser)
  • Push service rejected the notification
  • Invalid subscription data

Failed subscriptions are automatically marked inactive.

Capped Subscribers​

When frequency capping is enabled:

  • Some subscribers may be skipped
  • They've already received the maximum notifications
  • This is shown in the "Capped" metric

Click Rate Calculation​

Click Rate = (Clicks / Delivered) × 100%

Industry average click rates for web push are typically 2-5%.

Delivery Sources​

Deliveries come from different sources:

SourceDescription
ManualCreated through the Manual Trigger
RSSAuto-created from RSS feed items
A/B Test VariantPart of an A/B test
A/B Test RolloutWinner sent to remaining subscribers

Tips for Better Deliveries​

Timing​

  • Send when your audience is most active
  • Avoid late night/early morning
  • Consider timezone differences

Content​

  • Keep titles compelling and short
  • Make the body actionable
  • Ensure URLs work and load quickly

Frequency​

  • Don't over-send
  • Use frequency capping appropriately
  • Monitor unsubscribe rates

Analysis​

  • Review click rates regularly
  • Identify best-performing content types
  • Learn from failed deliveries

Next Steps​