Poradniki

Śledzenie po stronie serwera: odczyty bloga i rejestracje

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Śledzenie po stronie serwera: odczyty bloga i rejestracjeŚledzenie po stronie serwera: odczyty bloga i rejestracje

W skrócie

8 min czytania

Zdarzenia niestandardowe pozwalają mierzyć faktyczne czytanie bloga dzięki postępowi w artykule i ograniczonemu czasowi aktywności, a potem dokładnie śledzić rejestracje po stronie serwera, co daje znacznie więcej niż same odsłony.

Śledzenie analityczne po stronie serwera przydaje się, gdy zdarzenie zachodzi na twoim serwerze lub gdy śledzenie po stronie klienta jest zawodne. Dwa typowe przykłady to czytelnictwo bloga i rejestracje. Przeglądarka może oszacować postęp w artykule i czas aktywnego oglądania, a serwer powie, czy konto faktycznie powstało.

Najlepsza konfiguracja łączy oba źródła bez zbierania zbędnych danych osobowych.

Jak mierzyć faktyczne czytanie bloga

Odsłona to słaby wskaźnik treści. Czytelnicy od razu wychodzą, zostawiają otwartą kartę albo przewijają do końca bez czytania. Lepsze zdarzenie „przeczytano” łączy:

  • Minimalny czas aktywności zależny od liczby słów.
  • Głębokość przewinięcia w obrębie kontenera artykułu.
  • Stan widoczności, aby karty w tle się nie liczyły.
  • Jednorazowe zdarzenie, aby odświeżenia nie dublowały odczytów.

Na przykład artykuł liczący 1 200 słów może wymagać co najmniej 5 minut aktywnego czasu przy tempie około 220-250 słów na minutę oraz przewinięcia 80% artykułu. Nie traktuj tej liczby jako uniwersalnej. Dokumentację techniczną, treści prawne i porównania czyta się w różnym tempie.

Odsłona a zdarzenie przeczytania artykułu
Odsłona
  • Liczy natychmiastowe wyjście
  • Liczy kartę pozostawioną w tle
  • Liczy szybkie przewinięcie do końca
Zdarzenie przeczytania artykułu
  • Wymaga minimalnego czasu aktywności zależnego od liczby słów
  • Wymaga przewinięcia 80% kontenera artykułu
  • Zatrzymuje się, gdy karta nie jest widoczna
  • Uruchamia się raz na odsłonę
Odsłona liczy niemal wszystko. Na zdarzenie przeczytania trzeba zapracować.

Przykład zdarzenia po stronie klienta

const article = document.querySelector('[data-article]');
const words = Number(article?.dataset.words || 0);
const estimatedSeconds = Math.round((words / 230) * 60);
const minSeconds = Math.min(420, Math.max(30, estimatedSeconds * 0.6));
const maxCreditSeconds = Math.min(900, Math.max(90, estimatedSeconds * 1.5));
let activeSeconds = 0;
let articleVisible = false;
let reachedDepth = false;
let sent = false;
 
const depthMarker = document.createElement('span');
depthMarker.setAttribute('aria-hidden', 'true');
depthMarker.style.cssText = 'position:absolute;top:75%;left:0;width:1px;height:1px;';
if (article) {
  article.style.position ||= 'relative';
  article.appendChild(depthMarker);
}
 
function maybeSendRead() {
  if (sent || !article || !reachedDepth || activeSeconds < minSeconds) return;
  sent = true;
  navigator.sendBeacon(
    '/analytics/article-read',
    JSON.stringify({
      slug: article.dataset.slug,
      wordCount: words,
      activeSeconds,
    })
  );
}
 
const observer = new IntersectionObserver(
  (entries) => {
    for (const entry of entries) {
      if (entry.target === article) articleVisible = entry.isIntersecting;
      if (entry.target === depthMarker && entry.isIntersecting) reachedDepth = true;
    }
    maybeSendRead();
  },
  { threshold: 0 }
);
 
if (article) {
  observer.observe(article);
  observer.observe(depthMarker);
}
 
setInterval(() => {
  if (sent || !articleVisible || document.visibilityState !== 'visible') return;
  activeSeconds = Math.min(activeSeconds + 1, maxCreditSeconds);
  maybeSendRead();
}, 1000);

Dzięki temu szybkie przewinięcie do końca nie liczy się jako przeczytanie. Kod ogranicza też zaliczany czas aktywności, zatrzymuje się, gdy strona jest ukryta, i używa znacznika głębokości na poziomie artykułu zamiast mierzyć przewinięcie względem całego dokumentu.

