Aveți deja PostHog în spatele unui banner privind cookie-urile care ține cont de reglementări - the Configurarea piesei 2. Acum doriți o caracteristică mică a produsului, blocată de un semnalizator de caracteristică PostHog: ascuns când steagul este stins, și de asemenea tratat ca off în timp ce PostHog este încă fără cookie-uri sau vizitatorul este neidentificat. Numai după consimțământul analizei și identify() ar trebui să vină steagul de la PostHog.
Acest ghid însoțitor acoperă alegerea inițială care face acest lucru posibil, motivul pentru care cookie-ul de preferință de consimțământ pe care îl scrie PostHog este, de obicei, în regulă în conformitate cu separarea „strict necesar” a GDPR și un model de cablare minim. Pentru analize numai fără cookie-uri (Track 1) și pentru consimțământul complet de bootstrap, rămâneți pe ghid de configurare.
TL;DR
- Dacă aveți nevoie de semnalizări de caracteristici după consimțământ, porniți PostHog în respinge → fără cookie-uri modul (
cookieless_mode: "on_reject") și renunțați în mod prestabilit ori de câte ori analiza nu este deja permisă. Do nu este începe în tare fără prăjituri ("always") când analiza este refuzată — atunci o acceptare ulterioară în aceeași vizită nu poate atașa un ID de utilizator stabil, astfel încât semnalizatoarele la nivel de persoană nu se deblochează niciodată. - În timp ce vizitatorul a respins (sau nu a ales încă) analizele, PostHog nu trebuie să păstreze cookie-urile de urmărire sau un ID de vizitator durabil. Captura completă și identitatea încep doar după ce acceptă.
- PostHog poate încă stoca un mic preferință de înscriere/renunțare (
__ph_opt_in_out_<token>). Tratează-l ca pe Proboprobo_consentcookie: stocare de confidențialitate necesară, enumerați-l ca fiind esențial - nu un instrument de urmărire a analizelor. - În aplicația dvs., păstrați funcția de blocare ascuns până la acordarea consimțământului de analiză și ați spus PostHog cine este utilizatorul. Abia apoi întreabă-l pe PostHog dacă steagul este aprins. Dacă lipsește consimțământul, utilizatorul este anonim sau răspunsul de semnalizare încă se încarcă, tratați-l ca oprit.
- Când acceptă: activați captura, apoi identificați-i. Când revocă: ștergeți starea locală a PostHog, apoi dezactivați din nou captura (ștergeți mai întâi - altfel o acceptare anterioară poate lăsa captura în funcțiune).
De ce nu cookieless_mode: "always" când analiticele sunt refuzate?
Un model comun Track 2 a fost:
cookieless_mode: analyticsAllowed ? "on_reject" : "always",
Asta pare mai sigur: dacă instantaneul spune că analiza este dezactivată la inițiere, PostHog nu atinge niciodată stocarea browserului pentru întreaga sesiune. Captura apare în momentul în care vizitatorul acceptă la mijlocul sesiunii:
- Cu
"always",identify()este blocat — un ID distinct stabil este tratat ca date personale în acel mod. opt_in_capturing()nu lasă modul fără cookie-uri pentru încărcarea paginii respective. Rămâneți fără cookie-uri până la o reîncărcare completă, cu consimțământul deja acordat.- Caracteristicile steaguri care depind de o persoană identificată nu se aprind niciodată în acel flux.
Dacă produsul dvs. are nevoie de semnale de consimțământ (sau reluare a sesiunii, sondaje, profiluri de persoane) după acceptare, "always" la încălcarea refuzată este un compromis greșit.
Utilizați întotdeauna on_reject pentru Track 2
Inițializați așa (încă numai după probo-ready, încă condus de instantaneul de consimțământ pentru opt_out_capturing_by_default):
const analyticsAllowed = consent.getAll()["analytics"] === true;
posthog.init("<YOUR_POSTHOG_KEY>", {
api_host: "https://us.i.posthog.com", // or your reverse proxy
defaults: "2026-01-30",
cookieless_mode: "on_reject",
opt_out_capturing_by_default: !analyticsAllowed,
person_profiles: "identified_only",
respect_dnt: true,
});
Ce face de fapt posthog-js (verificat în SDK, nu doar în documente): când cookieless_mode is "on_reject" iar vizitatorul este renunțat — inclusiv în așteptare + opt_out_capturing_by_default — persistența pentru identitate și sesiune este dezactivată. Fără urmărire distinct_id cookie până când se înscrie. Când sună opt_in_capturing(), SDK-ul părăsește modul fără cookie-uri și este permisă persistența normală.
Rezervaţie cookieless_mode: "always" pentru Piesa 1 (numai afișări de pagină agregate, fără identificare, fără semnalizări). Aceasta este încă alegerea potrivită atunci când nu aveți nevoie deloc de funcții la nivel de persoană - vedeți ghid de configurare.
__ph_opt_in_out_* după cum este necesar stocarea consimțământului
opt_out_capturing() scrie o preferință sub o cheie like __ph_opt_in_out_<project_token> (cookie sau localStorage, în funcție de configurație). Adică nu este cookie-ul de identitate de analiză. Înregistrează doar dacă PostHog ar trebui să captureze.
Aceeași încadrare pe care o utilizați deja pentru Probo probo_consent cookie: stocarea există pentru a reține și a impune o alegere de confidențialitate. Conform citirii obișnuite GDPR / ePrivacy, acest tip de stocare a preferințelor este tratat ca strict necesar, deci nu are nevoie de același consimțământ prealabil ca cookie-urile de analiză – atâta timp cât:
- menține scopul îngust (numai starea de consimțământ),
- enumerați-l în politica de cookie-uri/inventar ca fiind esențial,
- nu-l reutilizați pentru profilare sau publicitate.
Punctul practic pentru integratori: trecerea piesei 2 la întotdeauna "on_reject" face nu este înseamnă „PostHog aruncă cookie-uri de urmărire pe cei care resping”. Înseamnă că cei care refuză obțin analize fără cookie-uri (dacă activați modul hash de server fără cookie-uri) plus o mică intrare de preferință de consimțământ.
Transmite consimțământul → identifica → steaguri
Model minim, aliniat cu examples/cookie-banner/shared/src/posthog.ts:
import posthog from "posthog-js";
import { getConsent } from "@probo/cookie-banner/consent";
const ANALYTICS = "analytics";
const FLAG_KEY = "example-beta-panel";
const DISTINCT_ID = "cookie-banner-example-demo"; // or your logged-in user id
let initialized = false;
let identified = false;
export function configurePosthogFromBanner() {
if (initialized) return;
initialized = true;
const consent = getConsent();
const analyticsAllowed = consent.getAll()[ANALYTICS] === true;
posthog.init("<YOUR_POSTHOG_KEY>", {
api_host: "https://us.i.posthog.com",
defaults: "2026-01-30",
cookieless_mode: "on_reject",
opt_out_capturing_by_default: !analyticsAllowed,
person_profiles: "identified_only",
respect_dnt: true,
});
posthog.onFeatureFlags(() => {
// re-render your UI from isFeatureFlagEnabled()
});
sync(consent.getAll());
consent.subscribe(sync);
}
function sync(data: Record<string, boolean>) {
if (data[ANALYTICS]) {
posthog.opt_in_capturing();
posthog.identify(DISTINCT_ID);
identified = true;
} else {
// reset() clears stored consent — call it before opt_out
posthog.reset();
posthog.opt_out_capturing();
identified = false;
}
}
/** Default-deny: cookieless, pending, or unidentified ⇒ feature hidden. */
export function isFeatureFlagEnabled(key = FLAG_KEY): boolean {
if (
!initialized ||
posthog.get_explicit_consent_status() !== "granted" ||
!identified
) {
return false;
}
return posthog.isFeatureEnabled(key) ?? false;
}
Atârna configurePosthogFromBanner oprit probo-ready exact ca în ghid de configurare. Nu suna niciodată identify() înainte ca analiza să fie permisă - asta ar scrie date personale fără un temei legal.
În interfața de utilizare, porniți funcția isFeatureFlagEnabled() (sau un magazin care se reîmprospătează de la onFeatureFlags). Nu afișați interfața de utilizare beta când asistentul returnează false.
Creați și vizați steagul în PostHog
- Creați o boolean semnalizare caracteristică a cărei cheie se potrivește cu codul dvs. (de ex.
example-beta-panel). - Fie rulează la 100% dintre utilizatori, sau adăugați o condiție de eliberare: ID distinct este egal cu șirul la care treceți
identify()(de ex.cookie-banner-example-demo) la 100%. - Permite Modul hash de server fără cookie-uri sub Setări proiect → Analize web, dacă vizitatorii respinși ar trebui să fie considerati în continuare utilizatori unici (aceeași cerință ca și Track 1 / Track 2 din ghidul de configurare).
- Exersați fluxul: încărcați fără analize → interfață de utilizator cu gated ascuns; acceptă analitice →
identifyrulează → interfața de utilizare apare când steagul este pornit; dezactivați steagul în PostHog → UI se ascunde după următoarea reîmprospătare/reîncărcare a steagului.
Direcționarea unui ID distinct este necesară numai atunci când doriți ca funcția să fie limitată la acea identitate. Pentru demonstrațiile locale, lansarea 100% este mai simplă.
Exemplu de lucru
Exemplul React furnizează bucla completă - panou de stare, steag cu consimțământ și un „panou Beta” care se redă numai când steag-ul este activat:
-
getprobo/probo/examples/cookie-banner - Cablaj:
shared/src/posthog.ts - Env:
PUBLIC_POSTHOG_FEATURE_FLAG,PUBLIC_POSTHOG_DEMO_DISTINCT_ID(vedea.env.example)
Îndreptați-l către bannerul dvs. și spre proiectul PostHog, acceptați analizele din fila Banner tematic și urmăriți cum se răstoarnă rândurile de steag.
Punând-o împreună
Need feature flags (or identify / replay) after consent?
├─ No → Track 1: cookieless_mode: "always"
└─ Yes → Track 2: cookieless_mode: "on_reject" always
+ opt_in + identify on grant
+ reset + opt_out on revoke
+ app-level default-deny around isFeatureEnabled
Pentru bootstrap-ul bannerului, maparea reglementărilor și blocarea evenimentelor personalizate, utilizați Cum configurezi PostHog pentru GDPR, CCPA și legislația internațională privind confidențialitatea. Pentru detalii privind Managerul de consimțământ, consultați API Consent Manager docs.
Probo este platforma de conformitate open-source care oferă și a banner cookie gratuit, fără dependențe cu suport încorporat pentru GDPR, UK GDPR, FADP, CCPA, CPRA, LGPD, PIPEDA, POPIA, PDPA, PIPL, PIPA, APPI, DPDP, LFPDPPP și PDPL. Dacă doriți o prezentare, rezerva un apel.
Întrebări frecvente
Ar trebui să rămână dezactivate steaguri de caracteristici în timp ce PostHog nu are cookie-uri?
Da, dacă funcția depinde de cunoașterea cine este vizitatorul. Țineți-l ascuns până când aceștia au acceptat analizele și le-ați identificat la PostHog. În acest fel, traficul fără cookie-uri sau respins nu vede niciodată o suprafață beta doar pentru că un răspuns de semnalizare încă se încărca sau rămâne dintr-o sesiune anterioară.
De ce să folosiți cookieless_mode on_reject în loc de întotdeauna pentru PostHog care știe consimțământul?
Cu cookieless_mode: întotdeauna, posthog-js interzice identific() și rămâne fără cookie pentru sesiune chiar și după opt_in_capturing(). Indicatoarele de caracteristică care au nevoie de un distinct_id stabil nu devin niciodată eligibile la mijlocul sesiunii. on_reject menține identitatea/persistența sesiunii dezactivată în timp ce vizitatorul este renunțat, apoi permite cookie-urile și identifică () după ce acceptă.
Cookie-ul PostHog __ph_opt_in_out_* este un instrument de urmărire a analizelor?
Nu — stochează preferința de înscriere/renunțare PostHog a vizitatorului, astfel încât SDK-ul să-și amintească alegerea. Echipele de aceeași poziție juridică se aplică de obicei unui cookie probo_consent: stocarea preferințelor strict necesară pentru conformitate, nu un distinct_id de marketing. Dezvăluiți-l ca fiind esențial în inventarul dvs. de cookie-uri. Acesta nu este un sfat juridic; menține scopul îngust.
Cum vizez un ID distinct demo pe un semnalizator de caracteristică?
În PostHog, deschideți condițiile de lansare a steagului și adăugați o condiție în care Distinct ID este egal cu șirul pe care îl transmiteți pentru identific() (de exemplu cookie-banner-example-demo). Setați această condiție la lansare 100%. După ce vizitatorul acceptă analizele și identifică cursele, semnalizarea evaluează pentru persoana respectivă.