api.tipmoto.com » Dokumentace API » Agendy » Seznam firem » Firma » Moto/Díly/Příslušenství » Statistika

Agenda stats (statistika inzerátu)

Statistika jednoho inzerátu po dnech, týdnech nebo měsících: zobrazení detailu, zobrazení ve výpisu, prokliky na web prodejce, odpovědi, uložení do schránky, přehrání videa a akční okna.
Vychází ze stejných počítadel a pravidel jako statistiky v administraci firmy. Agenda je jen ke čtení a vyžaduje právo statsperm. Jak čísla vznikají a jak je číst, podrobně popisuje Metodika statistik.

Funkce agendy

Název Možnosti
Podporované metody GET
Podpora úrovně detailu ✔ (vlastní výběr metrik, viz úrovně detailu)
Podpora filtrace ✘
Podpora fulltextu ✘
Podpora stránkování ✘
Podpora řazení ✘
Podpora externích identifikátorů ✔
Podpora schémat https://api.tipmoto.com/schemas/stats/inzerat.{xsd|rng}
Podpora ?fail-on-warning ✘
Podpora dry-run ✘
Vrací location ✘

Adresa

Inzerát, který je na serveru: 

https://api.tipmoto.com/c/{ID firmy}/{moto|dily|prislusenstvi}/{ID inzerátu}/stats.{xml|json|html}

Smazaný inzerát (archiv): 

https://api.tipmoto.com/c/{ID firmy}/archive/{moto|dily|prislusenstvi}/{ID inzerátu}/stats.{xml|json|html}

Oprávnění

Parametry

Parametr Hodnoty Výchozí Popis
period day, week, month day Délka jednoho období časové řady: den, týden (ISO, pondělí až neděle) nebo kalendářní měsíc.
from, to RRRR-MM-DD viz Rozsah První a poslední den rozsahu (včetně). Bere se přesně, nepřichytává se na celé týdny ani měsíce: okrajové období useknuté rozsahem má u metrik neuplne="rozsah" a jeho od/do říkají skutečně pokryté dny. Je-li from pozdější než to, prohodí se. Jen from: to = dnes. Jen to: from = to − 27 dní.
location 1, 2, 3, 4 (víc čárkou, např. 1,2) všechna umístění Filtr umístění. Jakýkoli filtr vyřadí dopočítanou historii (umístění 0), takže metriky pak začínají dnem, kdy se začalo měřit podle umístění. Metrika, která ve vybraných umístěních nevzniká, v dokumentu chybí. Opakovaná hodnota se sloučí, prázdné location= znamená bez filtru, 0 je neplatná hodnota.
breakdown location – Rozpad podle umístění: v každém obdobi i v souhrn jsou navíc bloky umisteni (s lokace a metrikami, které v tom umístění vznikají). Bloky akcniOkno a vybirame se při rozpadu přesunou do bloků umisteni a na úrovni obdobi/souhrn pak nejsou. Blok videoUdrzeni se nerozpadá.
detail id, summary, full, custom:… full Které metriky dokument obsahuje, viz úrovně detailu.
no-series true (1), false (0) false true = dokument bez časové řady rada, jen se souhrnem. Zmenší odpověď.
standardní lang, xpath, code-in-response, no-http-errors, sessionid   Fungují jako v celém API, viz URL parametry. xpath vrací XML i u .json.
nepodporované section, order, filter, limit, start, add-row-count, fulltext, ftx-loc, usrval-show   Statistika inzerátu je nepodporuje a vrátí 406, jakmile má parametr neprázdnou hodnotu, i 0 (limit=0 je chyba). Parametr s prázdnou hodnotou (limit=) se bere jako neuvedený.

Neplatná hodnota parametru period, from, to, location, breakdown, detail nebo no-series vrátí 400 s hláškou, která vyjmenuje povolené hodnoty. Na velikosti písmen záleží.

Úrovně detailu

