Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Blog] Practical alerts examples #10147

Open
wants to merge 19 commits into
base: master
Choose a base branch
from
Open

[Blog] Practical alerts examples #10147

wants to merge 19 commits into from

Conversation

bijanbwb
Copy link
Contributor

@bijanbwb bijanbwb commented Dec 16, 2024

Changes

Blog post about our new Alerts features with some practical examples.

Checklist

  • Words are spelled using American English
  • Titles are in sentence case
  • Feature names are in sentence case too
  • Use relative URLs for internal links
  • If I moved a page, I added a redirect in vercel.json
  • Remove this template if you're not going to fill it out!

Article checklist

  • I've added (at least) 3-5 internal links to this new article
  • I've added keywords for this page to the rank tracker in Ahrefs
  • I've checked the preview build of the article
  • The date on the article is today's date
  • I've added this to the relevant "Tutorials and guides" docs page (if applicable)

Useful resources

@bijanbwb bijanbwb self-assigned this Dec 16, 2024
Copy link

vercel bot commented Dec 16, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
posthog 🛑 Canceled (Inspect) Dec 20, 2024 2:28pm

@bijanbwb bijanbwb changed the title [WIP] Blog Post: Practical alerts examples Blog Post: Practical alerts examples Dec 18, 2024
@bijanbwb bijanbwb marked this pull request as ready for review December 18, 2024 16:26
- Product updates
---

To keep life interesting, it's important to live in a state of perpetual ignorance. When things are going well, there's no need to find out why. When things go south, let anxiety run its course.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wrote this as a fun, funny introduction. But if it doesn't land then it's no big deal to me if we want to rip it out and start with the "PostHog's new alert features..." line below.

@andyvan-ph andyvan-ph self-requested a review December 19, 2024 11:05
@bijanbwb bijanbwb changed the title Blog Post: Practical alerts examples [Blog] Practical alerts examples Dec 19, 2024
Copy link
Contributor

@ivanagas ivanagas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some good stuff here, but would love to see more depth and practicality.

How are we (and/or beta users) actually using alerts? What are some specific examples?

You shouldn't gloss over capturing events as part of the process either.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Worth thinking about how we are going to promote this piece, likely needs some solid backlinks to help people find their way there.

Could we plan a social post/thread for it?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good call. I think we could probably pick out the most compelling example(s) and share those on social.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1. Should link from the Alerts docs for a start. Could probably add to some product analytics pages.

We can also turn the individual ideas into social posts.

contents/blog/practical-alerts.mdx Outdated Show resolved Hide resolved
contents/blog/practical-alerts.mdx Outdated Show resolved Hide resolved
contents/blog/practical-alerts.mdx Outdated Show resolved Hide resolved
contents/blog/practical-alerts.mdx Outdated Show resolved Hide resolved
Comment on lines +117 to +118
![Simpson, you've got a 513](https://frinkiac.com/meme/S08E23/385084.jpg?b64lines=U0lNUFNPTiwgWU9VJ1ZFIEdPVCBBIDUxMyE=)
![That got it](https://frinkiac.com/video/S08E23/XOUcScbq8W_7yoA6nti16cCC31A=.gif)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A lot of gif and they aren't the same size which is a bit jarring

  1. I think the <ProductImage> component centers them
  2. If not, the second one might just be fine.


We can set the frequency to check this daily. For critical alerts like this, you can add more than one email to the notification list and ensure the entire billing team receives the alert.

### 4. Monitor deploys and new features
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This whole section is a bit too vague, what are some specific ways they can use alerts to make sure their deploy goes well? Also, what are the most important alerts to set up?


So you can set up an alert that coincides with the launch of a redesigned page and verify that the number of CTA clicks should hopefully be increasing, not decreasing.

### 5. Alert on changes in conversion rates
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good section

classes="rounded"
/>

### 6. Alert on breakdown in referral sources
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is basically the same as the first one

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right. I think the differentiation for this one was just to show that you can create alerts for trends that have a breakdown. But I'll take another look and see if there's a way to further differentiate. It's a decent example that was mentioned in the GitHub issue, but you're right it could be redundant.

contents/blog/practical-alerts.mdx Outdated Show resolved Hide resolved
Copy link
Contributor

@andyvan-ph andyvan-ph left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is looking good so far. Left a few additional suggestions. As per comment, I feel like the 404 one could be a bit simpler.

- Product updates
---

To keep life interesting, it's important to live in a state of perpetual ignorance. When things are going well, there's no need to find out why. When things go downhill, let anxiety run its course.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is great, btw. Love a bit of humor as a starter!

contents/blog/practical-alerts.mdx Outdated Show resolved Hide resolved
contents/blog/practical-alerts.mdx Outdated Show resolved Hide resolved

Instead of needing to manually check insights, you can track important metrics and get email notifications when they cross a threshold that you specify. The threshold can be an absolute value (e.g. pageviews exceeded 1,000) or a relative amount (e.g. conversion rate increased by 10%).

To show you how you can use alerts, we'll start by showing how to create an alert and then dive into practical examples and use cases.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here are some ideas for how you can use alerts, so you're never caught out again.

contents/blog/practical-alerts.mdx Outdated Show resolved Hide resolved

These kinds of alerts can also be useful when traffic spikes are unexpected. We often see this at PostHog when our content gets featured in a popular email newsletter or shared on Hacker News. When we notice an influx of new signups, it can be fun to dig in and try to figure out where they came from.

For example, we can set up an alert when the number of pageviews for our [pricing page](/pricing) rises above 8,000 views for the week. First, we [create a new trend insight](/docs/product-analytics/trends/overview#1-creating-a-new-trend) to track pageviews where "Path Name" equals "/pricing". Then, filter by the year-to-date and group by week.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1 Ian's point.

Additional suggestion: could you add a screenshot of a fully-configured alert for each example? I think this will help people grok what it looks like and how to make their own.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1. Should link from the Alerts docs for a start. Could probably add to some product analytics pages.

We can also turn the individual ideas into social posts.


![Pricing pageviews alert](https://res.cloudinary.com/dmukukwp6/image/upload/posthog_alert_df58e89828.png)

### 2. Get notified for 404 page anomalies
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fwiw, I feel like the 404 section is a bit on the long side. Would be good if you could simplify a little.


Alerts are currently available for trends insights. But we're currently working on adding alerts for [funnels](/docs/product-analytics/funnels), which will make it easier to track conversions across various stages. For example, we can create a funnel to see how many users are following through and signing up after visiting our pricing page.

Thanks to [Anirudh](/community/profiles/30974) for making this much-requested feature a reality. The idea for threshold-based alerts started as a [GitHub issue](https://github.com/PostHog/posthog/issues/14331), so if you have other interesting use cases and suggestions for how to improve the features, be sure to let us know!
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I really like this point

@@ -0,0 +1,165 @@
---
title: '6 practical uses for PostHog alerts'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't love this headline. We should workshop some ideas before we go live

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants