Metodika statistik

Jak vznikají čísla ve statistikách API a jak je číst. Statistiky vrací agenda stats ve třech výstupech:

statistika inzerátu – časová řada a souhrn jednoho inzerátu (/c/{ID firmy}/{moto|dily|prislusenstvi}/{ID inzerátu}/stats, u smazaného inzerátu /c/{ID firmy}/archive/…/stats),
statistika firmy – časová řada a souhrn firmy po sekcích (/c/{ID firmy}/stats),
tabulka inzerátů – součty za období po inzerátech jedné sekce (/c/{ID firmy}/stats/{moto|dily|prislusenstvi}).

Všechny tři vycházejí ze stejných počítadel a stejných pravidel jako statistiky v administraci firmy. Tato stránka pravidla shrnuje v souvislostech; parametry, prvky a příklady jsou na stránkách jednotlivých výstupů. Statistiky vyžadují právo statsperm, i u smazaných inzerátů (oprávnění na úrovni 'archive' k nim potřeba není).

Co se měří

Metriky inzerátu: zobrazeni (zobrazení detailu), vypis (zobrazení ve výpisu), urlKliknuti (proklik na web prodejce), odpovedi (odpovědi na inzerát), schranka (uloženo do schránky), videoPrehrani a videoDokoukano (video) a bloky akcniOkno (akční okno) a vybirame (Vybíráme z nabídky na MotoInzerce.cz). Jsou ve všech třech výstupech.
Metriky firmy: sekce firma (pobocky, eshopy, stranky, formulare, poptavky, web) a v blocích proklikFirma (proklik na jméno firmy z akčního okna) a proklikLogo (proklik na logo ve Vybíráme z nabídky). Týkají se firmy, ne inzerátu, proto jsou jen ve statistice firmy. proklikFirma je jen v sekci moto: akční okno dílů je jen na firemní subdoméně (umístění 2), kde proklik na jméno firmy nevzniká.
Kde metrika vzniká: každá metrika vzniká jen v některých sekcích a umístěních (www.tipmoto.com, firemní subdoména, výpis na webu klienta, MotoInzerce.cz) – např. video jen u motorek na www a na subdoméně, akční okno dílů jen na subdoméně. Je to vlastnost webu, ne provozu firmy. Kombinace, ve které metrika nevzniká, v dokumentu chybí, i když ji klient vybere parametrem location. Úplný přehled je v katalogu metrik.
Hlavní číslo (text prvku metriky) = lidé a neurčení návštěvníci, bez robotů. Roboti jsou v atributech, viz Roboti.

Nula a neměřeno

0 znamená „měřilo se a nikdo nepřišel“, chybějící prvek znamená „neměřilo se“. Počítadla nulové dny nezapisují; API doplní nulu jen tam, kde se metrika v tom období měřila, kde v tom umístění a sekci vzniká a (u inzerátu) kde inzerát existoval, u videa navíc kde měl video. Jinde prvek chybí.
Bloky akcniOkno a vybirame se vypíšou podle katalogu, ne podle provozu: pro každé umístění, kde blok vzniká a kde se měřilo, i bez dat – s nulami. Firma, která si akční okno v některém umístění nekoupila, tam vidí nulu.
Časová řada obsahuje všechna období rozsahu, i ta bez jediné návštěvy.

Pokrytí

Co se kdy a kde měřilo, popisuje blok metriky v každém dokumentu, přesně pro data v dokumentu (ve statistice firmy je rozdělený po sekcích, protože pokrytí se mezi sekcemi liší). Pokrytí má tři osy:

Čas: od (první den s daty metriky pro zvolenou granularitu; tabulka inzerátů granularitu nemá a před denními daty bere měsíční součty, proto u ní má např. zobrazeni od 2022-05-01, zatímco statistika inzerátu a firmy s period=day začátek denních dat), dopoctenoDo, merenoOd, robotiOd a mezery v datech dira.
Umístění: s filtrem location začínají metriky dnem, kdy se začalo měřit podle umístění. Pokrytí podle umístění je v prvcích pokryti: u akčního okna a Vybíráme z nabídky vždy, u ostatních metrik jen s breakdown=location.
Existence: metrika, která ve vybraných sekcích a umístěních nevzniká, v bloku metriky ani v datech není. U inzerátu k tomu patří jeho život, u videa navíc to, zdali inzerát (firma) video měl.

