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.

Sign up for GitHub

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

Docs: Web analytics dashboard #8150

Merged
merged 4 commits into from
Mar 28, 2024
Merged

Docs: Web analytics dashboard #8150

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
5f3fe5a
web analytics dashboard
ivanagas Mar 27, 2024
aa5ffec
links, formatting
ivanagas Mar 27, 2024
f35043a
Add channel type page in the docs
robbie-c Mar 28, 2024
abf1e1c
slight cleanup to use less words
ivanagas Mar 28, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion contents/customers/creatify.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ When the PostHog web analytics beta launched in November 2023, Creatify was amon
/>
</BorderWrapper>

The team watched with anticipation over the following months as the beta grew and new features released, often sharing feedback to ensure the dashboard included the metrics they cared about most. When this wasn’t possible they simply created their own product analytics dashboards to break down the data in new ways.
The team watched with anticipation over the following months as the beta grew and new features released, often sharing feedback to ensure the [dashboard](/docs/web-analytics/dashboard) included the metrics they cared about most. When this wasn’t possible they simply created their own product analytics dashboards to break down the data in new ways.

“I don’t think I could ever go back to GA4 now that we’ve adopted PostHog,” said Xin. “Web analytics gives us all the metrics we really care about, and we’ve set up dashboards for breaking down specific segments when we need to. It’s great that we have all the metrics we care about so readily available.”

Expand Down
2 changes: 1 addition & 1 deletion contents/customers/significa.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ When it came to web analytics, Significa used to rely on Plausible. But, as the

## Web analytics was just the beginning

Web analytics in PostHog is similar to Plausible – it’s centered around a single, clear dashboard that summarizes relevant traffic data – Significa wanted the ability to go deeper.
Web analytics in PostHog is similar to Plausible – it’s centered around [a single, clear dashboard](/docs/web-analytics/dashboard) that summarizes relevant traffic data – Significa wanted the ability to go deeper.

“We were using Plausible but it doesn’t really have any cool features to analyze data more deeply,” said Tomás. “PostHog, on the other hand, enables us to analyze our traffic in more ways and to set up funnels when we need to.”

Expand Down
93 changes: 93 additions & 0 deletions contents/docs/data/channel-type.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
---
Copy link
Member

Choose a reason for hiding this comment

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

Added this page

title: Channel type
sidebar: Docs
showTitle: true
availability:
free: full
selfServe: full
enterprise: full
---

Channel type is the type of acquisition channel the user came from, for example:

| Channel Type | Description of where the user came from |
|------------------|---------------------------------------------------------------------------------|
| Direct | User typed in the URL directly or used a saved link. |
| Paid Search | An ad from a search engine, e.g. Google, Bing, or Baidu. |
| Paid Social | An ad from a social media platform, e.g. Facebook, LinkedIn, or Twitter |
| Paid Video | An ad from a video platform, e.g. YouTube or Twitch. |
| Paid Shopping | An ad from a shopping platform, e.g. Amazon or eBay. |
| Paid Other | An ad from an unknown platform. |
| Cross-Network | A cross-network ad |
| Organic Search | A non-ad search result from a search engine, e.g. Google, Bing, or Baidu. |
| Organic Social | A non-ad link from a social media platform, e.g. Facebook, LinkedIn, or Twitter |
| Organic Video | A non-ad link from a video platform, e.g. YouTube or TikTok. |
| Organic Shopping | A non-ad link from a shopping platform, e.g. Amazon or eBay. |
| Affiliate | An affiliate link. |
| Referral | A referral link. |
| Email | A link from an email. |
| Display | A display ad, e.g. an ad on Google Display Network. |
| SMS | A link from an SMS. |
| Audio | An audio ad, e.g. a podcast ad. |
| Push | A push notification. |
| Other | A link from an unknown source. |

It is calculated using the referring domain, [UTM tags](/docs/data/utm-segmentation), and advertising IDs that are present in the URL when the user first lands on your website,.

### Channel type calculation

Traffic is considered "Paid" if any of the following are true:

* `utm_medium` is one of `cpc`, `cpm`, `cpv`, `cpa`, `ppc` or `retargeting`
* `utm_medium` starts with `paid`
* Either `gclid` or `gad_source` is present