Hodnota Obsah
id Identifikace inzerátu, rozsah a pokrytí metriky jako u full – bez čísel (bez souhrn a rada).
summary Pět základních metrik: zobrazeni, vypis, urlKliknuti, odpovedi, schranka.
full (výchozí) Navíc videoPrehrani, videoDokoukano, blok videoUdrzeni a bloky akcniOkno a vybirame.
custom:… Jen vyjmenované metriky a bloky, čárkou: zobrazeni, vypis, urlKliknuti, odpovedi, schranka, videoPrehrani, videoDokoukano, videoUdrzeni, akcniOkno, vybirame. Např. detail=custom:zobrazeni,odpovedi. Neznámé položky se ignorují jako v celém API; obsahuje-li seznam jen neznámé položky, dokument je jako u detail=id.

Umístění

Kde návštěvník inzerát viděl. Číslo umístění je v prvku lokace, číselník je v agendě lists/lokacestats.

lokace Umístění
0 Nerozlišeno – historie dopočítaná ze záloh (do dopoctenoDo). Objevuje se jen v rozpadu breakdown=location, filtrovat podle ní nelze.
1 www.tipmoto.com
2 Firemní subdoména
3 Výpis na webu klienta (vložený výpis web.tipmoto.com)
4 MotoInzerce.cz

Rozsah

Nula a neměřeno

Neúplné hodnoty (neuplne)

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

Důvod Význam
rozsah Období je useknuté rozsahem (týden nebo měsíc na okraji from/to). V souhrnu nevzniká – ten pokrývá právě použitý rozsah.
mereni Metrika v období začala měřit, má v něm mezeru v datech, nebo jde o neúplný první den měření (4. 9. 2026 u urlKliknuti, 7. 9. 2026 u schranka, 24. 9. 2026 u videa, viz katalog); stačí, když to platí v jednom ze sečtených umístění.
zivot Období obsahuje vložení či smazání inzerátu nebo hranici úseku života. Jen u týdne a měsíce – den vložení a smazání se počítá jako celý.
bezi Období ještě neskončilo (obsahuje dnešek). I v souhrnu, když rozsah obsahuje dnešek.

Příklad period=week&from=2026-09-16&to=2026-09-26 – první týden je useknutý zadaným from, akční okno na MotoInzerce.cz mělo navíc 16. 9. 2026 mezeru v datech: 

<obdobi>
  <od>2026-09-16</od>
  <do>2026-09-20</do>
  <tyden>2026-W38</tyden>
  <zobrazeni neuplne="rozsah" roboti="4" aiRoboti="0">21</zobrazeni>
  …
  <akcniOkno>
    <lokace>4</lokace>
    <zobrazeni neuplne="rozsah,mereni" roboti="0" aiRoboti="0">0</zobrazeni>
    <proklik neuplne="rozsah,mereni" roboti="0" aiRoboti="0">0</proklik>
  </akcniOkno>
  …
</obdobi>

Souhrn (dni, prumerDen)

Roboti

Pokrytí metrik (metriky)

Blok metriky je v dokumentu jednou a popisuje pokrytí přesně pro data v dokumentu (zvolenou granularitu, filtr location a život inzerátu). Metrika, která ve vybraných umístěních či u inzerátu nevzniká (např. video u dílů), v něm není.

Katalog metrik