Metriky	Data
`zobrazeni`, `odpovedi`	Dopočet ze záloh (`dopoctenoDo`) do 28. 8. 2026, u `odpovedi` do 7. 9. 2026 (u příslušenství do 30. 8. 2026 a pak mezera v datech 31. 8.–7. 9. 2026); od 29. 8. 2026, resp. 8. 9. 2026 měření novým sběrem (`merenoOd`). Dopočítané hodnoty nerozlišují umístění (umístění `0`).
`vypis`, akční okno, Vybíráme z nabídky, `pobocky`, `eshopy`, `stranky`	Od 29. 8. 2026. V umístění 4 (MotoInzerce.cz) mezera v datech 15.–16. 9. 2026.
`urlKliknuti`	Od 4. 9. 2026, první den neúplný.
`schranka`, `formulare`, `poptavky`, `web`	Od 7. 9. 2026, první den neúplný.
`videoPrehrani`, `videoDokoukano`	Od 24. 9. 2026, první den neúplný; u inzerátu (firmy) až ode dne, kdy měl video, viz Video.

Dopočet a měření jsou dvě metodiky. Skok v řadě na hranici dopoctenoDo / merenoOd je změna metodiky, ne návštěvnosti. S filtrem location dopočet ve výstupu není (nerozlišuje umístění).
Dostupnost dat: denní data jsou k dispozici od prvního dne měsíce před 13 měsíci (starší se mažou; v září 2026 je to 1. 8. 2025). Starší období jsou jen v měsíčních součtech – u zobrazeni a odpovedi od května 2022, u ostatních metrik od měsíce, kdy začalo měření. Začátek denních dat se tak každý měsíc posouvá.
Mezera v datech (dira) ve všech vybraných umístěních = v řadě neměřeno. Mezera jen v jednom ze sečtených umístění se jako dira neuvádí, dotčená období nesou neuplne="mereni".

Neúplné hodnoty

Atribut neuplne říká, že hodnota pokrývá jen část období nebo rozsahu, a proč. Víc důvodů je oddělených čárkou v tomto pořadí:

Důvod	Význam	Kde se vyskytuje
`rozsah`	Období (týden, měsíc) je useknuté okrajem použitého rozsahu.	jen v časové řadě
`mereni`	Metrika v období začala měřit, má v něm mezeru v datech, nebo období obsahuje neúplný první den měření; stačí v jednom ze sečtených umístění. U videa i období, které obsahuje dny před tím, než inzerát video dostal (samotný den, kdy ho dostal, se počítá celý).	řada, souhrn, řádek tabulky
`zivot`	Inzerát nežil po celé období: obsahuje vložení, smazání nebo mezeru mezi úseky života, nebo (v tabulce inzerátů) má metrika data jen mimo život.	statistika inzerátu a tabulka inzerátů; ve statistice firmy nevzniká
`bezi`	Období ještě neskončilo – obsahuje dnešek.	řada, souhrn, řádek tabulky

Hodnota obsahuje všechno naměřené, i neúplné dny (neúplný první den měření, dnešek). Souhrn se proto rovná součtu časové řady.
dni počítá jen celé dny, kdy se metrika měřila (a inzerát existoval) – bez dnů v mezeře dat, bez neúplných prvních dnů měření a bez dneška. Den vložení a smazání inzerátu se počítá jako celý. dni je v souhrnu u každé metriky, v řádku tabulky inzerátů jen u neúplné metriky.
Průměr prumerDen (jen v souhrnu) = součet za celé dny / dni; neúplné dny v něm nejsou. V řádku tabulky inzerátů průměr není a hodnota / dni je jen horní odhad průměru, protože hodnota neúplné dny obsahuje.
Tvoří-li rozsah jen neúplné dny (např. jen dnešek nebo jen první den měření), metrika se vypíše s hodnotou, dni="0" a neuplne, bez prumerDen.
Dnešek je vždy neúplný den (neuplne="bezi"): při výchozím rozsahu statistiky firmy, tabulky inzerátů a statistiky inzerátu na serveru (posledních 28 dní včetně dneška) ho nese každá měřená metrika souhrnu a řádku tabulky. Výchozí rozsah smazaného inzerátu je jeho život, dnešek v něm tedy není.

