Analytics queries in mail logic; EmailAnalytics component; EmailAnalytics comp. integration with broadcast mail screen

apps/docs/src/config.ts

@@ -93,6 +93,10 @@ export const SIDEBAR: Sidebar = {
                 text: "Sequences (Campaigns)",
                 link: "en/email-marketing/sequences",
             },
+            {
+                text: "Analytics",
+                link: "en/email-marketing/analytics",
+            },
         ],
         Website: [
             { text: "Introduction", link: "en/website/introduction" },

apps/docs/src/pages/en/email-marketing/analytics.md

@@ -0,0 +1,94 @@
+---
+title: Email Analytics
+description: Track and analyze the performance of your email campaigns
+layout: ../../../layouts/MainLayout.astro
+---
+
+Email analytics provide detailed insights into how your email campaigns are performing, helping you understand your audience engagement and optimize your email marketing strategy.
+
+> This feature is currently in beta, which means you may encounter bugs. Please report them in our <a href="https://discord.com/invite/GR4bQsN" target="_blank">Discord</a> group if you run into any issues.
+
+> **Before you start**: If your school is hosted on [courselit.app](https://courselit.app), you need to get approved to send marketing emails. [Request access here](/en/email-marketing/mail-access-request).
+
+## Accessing Email Analytics
+
+From the `Dashboard`, go to `Mails` and select any broadcast or sequence you've sent. You'll see two tabs at the top:
+
+- **Compose**: For creating and editing emails
+- **Analytics**: For viewing performance metrics
+
+Click on the `Analytics` tab to access detailed performance data for your email campaign.
+
+![Email Analytics Dashboard](/assets/emails/analytics-dashboard.png)
+
+## Understanding Email Performance Metrics
+
+The analytics dashboard is divided into two main sections that provide comprehensive insights into your email campaign performance.
+
+### Email Performance Section
+
+This section displays key performance indicators (KPIs) that help you understand how your email campaign is performing. Each metric is presented with a question mark icon (?) that provides additional context when hovered over.
+
+![Email Performance Section](/assets/emails/analytics-performance.jpeg)
+
+#### Subscribers
+
+- **What it shows**: The total number of subscribers who were targeted by this email campaign
+- **How it's calculated**: Based on the filters you applied when creating the broadcast OR the number of subscribers in the sequence
+- **Why it matters**: Helps you understand the reach of your campaign
+
+#### Emails Sent
+
+- **What it shows**: The actual number of emails that were successfully sent
+- **How it's calculated**: Total emails dispatched
+- **Why it matters**: Confirms that your emails are being delivered to your audience
+
+#### Open Rate
+
+- **What it shows**: The percentage of emails that were opened by recipients
+- **How it's calculated**: (Number of opened emails ÷ Total emails sent) × 100
+- **Why it matters**: Indicates how engaging your subject lines and sender reputation are
+- **Industry benchmark**: Typically ranges from 15-25% for most industries
+
+#### Click Rate
+
+- **What it shows**: The percentage of emails that resulted in at least one link click
+- **How it's calculated**: (Number of emails with clicks ÷ Total emails sent) × 100
+- **Why it matters**: Measures the effectiveness of your email content and call-to-action buttons
+- **Industry benchmark**: Usually between 2-5% for most campaigns
+
+#### Click-to-Open Rate
+
+- **What it shows**: The percentage of opened emails that resulted in at least one click
+- **How it's calculated**: (Number of emails with clicks ÷ Number of opened emails) × 100
+- **Why it matters**: Shows how compelling your email content is to engaged readers
+- **Industry benchmark**: Typically 10-20% for well-performing campaigns
+
+### Subscribers Section
+
+This section provides detailed information about individual subscribers.
+
+## Interpreting Your Analytics
+
+### High Performance Indicators
+
+- **Open Rate > 20%**: Your subject lines are compelling and your sender reputation is good
+- **Click Rate > 3%**: Your email content is engaging and calls-to-action are effective
+- **Click-to-Open Rate > 15%**: Your email content resonates well with your audience
+
+### Areas for Improvement
+
+- **Low Open Rate**: Consider improving subject lines, sender name, or timing
+- **Low Click Rate**: Review your email content, design, and call-to-action placement
+- **Low Click-to-Open Rate**: Focus on making your content more compelling for engaged readers
+
+## Next Steps
+
+Now that you understand your email analytics, you can:
+
+- [Send a broadcasts](/en/email-marketing/broadcasts)
+- [Set up automated email sequences](/en/email-marketing/sequences)
+
+## Stuck Somewhere?
+
+We are always here for you. Come chat with us in our <a href="https://discord.com/invite/GR4bQsN" target="_blank">Discord</a> channel or send a tweet to <a href="https://twitter.com/courselit" target="_blank">@CourseLit</a>.

apps/docs/src/pages/en/email-marketing/broadcasts.md

@@ -64,11 +64,14 @@ Click the `Schedule` button to see an additional input box to enter the date and
 
 Once an email is scheduled, you will see the time it will be sent at the bottom, as shown below. Simply click the `Cancel sending` button to cancel the scheduled send.
 
-![Cancel Scheduled Mail](/assets/emails/scheduled-mail.jpeg)
+![Cancel Scheduled Mail](/assets/emails/scheduled-mail.png)
 
-## Next Step
+## Next Steps
 
-Let's see how to send automated email campaigns (also known as sequences) when something happens in your school. [Click here](/en/email-marketing/sequences).
+Now that you understand how to send broadcasts, you can also see:
+
+- [Set up automated email sequences](/en/email-marketing/sequences)
+- [Track your email performance with analytics](/en/email-marketing/analytics)
 
 ## Stuck Somewhere?
 

apps/docs/src/pages/en/email-marketing/introduction.md

@@ -20,9 +20,12 @@ Send one-off emails to selected recipients for quick updates or newsletters.
 
 Automatically send a series of emails triggered by specific events in the system.
 
-## Next Step
+## Next Steps
 
-Learn [how to send broadcast emails](/en/email-marketing/broadcasts) to your audience.
+Now that you understand the email marketing capabilities, you can:
+
+- [Send broadcast emails](/en/email-marketing/broadcasts)
+- [Set up automated email sequences](/en/email-marketing/sequences)
 
 ## Stuck Somewhere?
 

apps/docs/src/pages/en/email-marketing/sequences.md

@@ -24,7 +24,11 @@ Here, you will see all the sequences you have configured.
 
 1. Click the `New sequence` button on the right, in the `Sequences` hub.
 
-2. Let's get acquainted with the interface. In the following image, we have marked all the sections. To see the description of a section, note its number in the screenshot and find its description below.
+You will be redirected to the sequence compose screen. The active tab will be `Compose`.
+
+2. Let's get acquainted with the interface.
+
+In the following image, we have marked all the sections. To see the description of a section, note its number in the screenshot and find its description below.
 
     -   1. **Sequence Name**: The internal name of the sequence.
     -   2. **From**: The sender's name that is displayed in the emails sent.
@@ -47,15 +51,20 @@ Here, you will see all the sequences you have configured.
 
 4. Start adding emails to this sequence. When you create a new sequence, an empty email is added to it by default.
 
+    ![Sequence add email](/assets/emails/compose-sequence-add-email.jpeg)
+
 5. Let's understand what information an email row shows:
 
+    ![Sequence email row](/assets/emails/compose-sequence-email-row.jpeg)
+
     -   1. **Delay Since the Last Sent Email**: This shows the time to wait (in days) since the last email before dispatching this email.
     -   2. **Subject**: The subject of the email.
-    -   3. **Context Menu**: Contains options like `Delete`, etc.
+    -   3. **Published**: The status of the email. Only published emails are sent to users.
+    -   4. **Context Menu**: Contains options like `Delete`, etc.
 
     > The default email has `0 days` as the delay, which means the email will be sent immediately after the user enters the sequence, as it is the first email in the sequence.
 
-6. To edit the body of an email, click on the subject. This will open the email compose screen as shown below.
+6. To edit an email, click on the subject. This will open the email compose screen as shown below.
 
 7. Let's get acquainted with the email compose interface:
 
@@ -90,9 +99,12 @@ Here, you will see all the sequences you have configured.
 11. Add more emails to the sequence by clicking on the `New email` button.
 12. Keep editing your sequence until you think it's perfect. Once you are satisfied with your sequence, hit the `Start` button to begin sending this sequence to users.
 
-## Next Step
+## Next Steps
+
+Now that you understand how to create email sequences, you can also see:
 
-Let's see how you can create and edit your website's pages. [Click here](/en/pages/introduction).
+- [Send one-off broadcasts](/en/email-marketing/broadcasts)
+- [Track your email performance with analytics](/en/email-marketing/analytics)
 
 ## Stuck Somewhere?