Klíč Název Sekce a umístění, kde vzniká Data od Detail
zobrazeni Zobrazení detailu moto: 1, 2, 3
dily: 1, 2
prislusenstvi: 1, 2		 viz dostupnost dat; do 28. 8. 2026 dopočet ze záloh, měřeno od 29. 8. 2026 summary
vypis Zobrazení ve výpisu moto: 1, 2, 3
dily: 1, 2
prislusenstvi: 1, 2		 29. 8. 2026 summary
urlKliknuti Proklik na web prodejce moto: 1, 2
dily: 1, 2
prislusenstvi: 1		 4. 9. 2026 (první den neúplný) summary
odpovedi Odpovědi na inzerát moto: 1, 2
dily: 1, 2
prislusenstvi: 1		 viz dostupnost dat; do 7. 9. 2026 dopočet ze záloh, měřeno od 8. 9. 2026. U příslušenství dopočet do 30. 8. 2026 a mezera v datech 31. 8.–7. 9. 2026 summary
schranka Uloženo do schránky moto: 1, 2
dily: 1, 2
prislusenstvi: 1		 7. 9. 2026 (první den neúplný) summary
videoPrehrani Přehrání videa moto: 1, 2 24. 9. 2026 (první den neúplný), u inzerátu až ode dne, kdy video dostal (viz Video) full
videoDokoukano Dokoukáno (video) moto: 1, 2 jako videoPrehrani; jen u videa nahraného na TipMoto full
akcniOkno Akční okno – blok s lokace a metrikami zobrazeni (zobrazení akčního okna) a proklik (proklik z akčního okna) moto: 1, 2, 4
dily: 2
prislusenstvi: nemá		 29. 8. 2026; v umístění 4 mezera v datech 15.–16. 9. 2026 full
vybirame Vybíráme z nabídky (výpis na MotoInzerce.cz) – blok s lokace a metrikami zobrazeni (zobrazení výpisu) a proklik (proklik na inzerát) moto: 4 29. 8. 2026; mezera v datech 15.–16. 9. 2026 full

Umístění viz tabulka umístění; kombinace mimo tabulku neexistuje a v dokumentu chybí. Po měsících jsou data metrik měřených od roku 2026 od prvního měsíce měření. Nový sběr odděluje roboty od prvního dne měření (robotiOd = merenoOd).

Video

Blok videoUdrzeni je jen v souhrn (v řadě ne) a obsahuje jen lidi, bez atributů robotů. Procenta API nepočítá, dopočítáte je z hodnot bloku:

Prvek Význam
od, do Dny, za které blok je: kdy inzerát v rozsahu video měl a existoval, bez neúplného 24. 9. 2026. Mohou se lišit od rozsahu souhrnu.
prehraniVlastni Přehrání videa nahraného na TipMoto – základ pro procenta udržení.
ctvrtina, polovina, triCtvrtiny, dokoukano Kolik z těchto přehrání dosáhlo 25 %, 50 %, 75 % a 90 % skutečně přehraného času.
prehrani Přehrání videa ze všech zdrojů (včetně YouTube). Protože blok nezahrnuje neúplný 24. 9. 2026, může se lišit od videoPrehrani v souhrnu.
zobrazeniDetailu Zobrazení detailu inzerátu za tytéž dny v umístěních 1 a 2 – základ pro podíl „video si pustilo X % návštěv detailu“.

location=1 nebo 2 blok zúží na to umístění, s location=3 nebo 4 blok chybí (tam se video neměří). breakdown=location ho nerozpadá.

Život inzerátu

Položky agendy

Str. název Název Typ Informace
id ID inzerátu integer  
id@ref Odkaz na záznam inzerátu href U smazaného inzerátu do agendy archive.
idApi Externí ID inzerátu string 64 Prázdné, když inzerát externí ID nemá.
section Agenda inzerátu select Možné hodnoty:
  • moto
  • dily
  • prislusenstvi
archiv Smazaný inzerát select Možné hodnoty:
  • 0 Inzerát je na serveru (i znovu zveřejněný)
  • 1 Smazaný inzerát, statistika z archivu