Rozsah

Rozsah se nepřichytává na celé týdny ani měsíce: from a to se berou přesně, okrajové období řady je useknuté (neuplne="rozsah") a jeho od/do říkají skutečně pokryté dny.
API rozsah jen zužuje, nikdy nerozšiřuje. Postup: 1. doplní chybějící from/to (jen from: to = dnes; jen to: from = to − 27 dní; bez obou výchozí rozsah výstupu), 2. je-li from pozdější než to, prohodí je, 3. zúží: to v budoucnosti na dnešek, from před začátkem dat na jejich začátek, u statistiky inzerátu na jeho život.
Zúžení na celé měsíce: pro období starší než denní data jsou jen měsíční součty. Okraj rozsahu uprostřed takového měsíce se proto zúží dovnitř na celé měsíce (přichycení ven by vrátilo čísla za nevyžádané dny). Týká se period=month ve statistice inzerátu a firmy a vždy tabulky inzerátů. Ve statistice inzerátu se nezužuje okraj v měsíci vložení či smazání inzerátu; měsíční součet se ale na dny rozdělit nedá, takže takový měsíc obsahuje i případný provoz mimo život, viz Život inzerátu.
Skutečně použitý rozsah je v rozsah/od a rozsah/do; liší-li se od zadaného, nese rozsah i pozadovanoOd/pozadovanoDo. Prohození from a to se nehlásí – prohozené hodnoty se berou jako zadané. period je v rozsah statistiky inzerátu a firmy vždy, v tabulce inzerátů nikdy (tabulka časovou řadu nemá); location, breakdown a section jen tehdy, když byly parametry použité.
Prázdný rozsah není chyba: když po zúžení nezbude žádný den (např. rozsah celý před začátkem dat nebo mimo život inzerátu), výstup vrátí 200 a rozsah bez od/do, bez metriky, souhrnu, řady a záznamů (nic se neměřilo). Klient s pohyblivým oknem tak nedostává chyby.
Časové pásmo: všechna data (from, to, od, do, vlozeniCas, smazaniCas) a hranice dnů v počítadlech jsou v čase Europe/Prague.

Život inzerátu

Život se určuje jen ze záznamů: z inzerátu na serveru (vložení až dnes), ze záznamu v archivu (vložení až smazání) a u znovu zveřejněného inzerátu z dat v mezeře (viz níže). Statistika i tabulka hledají život vždy u firmy z adresy.
Znovu zveřejněný inzerát (smazaný a později znovu vložený pod původním ID) má víc úseků života. Je to jeden inzerát: statistika inzerátu vrátí na obou cestách tentýž dokument a tabulka inzerátů jeden řádek; vlozeniCas je první vložení.
Data v mezeře: druhé smazání se do archivu nezapisuje, takže má-li inzerát v mezeře mezi smazáním a novým vložením data, žil tam nezapsaný úsek od prvního do posledního dne s daty a ty dny se počítají normálně. Neměřeno je jen zbytek mezery bez dat (v řadě chybí, do dni se nepočítá). Před začátkem denních dat se takový úsek odvozuje z měsíčních součtů po celých měsících.
Statistika inzerátu sčítá s period=day a week jen dny života – rozsah se na život vždy ořízne, mimo něj metriky chybí. S period=month se uzavřené měsíce (i uvnitř denních dat) berou z měsíčních součtů celé, protože měsíční součet se na dny rozdělit nedá. V měsíci vložení či smazání tak součet obsahuje i provoz mimo život (např. po smazání) a prumerDen se počítá z něj.
Řádek tabulky inzerátů obsahuje všechna data inzerátu v rozsahu, i mimo zapsaný život (typicky provoz po smazání inzerátu, převážně v dopočítané historii). Metrika, která má data jen mimo život, má dni="0" a neuplne="zivot". Díky tomu součty tabulky inzerátů odpovídají statistice firmy i administraci a nic naměřeného se neschová. U takových inzerátů ale statistika inzerátu s period=day nebo week ukáže méně než jeho řádek v tabulce; s period=month se od něj může lišit oběma směry.

Roboti