Nowy pracownik podpisuje dokumenty przy biurku, co przypomina moment, w którym serwer potwierdza zakończenie rejestracji.

Śledzenie rejestracji po stronie serwera

Rejestracje należy śledzić po potwierdzeniu powodzenia przez serwer, a nie w chwili kliknięcia przycisku wysyłania. Wysłania formularza po stronie klienta są zawyżone, bo walidacja może się nie powieść, żądania mogą się powielić, a boty mogą uruchamiać formularze.

Zdarzenie po stronie serwera powinno zawierać wyłącznie bezpieczne pola:

  • Nazwa zdarzenia: registration_completed.
  • Znacznik czasu.
  • Anonimowe odniesienie do odwiedzającego lub sesji, jeśli jest dostępne i zgodne z prawem.
  • Plan lub ścieżka rejestracji.
  • Źródło UTM zapisane przy wejściu.
  • Typ konta lub przedział wielkości obszaru roboczego.

Unikaj w analityce adresu e-mail, imienia i nazwiska, adresu IP, surowego identyfikatora użytkownika, statusu hasła i pól tekstowych z dowolną treścią. Jeśli musisz wewnętrznie powiązać zdarzenia z kontami, trzymaj to powiązanie w bazie danych produktu, a nie w zdarzeniu analitycznym u zewnętrznego dostawcy.

Usuwanie duplikatów

W zdarzeniach serwerowych używaj klucza idempotencji. Zdarzenie rejestracji powinno uruchomić się raz na utworzenie konta, nawet jeśli użytkownik odświeży stronę potwierdzenia albo webhook wyśle je ponownie.

await analytics.track({
  event: 'registration_completed',
  idempotencyKey: `registration:${account.id}`,
  properties: {
    plan: account.plan,
    source: attribution.source,
    campaign: attribution.campaign,
  },
});

Lista kontrolna prywatności

  • Nie śledź czytania na wrażliwych stronach, chyba że to konieczne.
  • W miarę możliwości trzymaj zdarzenia artykułów w formie zbiorczej.
  • Usuwaj parametry zapytań przed zapisaniem ścieżek.
  • Nie wysyłaj danych osobowych we właściwościach zdarzeń.
  • Udokumentuj okres retencji surowych zdarzeń.
  • Przestrzegaj wymogów dotyczących zgody na przechowywanie danych lub identyfikatory po stronie klienta.

Śledzenie po stronie serwera nie jest automatycznie przyjazne prywatności. Jest lepsze wtedy, gdy rejestruje zweryfikowane zdarzenia biznesowe z ograniczoną zawartością. Przeglądarki używaj do sygnałów, które zna tylko ona, a serwera do faktów, które tylko on może potwierdzić.

Kontrola jakości danych

Porównaj zdarzenia przeczytania artykułu z odsłonami. Jeśli każda odsłona staje się odczytem, próg jest zbyt niski albo zdarzenie uruchamia się przy ładowaniu. Jeśli przy długich artykułach z dużym zaangażowaniem prawie nie ma odczytów, obliczenie przewinięcia jest błędne: korzysta z całego dokumentu zamiast z kontenera artykułu.

W przypadku rejestracji uzgodnij zdarzenia analityczne z bazą danych aplikacji. Dzienna liczba registration_completed powinna odpowiadać liczbie utworzonych kont, z uwzględnieniem oczekiwanych ponowień i usunięć. Jeśli tak nie jest, napraw zdarzenie serwerowe, zanim użyjesz go do atrybucji marketingowej.

Zgoda i przejrzystość

Jeśli śledzenie korzysta tylko ze zdarzeń zbiorczych i nie zapisuje niczego na urządzeniu, obowiązki związane z prywatnością są mniejsze. Jeśli ustawiasz identyfikatory, łączysz zdarzenia czytania z kontami lub używasz danych do personalizacji, odpowiednio zaktualizuj zgody i informacje o prywatności. Po stronie serwera nie znaczy niewidocznie: użytkownikom nadal należy się uczciwe wyjaśnienie.

Szczegóły wpływające na niezawodność