vlozeniCas Vložení inzerátu datetime U znovu zveřejněného inzerátu první vložení.
smazaniCas Smazání inzerátu datetime Prázdné u inzerátu na serveru.
rozsah/od, rozsah/do Použitý rozsah date Chybí u prázdného rozsahu.
rozsah/period Délka období select day, week, month; vždy.
rozsah/pozadovanoOd, rozsah/pozadovanoDo Požadovaný rozsah date Zadaný okraj (po doplnění výchozích hodnot a prohození), jen když se liší od použitého; u prázdného rozsahu vždy.
rozsah/location Filtr umístění string Jen když byl parametr použitý, např. 1,2.
rozsah/breakdown Rozpad select location; jen když byl parametr použitý.
metriky/metrika Pokrytí metriky element Potomci klic, nazev, od, uplneOd, dopoctenoDo, merenoOd, robotiOd, dira, pokryti, poznamka, viz katalog a Pokrytí metrik.
souhrn Souhrn za rozsah element od, do, metriky, videoUdrzeni, bloky akcniOkno, vybirame a (při rozpadu) umisteni.
rada/obdobi Jedno období řady element od, do (skutečně pokryté dny), tyden (jen period=week, např. 2026-W38), mesic (jen period=month, např. 2026-09), metriky, bloky akcniOkno, vybirame a (při rozpadu) umisteni.
{metrika} Hodnota metriky integer Lidé a neurčení návštěvníci, viz katalog.
{metrika}@roboti, {metrika}@aiRoboti Roboti, AI roboti integer Viz Roboti.
{metrika}@neuplne Neúplná hodnota set rozsah, mereni, zivot, bezi (čárkou).
{metrika}@dni, {metrika}@prumerDen Počet dní, průměr za den integer, decimal Jen v souhrn.
akcniOkno, vybirame, umisteni Bloky podle umístění element Umístění je v potomkovi lokace, za ním metriky (v umisteni i bloky akcniOkno a vybirame toho umístění). Bloky jsou seřazené podle lokace vzestupně.
souhrn/videoUdrzeni Udržení videa element Viz Video.

Pořadí potomků je pevné: identifikace (od, do, tyden/mesic), metriky v pořadí katalogu, videoUdrzeni, bloky akcniOkno, vybirame, umisteni.

Příklad

GET /c/12/moto/587316/stats.xml?from=2026-09-24&to=2026-09-26 (zkráceno): 