Atributy roboti (roboti) a aiRoboti (AI roboti) jsou vedle hlavního čísla; skupiny se nepřekrývají, všichni návštěvníci = hodnota + roboti + aiRoboti.
Nový sběr odděluje roboty od prvního dne měření (29. 8. 2026), proto robotiOd = merenoOd každé metriky. V dopočtu jsou roboti odečtení starší metodikou a počet robotů z něj neznáme, proto dopočítané hodnoty atributy robotů nemají (roboti="0" by nebylo pravdivé).
Kdy atributy chybí: v časové řadě u období, které začíná před robotiOd. V souhrnu a v tabulce inzerátů rozhoduje začátek rozsahu té metriky (from, nebo první den s daty metriky, je-li pozdější): atributy jsou jen tehdy, když se roboti měřili po celou dobu, za kterou má metrika hodnotu – jinak by podíl robotů nebyl ze stejného základu jako hodnota vedle.
V tabulce inzerátů platí začátek rozsahu dokumentu pro všechny řádky stejně, ne vložení inzerátu. Inzerát vložený po robotiOd proto může mít ve statistice inzerátu atributy robotů a v tabulce s rozsahem začínajícím před robotiOd ne.

Video

Jen motorky, jen umístění 1 a 2, jen v detailu full a custom:. videoPrehrani = přehrání (všechny zdroje včetně YouTube), videoDokoukano = dokoukáno (aspoň 90 % skutečně přehraného času).
U YouTube se měří jen přehrání, dokoukání ani průběh sledování zjistit nejde. Inzerát jen s videem z YouTube proto videoDokoukano nemá.
Existence videa: metriky videa jsou jen za dny, kdy inzerát video měl (u YouTube od vložení inzerátu, u videa nahraného na TipMoto ode dne nahrání, vždy nejpozději od prvního naměřeného přehrání). Ve statistice firmy od prvního dne, kdy měla firma video aspoň u jednoho inzerátu (videoDokoukano od prvního videa nahraného na TipMoto).
Vědomé zjednodušení: smazání videa se nikde nezaznamenává, takže po smazání videa ukazují metriky videa nuly až do konce života inzerátu.
24. 9. 2026 (začátek měření) je neúplný den. Blok videoUdrzeni ve statistice inzerátu ho nezahrnuje, a proto se jeho prehrani může lišit od videoPrehrani v souhrnu.

Akční okno a rozpad podle umístění

Akční okno na www, na firemní subdoméně a na MotoInzerce.cz jsou tři produkty, které si firma kupuje zvlášť. Blok akcniOkno je proto vždy po umístěních (s prvkem lokace), i bez rozpadu.
breakdown=location (ve statistice inzerátu a firmy) přidá do každého období i do souhrnu bloky umisteni a přesune do nich akcniOkno i vybirame (ten do bloku umístění 4). Na původním místě pak nejsou. Součty přes umístění zůstávají na úrovni období a souhrnu.
Tabulka inzerátů rozpad nemá (breakdown vrátí 406); bloky akcniOkno a vybirame jsou v řádku po umístěních jako ve statistice inzerátu.

Tři významy prvku `stats`

Kořenový prvek stats statistiky inzerátu – nese ID inzerátu.
Kořenový prvek stats statistiky firmy – nese ID firmy. Oba dokumenty mají vlastní schéma.
Blok stats v záznamu inzerátu (agendy moto, dily, prislusenstvi a jejich archiv) – celoživotní čítače zobrazeni, odpovedi a urlKliknuti; jeho atribut ref vede na statistiku inzerátu. Blok nevyžaduje právo statsperm.

Celoživotní čítače se se statistikami nemusí shodovat. Vedou se zvlášť: sčítají od vložení inzerátu, tedy i za dobu, za kterou statistiky data nemají, nerozlišují období ani umístění a do září 2026 je plnil starší sběr. Součet časové řady za celý život inzerátu proto od čítače v bloku stats čekejte odlišný.

Tabulka inzerátů

