> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Engagement trends

> Track user engagement across push, in-app, email, SMS, and Live Activities with the Engagement Trends chart in OneSignal. View delivery, click-through, and unsubscribe rates, and export to CSV.

The **Engagement Trends** chart on the OneSignal dashboard shows delivery and engagement rates across push, in-app, email, SMS/RCS, and Live Activities over time. It aggregates every message sent from the dashboard, API, or a Journey, and can be exported to CSV.

<Note>
  Engagement Trends retains up to two years of data depending on your pricing plan. Data is available starting January 10, 2025.
</Note>

<Frame caption="Engagement Trends chart">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/engagement_chart.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=fdda34889c960653f066fa43845fc8e9" alt="Engagement Trends chart" width="1638" height="640" data-path="images/docs/engagement_chart.png" />
</Frame>

## Metrics by channel

<Tabs>
  <Tab title="Push">
    | Metric                       | Description                                                                                                                                                                                                                                                                                      |
    | :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Delivered                    | The number of push notifications successfully delivered to the push services (FCM, APNs).                                                                                                                                                                                                        |
    | Clicked                      | The number of clicks on push notifications. Push notifications can only be clicked once per Subscription.                                                                                                                                                                                        |
    | Unsubscribed                 | The number of push Subscriptions marked unsubscribed because their push token was unregistered, either explicitly or due to [token expiration](./fcm-expired-token-faq). These Subscriptions won't receive further notifications unless they re-subscribe. See [Subscriptions](./subscriptions). |
    | Click-Through Rate           | Calculated as `(Clicked / Delivered) * 100%`.                                                                                                                                                                                                                                                    |
    | Confirmed Receipt Rate       | Percentage of delivered notifications confirmed as received by the device. Calculated as `(Confirmed Receipts / Delivered) * 100%`.                                                                                                                                                              |
    | Unsubscribe Rate             | Calculated as `(Unsubscribed / Delivered) * 100%`.                                                                                                                                                                                                                                               |
    | Confirmed Click-Through Rate | Calculated as `(Clicked / Confirmed Receipts) * 100%`.                                                                                                                                                                                                                                           |

    <Card title="Push message reports" icon="bell" href="./push-notification-message-reports">
      Per-message delivery, click, and confirmed-receipt breakdowns for push notifications.
    </Card>
  </Tab>

  <Tab title="In-app">
    | Metric             | Description                                                                                                                                                                 |
    | :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Impressions        | The number of times an in-app message successfully displayed to a Subscription. Depending on your in-app settings, a single Subscription may register multiple impressions. |
    | Clicked            | The number of unique in-app message clicks. Counted once per Subscription.                                                                                                  |
    | Click-Through Rate | The ratio of unique clicks to impressions, expressed as a percentage.                                                                                                       |

    <Card title="In-app message reports" icon="window" href="./in-app-message-reports">
      Per-message impressions, clicks, and click-through rates for in-app messages.
    </Card>
  </Tab>

  <Tab title="Email">
    | Metric             | Description                                                                                                                                                                                                     |
    | :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Delivered          | The number of emails successfully delivered to the recipient's inbox server.                                                                                                                                    |
    | Opened             | The number of individual recipients who opened the email. User privacy settings can affect these numbers. See [Email message reports](./email-message-reports).                                                 |
    | Clicked            | The number of individual recipients who clicked a link in the email.                                                                                                                                            |
    | Unsubscribed       | The number of recipients who opted out of further emails using the [unsubscribe link](./unsubscribe-links-email-subscriptions). Email subscriptions are marked unsubscribed immediately on receiving the event. |
    | Click-Through Rate | Calculated as `(Clicked / Delivered) * 100%`.                                                                                                                                                                   |
    | Open Rate          | Calculated as `(Opened / Delivered) * 100%`.                                                                                                                                                                    |
    | Unsubscribe Rate   | Calculated as `(Unsubscribed / Delivered) * 100%`.                                                                                                                                                              |
    | Complaint Rate     | Calculated as `(Reported as Spam / Delivered) * 100%`.                                                                                                                                                          |

    <Card title="Email message reports" icon="envelope" href="./email-message-reports">
      Per-message delivery, open, click, bounce, and unsubscribe breakdowns for emails.
    </Card>
  </Tab>

  <Tab title="SMS">
    | Metric              | Description                                                                                                |
    | :------------------ | :--------------------------------------------------------------------------------------------------------- |
    | Delivered           | The number of messages successfully delivered to the carrier as reported by Twilio.                        |
    | Replied (keywords)  | The number of [keywords](./keywords) received by OneSignal, excluding consent keywords.                    |
    | Unsubscribed        | The number of [opt-out keywords](./sms-consent-keyword-management#opt-out-keywords) received by OneSignal. |
    | Keywords Reply Rate | Calculated as `(Replied (keywords) / Delivered) * 100%`.                                                   |
    | Unsubscribe Rate    | Calculated as `(Unsubscribed / Delivered) * 100%`.                                                         |

    <Card title="SMS message reports" icon="comment-sms" href="./sms-message-reports">
      Per-message delivery, reply, and unsubscribe breakdowns for SMS and RCS messages.
    </Card>
  </Tab>

  <Tab title="Live Activities">
    | Metric            | Description                                                                                                                                                                                                |
    | :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Sent              | The number of Live Activity updates sent from OneSignal, including those successfully sent to APNs and failures. This is a composite metric and includes push-to-start and push-to-update notifications.   |
    | Delivered         | The number of Live Activity updates successfully sent to and accepted by APNs.                                                                                                                             |
    | Confirmed Receipt | The number of Live Activity updates confirmed as received by the device, verified by the OneSignal SDK. Requires iOS SDK 5.2.15+. See [Confirmed receipt](./confirmed-delivery) for platform requirements. |
    | Failed            | The number of push subscriptions that did not receive the Live Activity update because of an error.                                                                                                        |
    | Unsubscribed      | The number of push subscriptions marked unsubscribed when users dismiss a Live Activity or disable Live Activities in device settings.                                                                     |
    | Clicked           | The total number of clicks across all Live Activity updates, including repeat clicks from the same user.                                                                                                   |

    <Card title="Live Activities analytics" icon="bolt" href="./live-activities-analytics">
      Delivery, confirmed receipt, and click breakdowns for iOS Live Activities.
    </Card>
  </Tab>
</Tabs>

<Card title="Metrics glossary" icon="book" href="./analytics-metrics-glossary">
  Canonical definitions for every metric across the dashboard, API, CSV, and Event Streams.
</Card>

## Export chart data

<Steps>
  <Step title="Filter the chart">
    Set the time range and messaging channel you want to export.
  </Step>

  <Step title="Start the export">
    Click the export button at the top right of the chart.
  </Step>

  <Step title="Receive the CSV">
    OneSignal emails the CSV to the address on your current OneSignal user account. The file contains per-day engagement statistics for the filtered range.
  </Step>
</Steps>

## FAQ

### How far back does Engagement Trends data go?

Data is available starting January 10, 2025. Retention is up to two years depending on your pricing plan.

### Why do my Engagement Trends numbers differ from an individual message report?

Engagement Trends aggregates every message sent in the filtered time range across the selected channel, including messages sent from the API and Journeys. Individual message reports show only that one send. Small rounding differences between the rate calculations shown here and on per-message reports can also occur because Engagement Trends groups by day.

### Why does SMS **Delivered** on this chart differ from the count in Twilio?

OneSignal's SMS **Delivered** reflects carrier-confirmed receipt reported back by Twilio. Differences usually come from messages still in flight at comparison time, late status callbacks from carriers, or messages that moved to **Provider Undelivered** after initial acceptance. See the [Metrics glossary](./analytics-metrics-glossary) for the full SMS lifecycle.

### Can I get raw per-event data instead of aggregated daily statistics?

Yes. Use [Event Streams](./event-streams) to forward real-time message events to your own analytics stack, or [Exporting data](./exporting-data) to download the Notifications CSV for a range of messages.

### Why is Live Activities **Unsubscribed** counted when a user dismisses the activity?

Once a user dismisses a Live Activity or disables Live Activities in device settings, APNs returns an error indicating the activity token is no longer valid. OneSignal counts these push subscriptions as unsubscribed for Live Activity delivery and stops sending further updates.

## Related

<Columns cols={2}>
  <Card title="Metrics glossary" icon="book" href="./analytics-metrics-glossary">
    Canonical definitions for every metric across push, email, SMS/RCS, in-app, and Live Activities.
  </Card>

  <Card title="Analytics overview" icon="chart-line" href="./analytics-overview">
    Tour the dashboards, APIs, and export tools OneSignal provides for measuring performance.
  </Card>

  <Card title="Event Streams" icon="satellite-dish" href="./event-streams">
    Send real-time message events to your warehouse for custom analysis.
  </Card>

  <Card title="Exporting data" icon="file-export" href="./exporting-data">
    Export message and subscription data to CSV for offline analysis.
  </Card>
</Columns>