Plik z historią oglądania TikToka to zwykły tekstowy rekord JSON każdego odtworzonego przez Ciebie filmu, przechowywany w eksporcie danych, który TikTok umożliwia pobranie. Gdy poznasz jego strukturę, możesz go odczytać, zliczyć filmy, a nawet samodzielnie oszacować sesje oglądania.
Gdy zażądasz swoich danych od TikToka i wybierzesz format JSON, eksport dotrze do Ciebie jako archiwum ZIP zawierające kilka plików. Jednym z najbardziej interesujących jest plik z historią oglądania, który zawiera listę filmów obejrzanych przez Ciebie w czasie. Ten przewodnik omawia, gdzie znajduje się plik, jak jest zorganizowany jego JSON oraz jak go zrozumieć.
Czym jest plik z historią oglądania
Plik z historią oglądania to dziennik filmów odtworzonych w Twoich feedach Dla Ciebie i Obserwowani. Każdy wpis reprezentuje jeden film zarejestrowany przez TikToka jako obejrzany, wraz z godziną odtworzenia i linkiem do oryginalnego wideo.
To nie jest panel analityczny. To surowe dane: długa lista znaczników czasu i adresów URL. Sprawia to, że jest przydatny do analizy osobistej, ale trudny do odczytania na pierwszy rzut oka — szczególnie jeśli historia obejmuje miesiące lub lata.
Gdzie go znaleźć w eksporcie
Po rozpakowaniu eksportu TikToka dane historii oglądania są pogrupowane w folderze związanym z aktywnością. W eksporcie JSON zazwyczaj znajdziesz je zagnieżdżone w następujący sposób:
- Activity → Video Browsing History (czasem oznaczony jako Watch History),
- przechowywany w jednym pliku .json obok innych plików aktywności, takich jak Like List i Search History.
Dokładne nazwy folderów mogą się nieznacznie różnić między wersjami eksportu. Jeśli nie jesteś pewien, jak jest zorganizowane archiwum, nasz przewodnik Foldery eksportu danych TikToka — omówienie wyjaśnia każdą sekcję. Aby poznać pełny proces żądania i pobierania, zapoznaj się z artykułem jak pobrać i przeanalizować dane TikToka.
Struktura JSON: wpisy VideoList
Wewnątrz pliku rekordy oglądania są przechowywane pod kluczem zazwyczaj nazwanym VideoList. Jest to tablica obiektów, gdzie każdy obiekt opisuje jeden obejrzany film. Pojedynczy wpis wygląda mniej więcej tak:
- Date — kiedy film był oglądany, np. "2026-02-14 18:32:07",
- Link — adres URL filmu, np. "https://www.tiktokv.com/share/video/7300000000000000000/".
Ogólna struktura to obiekt najwyższego poziomu zawierający tablicę, którą możesz sobie wyobrazić jako { "Video Browsing History": { "VideoList": [ ... ] } }. Każdy element VideoList to jedno zdarzenie odtworzenia z polem Date i polem Link. Nie ma liczb wyświetleń, wskaźników zaangażowania ani napisów — tylko kiedy i co.
Jak ręcznie zliczać filmy
Najprostszym wskaźnikiem jest łączna liczba obejrzanych filmów, która odpowiada długości tablicy VideoList. Można to sprawdzić na kilka sposobów:
- otwórz plik w edytorze kodu i sprawdź długość tablicy,
- wczytaj go w konsoli przeglądarki za pomocą data['Video Browsing History'].VideoList.length,
- użyj narzędzia wiersza poleceń, aby zliczyć wystąpienia klucza Date.
Zliczanie unikalnych filmów jest nieco trudniejsze, ponieważ ten sam Link może pojawić się więcej niż raz, jeśli oglądałeś film ponownie. Aby zliczyć unikalne, musisz deduplikować według pola Link, a nie po prostu zliczać wiersze.
Szacowanie sesji a korzystanie z narzędzia
"Sesja" to ciągły okres oglądania. Eksport nie oznacza sesji, więc musisz je wywnioskować ze znaczników czasu Date. Popularnym podejściem jest sortowanie wpisów według daty i grupowanie filmów bliskich sobie w czasie:
- posortuj wszystkie wpisy według wartości Date,
- przejdź przez listę i rozpocznij nową sesję za każdym razem, gdy przerwa między dwoma kolejnymi filmami przekracza próg (np. 30 minut),
- zlicz, ile sesji powstało w rezultacie.
Robienie tego ręcznie na tysiącach wpisów jest żmudne i podatne na błędy. Narzędzie takie jak TikTok Wrapped wykonuje to grupowanie automatycznie i przekształca je w czytelne podsumowania. Możesz zobaczyć przykładowe podsumowanie, by sprawdzić, jak wygląda wynik, lub przeanalizować swój własny eksport bezpośrednio.
Typowe pułapki
Formaty dat i strefy czasowe
Pole Date jest ciągiem znaków, a nie prawdziwym typem datetime, i często jest zapisywane w UTC, a nie w Twoim lokalnym czasie. Jeśli je parsujemy bez uwzględnienia strefy czasowej, granice sesji i wyniki dotyczące "najbardziej aktywnej godziny" mogą przesunąć się o kilka godzin.
Niepełna historia
Eksport może nie obejmować całej historii oglądania. TikTok ogranicza, jak daleko wstecz sięga część aktywności, więc pusta lub krótka lista VideoList nie zawsze oznacza, że oglądałeś mało — może to oznaczać, że okno eksportu było ograniczone.
Duże pliki
Intensywni użytkownicy mogą mieć pliki z historią oglądania o rozmiarze kilkudziesięciu megabajtów. Niektóre edytory tekstu mają problem z otwieraniem tak dużych plików. Jeśli plik nie chce się otworzyć lub zawiesza edytor, to znak, że dane są duże, a nie że plik jest uszkodzony.
Różnice w nazwach kluczy
Ponieważ TikTok okazjonalnie zmienia nazwy kluczy między wersjami eksportu, klucz otaczający VideoList może się różnić. Jeśli data['Video Browsing History'] jest niezdefiniowane, najpierw sprawdź klucze najwyższego poziomu, aby znaleźć właściwą etykietę.
Podsumowanie
Plik JSON z historią oglądania jest jedną z najbardziej odkrywczych części eksportu TikToka. Gdy zrozumiesz, że to po prostu tablica VideoList złożona z par Date i Link, zliczanie filmów i szacowanie sesji staje się proste — choć pułapki związane ze strefą czasową, niepełną historią i rozmiarem pliku łatwo przeoczyć.
Jeśli wolisz pominąć ręczne parsowanie, narzędzie do analizy może odczytać ten sam plik i przedstawić Ci wyniki w kilka sekund.