Jen inzeráty s provozem v rozsahu (v kterékoli metrice sekce), včetně smazaných (archiv = 1). Inzeráty bez provozu získáte spojením s výpisem /c/{ID firmy}/{moto|dily|prislusenstvi}.
detail vybírá sloupce, ne řádky: summary, full i custom: mají vždy sloupce id, idApi, nazev, archiv, vlozeniCas a smazaniCas (do custom: se nevyjmenovávají) a liší se metrikami; detail=id má jen id, idApi a archiv. Řádky a stránky jsou pro všechny úrovně stejné.
Neměřená metrika v řádku chybí (inzerát v době měření neexistoval, metrika se neměřila nebo inzerát neměl video). Filtr ji nenajde (filter=schranka = '0' takový řádek nevrátí) a do rowCount se nezapočítá. Při řazení podle ní je řádek vždy na konci, v obou směrech; shodné hodnoty se dorovnají podle id, takže stránkování je stabilní.
Inzeráty skryté pro exportní server (nastavení „neexportovat“) tabulka vynechá, stejně jako výpis inzerátů, aby šla s výpisem spojit. Týká se to jen inzerátů na serveru – archiv tento údaj nemá, takže smazaný inzerát, který byl skrytý, se v tabulce objeví. Statistika inzerátu vrátí pro skrytý inzerát na serveru 404. Statistika firmy skryté inzeráty v součtech má (součet žádný inzerát neprozradí). Pro login exportního serveru, před kterým firma některé inzeráty skrývá, proto součty tabulky nedávají součty statistiky firmy.
Inzerát, který už není na serveru ani v archivu, má v řádku jen id (bez ref), archiv = 1 a metriky. Život nemá, jeho metriky se řídí jen pokrytím a důvod zivot nenesou.
Jinak součty řádků tabulky = součty sekce ve statistice firmy za tentýž rozsah a umístění s period=day nebo week. S period=month se mohou lišit: statistika firmy bere uzavřené měsíce z měsíčních součtů, tabulka v denních datech denní data, viz Odchylky.

Odchylky a vědomá zjednodušení

Měsíční a denní součet se může lišit. Měsíční součty jsou samostatná agregace, ne součet denních dat, a nemusí s ním souhlasit na jednotku (např. za srpen 2026 je měsíční součet u části firem mírně vyšší než součet dnů, nikde nižší). Po měsících (period=month) se uzavřené měsíce berou z měsíčních součtů, proto se součet měsíce může lišit od součtu téhož měsíce po dnech. Tabulka inzerátů bere v denních datech vždy denní data a měsíční součty jen před nimi.
Statistika inzerátu × tabulka inzerátů: u inzerátů s daty mimo zapsaný život ukáže statistika inzerátu s period=day nebo week méně než řádek tabulky, s period=month se může lišit oběma směry, viz Život inzerátu. Atributy robotů se mohou lišit, viz Roboti.
ID přidělené dvěma firmám: výjimečně bylo totéž ID inzerátu v minulosti použito u dvou firem. Statistiky vždy patří firmě z adresy a život inzerátu se hledá jen u ní; data mimo tento život jsou v tabulce inzerátů a ve statistice firmy, ve statistice inzerátu ne (jako výše).
Dny bez dat uvnitř úseku života odvozeného z dat (znovu zveřejněný inzerát) jsou nuly jako v každém životě, i když tam inzerát mohl být dočasně nedostupný.
Smazané video = nuly až do konce života inzerátu, viz Video.

Angličtina

S lang=en jsou anglicky texty pro člověka: nazev a poznamka v bloku metriky, komentáře v XML a chybové hlášky.
Hodnoty dat se nepřekládají – klíče metrik, názvy prvků, data a čísla jsou stejné v obou jazycích. Také názvy umístění v číselníku lokacestats (lokaceText) jsou data a zůstávají česky; anglický význam je v komentáři XML nad prvkem.

Formáty a technika

JSON: opakované prvky jsou vždy pole, atributy sourozenecké klíče ("zobrazeni@roboti") a všechny hodnoty řetězce – podrobně v odstavci JSON statistiky inzerátu, statistiky firmy a tabulky inzerátů.
xpath vrací XML i u .json (jako v celém API).
HTML je ladicí pohled: atributy (roboti, aiRoboti, dni, prumerDen, neuplne) v něm vidět nejsou. Pro práci s čísly použijte XML nebo JSON.
Prvky, atributy i hodnoty mohou přibývat, viz Rozšiřitelnost.