<!--Dokumentace agendy na: https://api.tipmoto.com/docs/agendas/stats/inzerat/
  Schémata (více o nich na https://api.tipmoto.com/docs/ref/schemata/ ):
    https://api.tipmoto.com/schemas/stats/inzerat.xsd
    https://api.tipmoto.com/schemas/stats/inzerat.rng-->
<tipmoto>
  <!--Statistika jednoho inzerátu. Hodnota 0 = měřilo se a nikdo nepřišel, chybějící metrika = neměřilo se. Hlavní číslo = lidé a neurčení návštěvníci, roboti jsou v atributech.-->
  <stats>
    <id ref="/c/12/moto/587316.xml">587316</id>
    <idApi/>
    <section>moto</section>
    <!--1 = smazaný inzerát (statistika z archivu), 0 = inzerát je na serveru-->
    <archiv>0</archiv>
    <!--Vložení a smazání inzerátu (u znovu zveřejněného inzerátu první vložení; smazaniCas je prázdné u inzerátu, který je na serveru). Kumulativní čítače za celý život jsou v bloku stats záznamu inzerátu.-->
    <vlozeniCas>2025-09-01 18:53:41</vlozeniCas>
    <smazaniCas/>
    <!--Skutečně použitý rozsah. pozadovanoOd/pozadovanoDo jsou jen tehdy, když API rozsah zúžilo (budoucnost, začátek dat, život inzerátu, celé měsíce mimo denní data); location a breakdown jen tehdy, když byly parametry použité.-->
    <rozsah>
      <od>2026-09-24</od>
      <do>2026-09-26</do>
      <period>day</period>
    </rozsah>
    <!--Pokrytí metrik v tomto dokumentu: od = první den s daty (pro zvolenou granularitu, umístění a život inzerátu), dopoctenoDo = do kdy jsou hodnoty dopočítané ze záloh, merenoOd = od kdy jde o nové měření, robotiOd = od kdy jsou roboti oddělení (atributy roboti a aiRoboti).-->
    <metriky>
      <metrika>
        <klic>zobrazeni</klic>
        <nazev>Zobrazení detailu</nazev>
        <od>2025-09-01</od>
        <dopoctenoDo>2026-08-28</dopoctenoDo>
        <merenoOd>2026-08-29</merenoOd>
        <robotiOd>2026-08-29</robotiOd>
      </metrika>
      <!-- … vypis, urlKliknuti, odpovedi, schranka -->
      <metrika>
        <klic>videoPrehrani</klic>
        <nazev>Přehrání videa</nazev>
        <od>2026-09-24</od>
        <merenoOd>2026-09-24</merenoOd>
        <robotiOd>2026-09-24</robotiOd>
        <poznamka>Dokoukání se měří jen u videí nahraných přímo na TipMoto. U videí z YouTube se měří jen přehrání, průběh sledování u nich zjistit nejde.</poznamka>
      </metrika>
      <!-- … videoDokoukano, akcniOkno, vybirame -->
    </metriky>
    <!--Součty za použitý rozsah. dni = počet celých dnů, kdy se metrika měřila a inzerát existoval (bez neúplných dnů a bez dneška), prumerDen = součet za tyto dny / dni. neuplne = hodnota je jen za část rozsahu (rozsah, mereni, zivot, bezi).-->
    <souhrn>
      <od>2026-09-24</od>
      <do>2026-09-26</do>
      <zobrazeni dni="3" prumerDen="4.33" roboti="1" aiRoboti="0">13</zobrazeni>
      <!-- … vypis, urlKliknuti, odpovedi, schranka -->
      <videoPrehrani dni="2" prumerDen="1.00" neuplne="mereni" roboti="0" aiRoboti="0">4</videoPrehrani>
      <videoDokoukano dni="2" prumerDen="1.00" neuplne="mereni" roboti="0" aiRoboti="0">3</videoDokoukano>
      <videoUdrzeni>
        <od>2026-09-25</od>
        <do>2026-09-26</do>
        <prehraniVlastni>2</prehraniVlastni>
        <ctvrtina>2</ctvrtina>
        <polovina>2</polovina>
        <triCtvrtiny>2</triCtvrtiny>
        <dokoukano>2</dokoukano>
        <prehrani>2</prehrani>
        <zobrazeniDetailu>8</zobrazeniDetailu>
      </videoUdrzeni>
      <akcniOkno>
        <lokace>1</lokace>
        <zobrazeni dni="3" prumerDen="177.67" roboti="174" aiRoboti="1">533</zobrazeni>
        <proklik dni="3" prumerDen="0.00" roboti="0" aiRoboti="0">0</proklik>
      </akcniOkno>
      <!-- … akcniOkno 2 a 4, vybirame -->
    </souhrn>
    <!--Časová řada: jeden prvek obdobi na den, týden (ISO) nebo měsíc; od/do jsou skutečně pokryté dny.-->
    <rada>
      <obdobi>
        <od>2026-09-24</od>
        <do>2026-09-24</do>
        <zobrazeni roboti="0" aiRoboti="0">5</zobrazeni>
        <!-- … vypis, urlKliknuti, odpovedi, schranka -->
        <videoPrehrani neuplne="mereni" roboti="0" aiRoboti="0">2</videoPrehrani>
        <videoDokoukano neuplne="mereni" roboti="0" aiRoboti="0">1</videoDokoukano>
        <akcniOkno>
          <lokace>1</lokace>
          <zobrazeni roboti="57" aiRoboti="1">157</zobrazeni>
          <proklik roboti="0" aiRoboti="0">0</proklik>
        </akcniOkno>
        <!-- … akcniOkno 2 a 4, vybirame -->
      </obdobi>
      <!-- … obdobi 2026-09-25 a 2026-09-26 -->
    </rada>
  </stats>
</tipmoto>

JSON

Tentýž dokument jako výše v JSON (zkráceno, … = vynecháno): 

{
  "tipmoto": {
    "stats": {
      "id": "587316",
      "idApi": "",
      "section": "moto",
      "archiv": "0",
      "vlozeniCas": "2025-09-01 18:53:41",
      "smazaniCas": "",
      "rozsah": {"od": "2026-09-24", "do": "2026-09-26", "period": "day"},
      "metriky": {"metrika": [
        {"klic": "zobrazeni", "nazev": "Zobrazení detailu", "od": "2025-09-01", "dopoctenoDo": "2026-08-28", "merenoOd": "2026-08-29", "robotiOd": "2026-08-29"},
        …,
        {"klic": "vybirame", "nazev": "Vybíráme z nabídky", "od": "2026-08-29", "merenoOd": "2026-08-29", "robotiOd": "2026-08-29", "pokryti": [{"lokace": "4", "od": "2026-08-29"}]}
      ]},
      "souhrn": {
        "od": "2026-09-24", "do": "2026-09-26",
        "zobrazeni": "13", "vypis": "145", …, "videoPrehrani": "4", …,
        "vybirame": [{"lokace": "4", "zobrazeni": "0", "proklik": "0", "zobrazeni@dni": "3", "zobrazeni@prumerDen": "0.00", "zobrazeni@roboti": "0", "zobrazeni@aiRoboti": "0", "proklik@dni": "3", "proklik@prumerDen": "0.00", "proklik@roboti": "0", "proklik@aiRoboti": "0"}],
        "zobrazeni@dni": "3", "zobrazeni@prumerDen": "4.33", "zobrazeni@roboti": "1", "zobrazeni@aiRoboti": "0",
        …,
        "videoPrehrani@dni": "2", "videoPrehrani@prumerDen": "1.00", "videoPrehrani@neuplne": "mereni", "videoPrehrani@roboti": "0", "videoPrehrani@aiRoboti": "0",
        …
      },
      "rada": {"obdobi": [
        {"od": "2026-09-24", "do": "2026-09-24", "zobrazeni": "5", …, "videoPrehrani": "2", …,
         "akcniOkno": [{"lokace": "1", "zobrazeni": "157", "proklik": "0", "zobrazeni@roboti": "57", "zobrazeni@aiRoboti": "1", "proklik@roboti": "0", "proklik@aiRoboti": "0"}, …],
         "zobrazeni@roboti": "0", "zobrazeni@aiRoboti": "0", …, "videoPrehrani@neuplne": "mereni", …},
        …
      ]},
      "id@ref": "/c/12/moto/587316.json"
    }
  }
}

Chyby

Chyba má tvar <tipmoto><chyby><chyba>…</chyba></chyby></tipmoto> ve formátu požadavku (.xml, .json, .html) a respektuje lang, code-in-response a no-http-errors, viz Obsluha chyb.

HTTP kód Kdy
400 neplatná hodnota parametru period, from, to, location (i 0), breakdown, detail nebo no-series; hláška vyjmenuje povolené hodnoty
402 login nemá k firmě právo statsperm (i u archivní cesty); firma je pozastavená nebo nemá povolené exporty
404 jiná agenda než moto, dily, prislusenstvi; inzerát není na serveru ani v archivu, nebo nepatří firmě; smazaný inzerát adresovaný přes api-{idApi} na cestě pro inzeráty na serveru; inzerát, který firma pro exportní server loginu skryla
405 jiná metoda než GET
406 nepodporovaný parametr (section, order, filter, limit, start, add-row-count, fulltext, ftx-loc, usrval-show, i s hodnotou 0); externí ID není v archivu firmy jednoznačné; chybný xpath; dotaz je příliš náročný – zkraťte rozsah, použijte period=month nebo vyberte méně metrik (detail=custom:…)
410 smazaný inzerát adresovaný číselným ID na cestě pro inzeráty na serveru; hláška obsahuje adresu jeho statistiky v archivu
500 chyba při vykonání dotazu na našem serveru
503 databázový server je nedostupný; požadavek zopakujte později

Příklad period=blbost: 

<tipmoto>
  <success>false</success>
  <chyby>
    <chyba>Neplatná hodnota 'blbost' URL parametru 'period'. Povolené hodnoty jsou 'day', 'week' a 'month'.</chyba>
  </chyby>
</tipmoto>

Rozšiřitelnost

Prvky, atributy i hodnoty (např. nové metriky, bloky nebo důvody neuplne) mohou přibývat; význam existujícího prvku se nemění. Neznámé prvky, atributy a hodnoty ignorujte. Nové prvky přibývají na konec pevného pořadí. Klient, který výstup validuje, musí po rozšíření použít aktuální schéma. Každé rozšíření zapíšeme do changelogu.

TipMoto.com Kontaktujte nás