We use a list of known values for `referring_domain`, `utm_source`, and `utm_medium`, which you can view in the [source code](https://github.com/PostHog/posthog/blob/master/posthog/models/channel_type/channel_definitions.json).

These rules are applied in order, and the first one that matches is used to determine the channel type.

| Channel Type | Logic |
|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
| Cross Network | `utm_campaign` equals `cross-network` |
| Paid Search | Traffic is paid, and `utm_source` matches our list of search sources (e.g. `google`, `bing`, `duckduckgo`) |
| Paid Social | Traffic is paid, and `utm_source` matches our list of social sources (e.g. `facebook`, `linkedin`, `twitter`) |
| Paid Video | Traffic is paid, and `utm_source` matches our list of video sources (e.g. `youtube`, `twitch`, `disneyplus`) |
| Paid Shopping | Traffic is paid, and `utm_source` matches our list of shopping sources (e.g. `amazon`, `etsy`, `ebay`) |
| Paid Search | Traffic is paid, and `referring_domain` matches our list of search sources (e.g. `google.com`, `bing.com`, `duckduckgo.com`) |
| Paid Social | Traffic is paid, and `referring_domain` matches our list of social sources (e.g. `facebook.com`, `linkedin.com`, `twitter.com`) |
| Paid Video | Traffic is paid, and `referring_domain` matches our list of video sources (e.g. `youtube.com`, `twitch.tv`, `disneyplus.com`) |
| Paid Shopping | Traffic is paid, and `referring_domain` matches our list of shopping sources (e.g. `amazon.com`, `etsy.com`, `ebay.co.uk`) |
| Paid Shopping | Traffic is paid, and `utm_campaign` matches the regular expression `^(.*(([^a-df-z]|^)shop|shopping).*)$`|
| Paid Social | Traffic is paid, and `utm_medium` matches our list of social mediums (e.g. `sm`, `social-media`, `social-network`) |
| Paid Video | Traffic is paid, and `utm_medium` matches our list of video mediums (e.g. `video`) |
| Display | Traffic is paid, and `utm_medium` matches our list of display mediums (e.g. `display`, `interstitial`, `banner`) |
| Paid Search | Traffic is paid, and `gad_source` equals `1` |
| Paid Video | Traffic is paid, and `utm_campaign` matches the regular expression `^(.*video.*)$` |
| Paid Other | Traffic is paid |
| Direct | Referring domain is the special value `$direct`, and `utm_medium` is not set, and `utm_source` is either empty or equal to `direct` or `(direct)` |
| Organic Search | `utm_source` matches our list of search sources (e.g. `google`, `bing`, `duckduckgo`) |
| Organic Social | `utm_source` matches our list of social sources (e.g. `facebook`, `linkedin`, `twitter`) |
| Organic Video | `utm_source` matches our list of video sources (e.g. `youtube`, `twitch`, `disneyplus`) |
| Organic Shopping | `utm_source` matches our list of shopping sources (e.g. `amazon`, `etsy`, `ebay`) |
| Email | `utm_source` matches our list of email sources (e.g. `email`, `e_mail`, `e-mail`) |
| SMS | `utm_source` matches our list of SMS sources (e.g. `sms`) |
| Push | `utm_source` matches our list of SMS sources (e.g. `firebase`) |
| Organic Search | `referring_domain` matches our list of search sources (e.g. `google.com`, `bing.com`, `duckduckgo.com`) |
| Organic Social | `referring_domain` matches our list of social sources (e.g. `facebook.com`, `linkedin.com`, `twitter.com`) |
| Organic Video | `referring_domain` matches our list of video sources (e.g. `youtube.com`, `twitch.tv`, `disneyplus.com`) |
| Organic Shopping | `referring_domain` matches our list of shopping sources (e.g. `amazon.com`, `etsy.com`, `ebay.co.uk`) |
| Organic Shopping | `utm_campaign` matches the regular expression `^(.*(([^a-df-z]|^)shop|shopping).*)$`|
| Organic Social | `utm_medium` matches our list of social mediums (e.g. `sm`, `social-media`, `social-network`) |
| Organic Video | `utm_medium` matches our list of video mediums (e.g. `video`) |
| Affiliate | `utm_medium` matches our list of affiliate mediums (e.g. `affiliate`) |
| Referral | `utm_medium` matches our list of referral mediums (e.g. `referral`, `link`, `app`) |
| Email | `utm_medium` matches our list of email mediums (e.g. `email`, `e_mail`, `e-mail`) |
| Display | `utm_medium` matches our list of display mediums (e.g. `display`, `cpm`, `interstitial`, `banner`) |
| Audio | `utm_medium` matches our list of referral mediums (e.g. `audio`) |
| Push | `utm_medium` matches our list of referral mediums (e.g. `push`, `notification`, `mobile`) |
| Organic Video | `utm_campaign` matches the regular expression `^(.*video.*)$` |
| Push | `utm_medium` ends with `push` |
| Other | No previous rule matched |

If you would to be able to customise this logic, please upvote [this issue](https://github.com/PostHog/posthog/issues/21195). Our definitions were based on the [definitions that GA4 uses](https://support.google.com/analytics/answer/9756891?hl=en), but added our own logic to handle some edge cases they don't.

3 changes: 3 additions & 0 deletions contents/docs/glossary.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,9 @@ Business to customer. It's when you make money by selling things or services to
#### BAA
Business Associate Agreement, or also known as a Business Associate Contract. It's a legal document signed by contractors who may have to handle [personal health information](/manual/glossary#PHI) in order to agree to and satisfy the requirements of [HIPAA](/manual/glossary#HIPAA). [Find out more about PostHog and HIPAA](/docs/privacy/hipaa-compliance).

#### Bounce rate
A bounce is a session where the user only had one pageview, no autocaptures, and spent less than 30 seconds on the page. Your bounce rate is the percentage of sessions that resulted in a bounce. Used on the [web analytics dashboard](/docs/web-analytics/dashboard).

## C

#### CAC
Expand Down
Loading
Loading