Un singur script îți aduce fiecare afișare de pagină, sursă, eveniment propriu și Web Vital, lângă conținutul care a adus vizitatorul. Are în jur de 1 KB comprimat, nu pune cookie-uri, iar Manifolio nu păstrează adrese IP.
Adaugi scriptul
Creezi o cheie publicabilă în Developers → API keys și treci domeniile de pe care are voie să trimită, de exemplu aurora.coffee și *.aurora.coffee. Apoi pui un singur rând în fiecare pagină:
<script defer src="https://api.manifolio.com/t.js" data-key="mf_pk_live_cheia_site_ului"></script>O cheie publicabilă poate trimite doar date de analiză și răspunsuri la formulare, și doar de pe domeniile ei, așa că poate sta liniștită în sursa paginii. Cheile de dezvoltare (mf_pk_test_) acceptă și localhost.
Scriptul înregistrează:
- o afișare de pagină la încărcare și la fiecare navigare din browser (
pushState,replaceState,popstate) - Web Vitals (LCP, INP, CLS, FCP, TTFB), o dată pe pagină, când pagina se ascunde
- evenimentele proprii trimise cu
track()
Nu trimite nimic când browserul are pornite Do Not Track sau Global Privacy Control ori când rulează automatizat.
Evenimente proprii
manifolio.track("order_click", { bean: "ethiopia-guji", size: 250 });- numele are cel mult 64 de litere, cifre, spații sau
_ . : / - - cel mult 10 proprietăți; cheile au cel mult 40 de caractere; valorile sunt texte (cel mult 200 de caractere), numere sau booleene
Apelurile făcute înainte să se încarce scriptul nu se pierd. Le pui într-o coadă, iar scriptul le trimite când pornește:
<script>
window.manifolio = window.manifolio || { q: [] };
window.manifolio.track = window.manifolio.track || function () { window.manifolio.q.push(arguments); };
</script>Evenimentele apar în Analytics → Events și în panou.
Ce se păstrează
| Date | Cum |
|---|---|
| Vizitatorul | primii 8 octeți din SHA-256 pe o sare zilnică, adresa IP, user agent și proiect. Sarea se șterge când se încheie ziua, deci un vizitator nu poate fi urmărit de la o zi la alta |
| Țara | din antetul de țară al rețelei de margine; adresa IP nu se scrie nicăieri |
| Dispozitivul și browserul | din lățimea ferestrei și dintr-un parser mic de user agent |
| Sursa | utm_source, altfel site-ul de unde a venit, altfel direct |
| Paginile | doar calea (/shop/espresso); parametrii și fragmentele se aruncă |
Evenimentele brute se păstrează 90 de zile; totalurile pe zi, doi ani.
Limite
Un lot are cel mult 16 KB și 25 de evenimente. Fiecare vizitator poate trimite 60 de evenimente pe minut, iar fiecare proiect 6.000; peste asta, API-ul răspunde 429 cu Retry-After. Roboții sunt filtrați după user agent.
Adresa ta
Dacă servești singur scriptul sau treci API-ul printr-un proxy, data-api schimbă locul unde pleacă evenimentele:
<script defer src="/t.js" data-key="mf_pk_live_cheia_site_ului" data-api="https://api.manifolio.com"></script>