Show page

Differences

This shows you the differences between two versions of the page.

--- se:labs:06 [2024/11/19 12:23]
cosmin.dumitrache
+++ se:labs:06 [2024/11/21 16:07] (current)
cosmin.dumitrache [Tasks]
@@ Line 1: / Line 1: @@
 ====== Lab 06 - Analytics ======
-<hidden>
 ==== Introduction ====
@@ Line 13: / Line 13: @@
 {{:se:labs:posthog-intro.png?700|}}
-You are going to take the Todo List App built with Next.js in one of the previous labs and hook it up to PostHog via the tool's Javascript SDK in order to send analytics data. You will then be able to look at this data PostHog.
+You are going to take the Todo List App built with Next.js in one of the previous labs and hook it up to PostHog via the tool's Javascript SDK in order to send analytics data. You will then be able to examine this data in PostHog.
 {{:se:labs:posthog-integration-diagram.png?700|}}
@@ Line 19: / Line 19: @@
 ==== Configuring PostHog ====
-First, create a PostHog account (it's free within generous limits) on their website.
+First, create a PostHog account (it's free within generous limits). Go to the [[https://posthog.com/|PostHog website here]].
 {{:se:labs:posthog-signup.png?400|}}
@@ Line 33: / Line 33: @@
 {{:se:labs:posthog-install.png?600|}}
-Then at the Configure step make sure to activate all options (including session recordings).
+Then at the **Configure** step make sure to activate all options (including session recordings).
 {{:se:labs:posthog-options.png?600|}}
@@ Line 39: / Line 39: @@
 Click next to finish the onboarding. You should be all setup now.
-==== 1. Segment ====
+==== 1. Product analytics ====
-Segment is a tool that collects events from your app and provides a complete data toolkit. It gives you a uniform API to send event data to all the other tools we'll be using. This way you only have to integrate the data collection once, and Segment will then forward that data to all the other analytics tools you want to use.
+The **Product analytics** tool allows you to get insights into how users use your product. You can build things like: funnels, graphs & trends, user paths, retention diagrams etc.
-{{:se:labs:segment-dash.png?700|}}
+In this lab we are going to build a conversion funnel for our **Todo List App** (which has been augmented for this lab to include a landing page and a login screen). The steps in funnel are as follows:
+  - LandingPage -  when a user loads the the landing page (/)
+  - Login - when a user clicks the **Get started for free** button and gets sent to the login screen (/login)
+  - Dashboard - when a user clicks the **Sign in** button and gets sent to the dashboard (todo list) screen (/dashboard)
+  - AddTodo - when a user clicks the **Add** button and adds a new todo item to the list
-For the purposes of this lab you will need to add a JS source to segment which will be represented by our Next.js app. The most elegant way to do this for Next.js is via the @segment/snippet npm plugin.
+This is what our product funnels should look like at the end. It shows how many users got to each stage of the funnel.
-Add the package to your project.
+{{:se:labs:posthog-funnel.png?700|}}
+Notice that the deeper we go into the funnel, the less users we have that make it to that step. This allows us to identify bottlenecks in our product experience and then focus on the step where most users drop off.
+In order to build this funnel we need to send some additional information to PostHog.
+First let's **capture** the custom events in our funnel. Check out [[https://posthog.com/docs/product-analytics/capture-events|Capturing events]] documentation.
+Add capture events for all the steps in the funnel: LandingPage, Login, Dashboard, AddTodo.
 <code>
-npm install --save @segment/snippet
+posthog.capture('LandingPage');
 </code>
-Then include the script in our Next.js app by creating _document.jsx under your pages directory.
+Then let's also **identify** the users making the event. Check out [[https://posthog.com/docs/product-analytics/identify|Identifying users]] documentation. By default PostHog will track users by browser session but we can send additional information like a user id when a user logs in to help track users across multiple browsers/devices.
+Add an identify event when the user logs in.
 <code>
-import Document, { Html, Head, Main, NextScript } from 'next/document'
+posthog.identify(name, {name: name}); // using name in palace of an actual user ID for simplicity in this lab
+</code>
-// import Segment Snippet
+You can simulate multiple users by using incognito windows and different usernames. Generate some events for each users such that some user go through the funnel deeper than others. This should produce a funnel like in the diagram above.
-import * as snippet from '@segment/snippet';
-class MyDocument extends Document {
+<note important>
-  renderSnippet() {
+You can use the **Activity**, **People** and **Data** sections to make sure data is being received correctly. Note that there might some some small delays sometimes (minutes) between your app sending the data and it showing in PostHog.
-    const opts = {
-        apiKey: 'YOUR-SEGMENT-API-KEY',
-        page: true
-    }
-    return snippet.max(opts);
-  }
-  static async getInitialProps(ctx) {
+{{:se:labs:posthog-activity.png?600|}}
-    const initialProps = await Document.getInitialProps(ctx)
-    return { ...initialProps }
-  }
-  render() {
+</note>
-    return (
-      <Html>
-        <Head>
-            {/* Inject the Segment snippet into the head of the document */}
-            <script dangerouslySetInnerHTML={{ __html: this.renderSnippet() }} />
-        </Head>
-        <body>
-          <Main />
-          <NextScript />
-        </body>
-      </Html>
-    )
-  }
-}
-export default MyDocument
+==== 2. Web analytics ====
-</code>
-Use the Segment debugger to know if your app actually connects to Segment.
+The **Web analytics** tool allows you to automatically collect standard web analytics. You can view things like: pageviews, sessions, unique visitors, top pages & payhs, device & location and channels.
-{{:se:labs:segment-debugger.png?700|}}
+If you have configured PostHog in the previous step you do not have to do anything else. Have a look around after you've generated some activity in the app.
-Your will now be able to call Segment functions like global.analytics.track(). Check out the [[https://segment.com/docs/connections/spec/|Segment docs for details here]].
+{{:se:labs:posthog-web.png?700|}}
-For this lab we will want to use Track to know when a user clicked on a task and Identify to associated some user details to the tracked events in order to know who did what.
+==== 3. Session replay ====
-==== 2. Amplitude ====
+The section **Session replay** tool shows you screen captures of user sessions so that you can more easily figure out how users actually use your product. You can also see things like: event timeline, console logs and network requests.
-Amplitude is a great tool for understanding user event data in a quantitative way. You can easily build many types of charts like product funnels, retention charts, or north star metrics charts.
+If you have have configured PostHog in the previous step (and enabled session replay at the configure step) you do not have to do anything else.
-{{:se:labs:amplitude-dash.png?700|}}
+{{:se:labs:posthog-session-replay.png?700|}}
-<note important>
+Try viewing some user sessions. Notice that the user session is labeled with the username you supplied via **posthog.identify()**. And also notice in the timeline bar below the session that you have indicators showing when the user triggered one of your custom events via **posthog.capture()** (such as the Login event in the picture above).
-When adding the Amplitude destination to Segment use Actions mode. It's easier to configure for the purposes of this lab.
-{{:se:labs:amplitude-hint.png?600|}}
+====== Tasks ======
-</note>
-==== 3. Fullstory ====
-Fullstory is a great tool to understand your user event data in a more qualitative way via its screen recording feature. This can be used to understand exactly how users interact with your user interface every step of the way.
+Use this Todo List App built with Next.js as a starting point: {{:se:labs:se-analytics-lab-starter.zip|}}
-{{:se:labs:fullstory-dash.png?700|}}
+It's essentially the same Todo List App you built in the backend lab but we've added a couple more screens: a landing page and a login page.
-<note important>
+. Configure the app so that it sends data to PostHog succesfully.
-When adding the Amplitude destination to Segment use Classic mode. It's easier to configure for the purposes of this lab.
-{{:se:labs:fullstory-hint.png?600|}}
+. Add **posthog.capture()** and **posthog.identify()** so that you can track our custom events: LandingPage, Login, Dashboard, AddTodo.
-</note>
-====== Tasks ======
-Use the app you built in the previous lab as a starting point: {{:se:labs:se-lab5-slutions.zip|}}
+. Simulate some user sessions (at least 3) to get some data into PostHog. You can use incognito windows to achieve this. Make sure that data is being received in the **Activity** section.
-. Configure the app so that it sends data to Segment. Add Track and Identify events and make sure your see them in the Segment debugger for your source.
+. Build a funnel with our steps (LandingPage, Login, Dashboard, AddTodo) in the **Product analytics** tool.
-. Connect Segment to Amplitude and create some charts for task click events. Then try to creare a funnel: main page > tasks page > task click.
+. Have a look at **Web abalytics**. There should be some data in there.
-. Connect Segment to Fullstory and view a screen recording.
+. Have a look at **Session recording**. You should see some recordings.
-. [Bonus] Install Google Analytics without using Segment
+. [Bonus] Create some other types of charts in **Product analytics** and/or add some more custom events on the todo list (editing item, deleting item, marking done, marking undone).
 <note important>
 To avoid some common pitfalls please please consider:
-. Run your app in incognito mode to avoid any interference from browser plugins like ad blockers that might prevent event data from being sent to Segment.
+. Run your app in incognito mode to avoid any interference from browser plugins like ad blockers that might prevent event data from being sent to PostHog.
-. Try doing a shift+refresh to force a hard page refresh of your app (no use of cached JS files). In some cases, after you make some changes to the Segment config, this might be needed.
+. If you don't see data in PostHog immediately (when trying to build charts) please allow a few minutes for PostHog to do some post-processing. Also, the EU region seems to be faster than the US region. Consider selecting EU when you create your account.
+. Try doing a shift+refresh to force a hard page refresh of your app. In some cases, after you make some changes, this might be needed.
 </note>
 ====== Feedback ======
 Please take a minute to fill in the **[[https://forms.gle/PNZYNNZFrVChLjag8 | feedback form]]** for this lab.
-</hidden>

General Information

Lectures

Labs

Resources

Assignment

Project

se/labs/06.1732011818.txt.gz · Last modified: 2024/11/19 12:23 by cosmin.dumitrache

Show page Old revisions

Media Manager Back to top