Skip to content

Commit c69d94c

Browse files
kmt901PostHog
andauthored
Add cookieless tracking section in implementation tracking for customer health checks (#14082)
* Add cookieless tracking section in health-checks.md * Update health-checks.md * Fix typos --------- Co-authored-by: PostHog <[email protected]>
1 parent bc5f102 commit c69d94c

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

contents/handbook/cs-and-onboarding/health-checks.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,24 @@ It is best practice for a customer to use PostHog's [Managed Reverse Proxy](/doc
8383

8484
When using either PostHog's managed reverse proxy or deploying a [non-managed reverse proxy](/docs/advanced/proxy#deploying-a-reverse-proxy), events should populate the "Library custom API host" property. Host mapping and domains can potentially be seen in Metabase. You should verify the setup with a customer.
8585

86+
### Cookieless tracking
87+
88+
If a customer mentions their user/event count seems to be missing a lot of data from their website, ask them if they have implemented cookie opt-in and to share the part of their code where PostHog is initialized. Some customers may not be aware that we have specific recommendations for how to initiatlize PostHog for [cookieless tracking](/tutorials/cookieless-tracking).
89+
90+
For example, if they implement PostHog on their website similar to as follows:
91+
```
92+
posthog.init(...,
93+
opt_out_capturing_by_default: true
94+
)
95+
96+
if (cookiePreference === 'accepted') {
97+
posthog.opt_in_capturing()
98+
}
99+
```
100+
101+
They will not be capturing anything for customers who visit their website and opt-out of cookies or ignore the cookie banner completely. We recommend instead they use the `cookieless_mode` parameter in their initializer as outlined in the [cookieless tracking tutorial](/tutorials/cookieless-tracking). If the customer wants to move forward with implementing cookieless mode, ensure they enable "Cookieless server hash mode" in their project settings under Project Settings > Web analytics.
102+
103+
Cookieless mode can help them have more accurate tracking totals because when using cookieless tracking, the PostHog SDK will generate a privacy-preserving hash, calculated on our servers.
86104

87105
## Are feature flags resilient?
88106

0 commit comments

Comments
 (0)