Wysyłając zdarzenia odczytu z przeglądarki, wybieraj metody zaprojektowane z myślą o zamykaniu strony. Beacon API pozwala przeglądarce wysłać małe asynchroniczne żądanie bez blokowania nawigacji, co przydaje się przy zdarzeniach uruchamianych pod koniec wizyty (MDN Beacon API). Dbaj o to, by dane były niewielkie i niewrażliwe, bo beacon nie jest miejscem na duże obiekty diagnostyczne.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Zdarzenie rejestracji po stronie serwera projektuj jak transakcję finansową:

  • Uruchamiaj je dopiero po zatwierdzeniu zapisu konta lub rejestracji.
  • Dodaj klucz idempotencji oparty na wewnętrznym rekordzie.
  • Bezpiecznie ponawiaj wysyłkę, jeśli punkt końcowy analityki jest chwilowo niedostępny.
  • Przechowuj krótki dziennik audytowy statusu dostarczenia.
  • Uzgadniaj liczby z bazą danych produktu.

Jeśli atrybucja ma znaczenie, zapisuj parametry UTM w chwili wejścia i przechowuj je we własnym rekordzie atrybucji z jasno określonym okresem retencji. Gdy rejestracja się powiedzie, dołącz bezpieczne pola kampanii, takie jak źródło, medium, kampania i strona docelowa. Nie dołączaj pełnej historii przeglądania odwiedzającego.

W analityce czasu czytania uważaj na pozostawione otwarte karty. Licz aktywny czas widoczności, zatrzymuj licznik, gdy strona jest ukryta, i rozważ maksymalne okno zaliczania, aby karta otwarta podczas przerwy na lunch nie stała się „40-minutową lekturą”. Przy bardzo krótkich wpisach użyj minimalnego progu, a przy długich nie wymagaj przewinięcia 100%, bo czytelnicy mogą uzyskać to, czego szukali, jeszcze przed notką o autorze lub sekcją powiązanych wpisów.

Najlepszym sygnałem nie jest sam „spędzony czas”. Jest nim czas plus realny postęp plus kolejne działanie, takie jak zapis do newslettera, wizyta na stronie produktu lub rejestracja.

Rejestracja traktowana jak transakcja finansowa
1
Poczekaj na zatwierdzenie. Uruchom zdarzenie dopiero po zatwierdzeniu zapisu konta lub rejestracji.
2
Dodaj klucz idempotencji. Oprzyj go na wewnętrznym rekordzie, aby ponowienia nie tworzyły duplikatów.
3
Bezpiecznie ponawiaj. Jeśli punkt końcowy analityki jest chwilowo niedostępny, ponów wysyłkę bez podwójnego liczenia.
4
Zapisuj dostarczenie. Przechowuj krótki dziennik audytowy statusu dostarczenia.
5
Uzgadniaj dane. Porównuj liczby z bazą danych produktu.
Pięć kontroli sprawia, że zdarzenie rejestracji staje się liczbą, której marketing może zaufać.

Kontroler jakości przechodzi przez listę na podkładce, co odpowiada omawianym tu testom odczytów i rejestracji.

Testy odczytów i rejestracji

Traktuj odczyty artykułów jako sygnał jakości treści, a nie dowód, że jedna możliwa do zidentyfikowania osoba przeczytała każde słowo. Sprawdź, czy:

  • Karta w tle nie nalicza czasu.
  • Szybkie przewinięcie nie uruchamia odczytu.
  • Długie artykuły mają limit zaliczanego czasu aktywności.
  • Zdarzenie uruchamia się raz na odsłonę.
  • Wrażliwe kategorie artykułów korzystają wyłącznie z raportów zbiorczych.
  • Zdarzenia rejestracji odpowiadają zatwierdzonym kontom, a nie kliknięciom przycisku.

Oddzielaj sygnał z przeglądarki od faktu z serwera. Przeglądarka może oszacować rzeczywiste czytanie. Serwer może potwierdzić rejestrację. Ostrożne łączenie obu daje korzyści, a udawanie, że któreś z nich jest idealne, tworzy tylko szum w analityce.

Najczęściej zadawane pytania

Dlaczego odsłona jednocześnie zaniża i zawyża liczby?

Odsłona uruchamia się w chwili załadowania strony, więc natychmiastowe wyjście, pozostawioną otwartą kartę i szybkie przewinięcie do końca liczy tak samo jak rzeczywiste przeczytanie. Połączenie jej z minimalnym czasem aktywności, głębokością przewinięcia i stanem widoczności oddziela prawdziwe czytanie od tych przypadków. Jednorazowe zdarzenie dodatkowo sprawia, że odświeżenia nie zawyżają liczby.

Jakiego tempa czytania użyć przy progu czasu aktywności?

Ten artykuł przyjmuje jako punkt wyjścia około 220-250 słów na minutę, co dla tekstu liczącego 1 200 słów daje minimalny czas aktywności około 5 minut. Traktuj to jako wartość bazową, a nie uniwersalną liczbę. Dokumentację techniczną, treści prawne i porównania czyta się w różnym tempie, więc dostosuj próg do rodzaju treści.

