Soubor s historií sledování TikToku je prostý textový JSON záznam každého přehraného videa, uložený v exportu dat, který si z TikToku můžete stáhnout. Jakmile pochopíte jeho strukturu, můžete ho číst, počítat videa a dokonce sami odhadovat délku jednotlivých relací sledování.
Když si od TikToku vyžádáte svá data a zvolíte formát JSON, export dorazí jako archiv ZIP obsahující několik souborů. Jedním z nejzajímavějších je soubor s historií sledování, který vypisuje videa, která jste v průběhu času zhlédli. Tento průvodce vám ukáže, kde soubor najdete, jak je jeho JSON uspořádán a jak ho správně interpretovat.
Co je soubor s historií sledování
Soubor s historií sledování je protokol videí, která se přehrála ve vašich kanálech Pro vás a Sledované. Každý záznam představuje jedno video, které TikTok evidoval jako zhlédnuté, spolu s časem přehrání a odkazem na původní video.
Nejde o analytický přehled. Jsou to surová data: dlouhý seznam časových razítek a URL adres. To je sice silná stránka pro osobní analýzu, ale na první pohled jsou hůře čitelná, zvláště pokud vaše historie sahá měsíce nebo roky zpět.
Kde se soubor v exportu nachází
Po rozbalení exportu TikToku jsou data historie sledování seskupena ve složce relacionované s aktivitou. V JSON exportu je obvykle najdete vnořené takto:
- Activity → Video Browsing History (někdy označeno jako Watch History),
- uloženo v jediném souboru .json vedle dalších souborů s aktivitami, jako jsou Like List a Search History.
Přesné názvy složek se mohou mezi verzemi exportu mírně lišit. Pokud si nejste jisti rozložením archivu, náš průvodce vysvětlením složek exportu dat TikToku podrobně popisuje každou sekci. Pro celý postup vyžádání a stažení viz jak stáhnout a analyzovat data z TikToku.
Struktura JSON: záznamy VideoList
Uvnitř souboru jsou záznamy sledování uloženy pod klíčem obvykle pojmenovaným VideoList. Jde o pole objektů, kde každý objekt popisuje jedno zhlédnuté video. Jeden záznam vypadá přibližně takto:
- Date — kdy bylo video zhlédnuto, např. "2026-02-14 18:32:07",
- Link — URL adresa videa, např. "https://www.tiktokv.com/share/video/7300000000000000000/".
Celková podoba je tedy objekt nejvyšší úrovně obsahující pole, které si lze představit jako { "Video Browsing History": { "VideoList": [ ... ] } }. Každý prvek VideoList je jedna událost přehrání s polem Date a Link. Nejsou zde žádné počty zhlédnutí, čísla o zapojení ani titulky — pouze kdy a co.
Jak ručně počítat videa
Nejjednodušší metrika je celkový počet zhlédnutých videí, který se rovná délce pole VideoList. Zjistit ho můžete několika způsoby:
- otevřete soubor v editoru kódu a podívejte se na délku pole, nebo
- načtěte ho v konzoli prohlížeče pomocí data['Video Browsing History'].VideoList.length, nebo
- použijte nástroj příkazového řádku pro počítání výskytů klíče Date.
Počítání unikátních videí je o něco složitější, protože stejný Link se může objevit víckrát, pokud jste video sledovali opakovaně. Chcete-li počítat unikátní videa, musíte deduplikovat podle pole Link, nikoli jen počítat řádky.
Odhadování relací vs. použití nástroje
"Relace" je úsek nepřerušovaného sledování. Export relace neoznačuje, takže je musíte odvodit z časových razítek Date. Běžný přístup je seřadit záznamy podle data a seskupit videa, která jsou časově blízko sebe:
- seřaďte všechny záznamy podle hodnoty Date,
- procházejte seznam a začněte novou relaci vždy, když mezera mezi dvěma po sobě jdoucími videi překročí stanovenou mez (například 30 minut),
- spočítejte, kolik relací vzniklo.
Dělat to ručně u tisíců záznamů je zdlouhavé a náchylné k chybám. Nástroj jako TikTok Wrapped toto seskupování provádí automaticky a přeměňuje výsledky v přehledné souhrny. Můžete si prohlédnout ukázkový wrapped a zjistit, jak výstup vypadá, nebo analyzovat vlastní export přímo.
Časté nástrahy
Formáty data a časová pásma
Pole Date je řetězec, nikoli skutečný datetime, a bývá zaznamenáno v UTC, nikoli ve vašem místním čase. Pokud ho analyzujete bez zohlednění časového pásma, mohou se hranice relací a výsledky "nejaktivnější hodiny" posunout o několik hodin.
Neúplná historie
Export nemusí obsahovat celou vaši historii sledování. TikTok omezuje, jak daleko zpět některé aktivity sahají, takže prázdný nebo krátký VideoList neznamená vždy, že jste toho málo sledovali — může to znamenat, že bylo okno exportu omezené.
Velké soubory
Intenzivní uživatelé mohou mít soubory s historií sledování o velikosti desítek megabajtů. Některé textové editory mají s otevíráním tak velkých souborů potíže. Pokud se soubor neotevře nebo editor zamrzne, jde o příznak velkého množství dat, nikoli o poškozený soubor.
Rozdíly v pojmenování klíčů
Protože TikTok příležitostně přejmenovává klíče mezi verzemi exportu, obalový klíč kolem VideoList se může lišit. Pokud je data['Video Browsing History'] undefined, nejprve zkontrolujte klíče nejvyšší úrovně a najděte správný název.
Závěrečné myšlenky
Soubor JSON s historií sledování je jednou z nejodhalovacích částí vašeho exportu z TikToku. Jakmile pochopíte, že jde jen o pole VideoList párů Date a Link, počítání videí a odhadování relací se stane přímočarým — i když nástrahy s časovými pásmy, neúplnou historií a velikostí souborů mohou snadno překvapit.
Pokud nechcete ručně analyzovat soubor, analytický nástroj přečte stejný soubor a výsledky vám během vteřin přehledně zobrazí.