Dlaczego mierzyć przewinięcie względem kontenera artykułu, a nie całego dokumentu?

Pomiar względem całego dokumentu zniekształca wynik, gdy nagłówki, stopki lub sekcje powiązanych wpisów zmieniają długość strony. Przykład po stronie klienta umieszcza znacznik głębokości w samym elemencie artykułu i obserwuje go za pomocą IntersectionObserver, więc obliczenie dotyczy artykułu, a nie otaczającego układu. To także rozwiązanie, gdy przy długich, angażujących artykułach prawie nie ma odczytów mimo dobrego przewijania.

Czy progiem odczytu powinno być przewinięcie 100%?

Wymóg pełnego przewinięcia może pominąć czytelników, którzy dostali to, po co przyszli, jeszcze przed notką o autorze lub blokiem powiązanych wpisów na końcu. Przykład w tym artykule zakłada zamiast tego 80% przewinięcia. Przy długich tekstach rezygnacja z progu 100% sprawia, że wskaźnik lepiej oddaje, co naprawdę znaczy „przeczytano”.

Jak sprawić, by karta w tle nie zawyżała czasu aktywności?

Sprawdzaj document.visibilityState razem z IntersectionObserver obserwującym, czy artykuł jest na ekranie. Interwał sekundowy z przykładu zwiększa activeSeconds tylko wtedy, gdy artykuł jest widoczny, a stan widoczności karty to "visible", więc karta pozostawiona w tle natychmiast przestaje naliczać czas.

Jaki limit zaliczanego czasu aktywności ma sens przy długich artykułach?

Limit sprawia, że karta otwarta przez przerwę na lunch nie zostanie zapisana jako 40-minutowa lektura. Przykładowa implementacja ogranicza activeSeconds za pomocą Math.min do pułapu maxCreditSeconds, wyliczanego z szacowanego czasu czytania artykułu. Długie artykuły nadal mają szerokie okno, ale nie nieograniczone.

Dlaczego zdarzenia rejestracji powinny uruchamiać się po potwierdzeniu przez serwer, a nie po wysłaniu formularza?

Wysłania formularza po stronie klienta są zawyżone, bo walidacja może się nie powieść, żądania mogą się powielić, a boty mogą uruchamiać formularze, niczego nie tworząc. Zdarzenie potwierdzone przez serwer uruchamia się dopiero, gdy konto faktycznie istnieje, a to właśnie ten fakt ma odzwierciedlać analityka. Dlatego ten artykuł traktuje zdarzenie jak transakcję finansową: najpierw zatwierdzenie, potem śledzenie.

Jakie pola można bezpiecznie dodać do zdarzenia registration_completed?

Ogranicz się do nazwy zdarzenia, znacznika czasu, anonimowego odniesienia do odwiedzającego lub sesji, jeśli jest zgodne z prawem, planu lub ścieżki rejestracji, źródła UTM zapisanego przy wejściu oraz typu konta lub przedziału wielkości obszaru roboczego. Pomiń adres e-mail, imię i nazwisko, adres IP, surowy identyfikator użytkownika, status hasła i pola z dowolnym tekstem. Jeśli musisz wewnętrznie powiązać zdarzenia z kontami, trzymaj to powiązanie w bazie danych produktu, a nie w zdarzeniu analitycznym.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Jak klucz idempotencji zapobiega duplikatom zdarzeń rejestracji?

Klucz powstaje z identyfikatora konta, na przykład registration:${account.id}, więc platforma analityczna rozpoznaje powtórną wysyłkę jako to samo zdarzenie, a nie nowe. Chroni to przed odświeżeniem strony potwierdzenia przez użytkownika i ponowieniem webhooka po przekroczeniu limitu czasu. Zdarzenie jest zaliczane dokładnie raz na utworzenie konta, niezależnie od tego, ile razy uruchomi się wyzwalacz.

Jak sprawdzić, czy śledzenie rejestracji jest dokładne?

Uzgodnij dzienną liczbę zdarzeń registration_completed z liczbą kont utworzonych w bazie danych aplikacji. Obie liczby powinny się zgadzać, z uwzględnieniem oczekiwanych ponowień i usunięć. Jeśli się rozjeżdżają, napraw samo zdarzenie serwerowe, zanim użyjesz tych danych do atrybucji marketingowej.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Częściej widoczni w Google

Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.

Jeszcze jedno...

Flowsery

Flowsery

Analityka witryny skupiona na przychodach

Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Powiązane artykuły