API dokumentácia

Trackless prijíma dáta cez jednoduché HTTP JSON API. Pre PrestaShop, WordPress/WooCommerce, Joomla / VirtueMart, OpenCart, Magento 2, Shopware 6 a Sylius existujú hotové moduly a pluginy. Na API sa napojí akákoľvek platforma (Shoptet, Shopify, vlastné riešenie) - stačí raz denne (alebo častejšie) poslať dávku dát o návštevách a objednávkach.

Ako Vás napojíme a čo z toho máte

Cesta napojenia závisí od Vašej platformy. Kde môžeme merať priamo na serveri, je meranie najpresnejšie; inde pomôže malý skript. Pri samotnej analytike sa často zaobídete bez vlastných analytických cookies; právny základ a prípadné zaradenie do cookie lišty však vždy posudzujte podľa konkrétneho nasadenia.

Prehľad ciest napojenia Trackless a čo každá z nich dokáže.
Napojenie Súhlas / cookie lišta Závislosť od prehliadača Čo Trackless odmeria
Modul/plugin - PrestaShop, WordPress/WooCommerce, Joomla / VirtueMart, OpenCart, Magento 2, Shopware 6, Sylius Spravidla nie Nízka - meria sa na serveri, prehliadač zákazníka nie je hlavná meracia vrstva Návštevy a skutočné tržby, marža, vratky, ROAS
JavaScript - Shoptet Posúdiť podľa nasadenia Vysoká, nie 100 % - skript beží v prehliadači; pri agresívnom blokovaní meracích skriptov môže časť návštev chýbať Návštevy a objednávky (automaticky)
JavaScript - prenajaté platformy Posúdiť podľa nasadenia Vysoká, nie 100 % - skript beží v prehliadači Návštevy a objednávky; Upgates a Eshop-rychle automaticky, ostatné po doplnení konverzného kódu
JavaScript - Webnode Posúdiť podľa nasadenia Vysoká, nie 100 % - skript beží v prehliadači Len návštevnosť - platforma dáta o objednávkach do prehliadača nepúšťa
Vlastné napojenie (API, Shopify a ďalšie) Podľa integrácie Nízka, ak meriate zo servera (POST /ingest) Podľa Vašej integrácie

Modul meria priamo na serveri e-shopu, takže nie je závislý od skriptu v prehliadači a sám neukladá analytické cookies. Tam, kde platforma vlastný modul nepustí (prenájmy ako Shoptet), použijeme malý skript - ten v prehliadači neukladá cookies, ale stále závisí od toho, či ho prehliadač alebo rozšírenie nezablokuje. Právny základ a cookie lištu posudzujte podľa konkrétneho nasadenia.

Trackless nevytvára trvalý browser identifikátor a nepoužíva vlastné analytické cookies. Denný visitor odtlačok sa mení; agregácia a atribúcia objednávok však môže v rámci atribučného okna pracovať s pseudonymnými technickými údajmi a internými údajmi e-shopu.

Napájate hostovanú platformu? Máme podrobné návody podľa platformy.

Hotové pluginy a moduly

PrestaShop modul
Modul shaim_trackless - v PrestaShope Moduly → Nahrať modul → .zip → nastavte a vložte api_key.
Požiadavky: PrestaShop 1.6+ a PHP 7.1+.
PrestaShop modul z dielne PSModuly.cz
Stiahnuť .zip
WordPress / WooCommerce plugin
Funguje na akomkoľvek WordPresse (návštevnosť); s WooCommerce navyše objednávky a marža. Pluginy → Pridať plugin → vyhľadajte Trackless → Inštalovať → Aktivovať → vložte api_key.
Požiadavky: WordPress 6.2+, PHP 7.4+ (WooCommerce voliteľne - 6.0+, 8.5+ pre atribúciu zdrojov objednávok).
Inštalovať z WordPress.org
Joomla / VirtueMart plugin
Pre Joomla 5.4+ a 6.x - Systém -> Inštalácia rozšírení -> Nahrať balíček -> .zip, potom Systém -> Pluginy -> System - Trackless, vložte api_key a potvrďte spracovateľskú zmluvu.
Požiadavky: Joomla 5.4+ alebo 6.x, PHP 8.1+; pre objednávky VirtueMart 5. Meria návštevnosť, objednávky a položky serverovo, bez zásahu do šablóny.
Otvoriť v Joomla Extensions Directory
OpenCart 3.x modul
Pre OpenCart 3.x - Rozšírenia → Inštalátor → nahrať .ocmod.zip → v sekcii Moduly nainštalovať, vložiť api_key a potvrdiť spracovateľskú zmluvu.
Požiadavky: OpenCart 3.0.3+ a PHP 7.1+. Žiadne zásahy do šablóny ani jadra (event hooky).
Stiahnuť z OpenCart Marketplace
OpenCart 4.x modul
Pre OpenCart 4.x - Rozšírenia → Inštalátor → nahrať .ocmod.zip → v sekcii Moduly nainštalovať, vložiť api_key a potvrdiť spracovateľskú zmluvu.
Požiadavky: OpenCart 4.0+ a PHP 8.0+. Súbor po stiahnutí nepremenúvajte - OpenCart 4 z jeho názvu odvodzuje identitu rozšírenia. Žiadne zásahy do šablóny ani jadra.
Stiahnuť z OpenCart Marketplace
Shopware 6 plugin
Pre Shopware 6.4+ - Rozšírenia → Moje rozšírenia → Nahrať rozšírenie → .zip → inštalovať a aktivovať → v nastavení vložte api_key a potvrďte spracovateľskú zmluvu.
Požiadavky: Shopware 6.4+, PHP 7.4+. Meria na serveri vrátane objednávok a položiek.
Stiahnuť .zip
Magento 2 modul
Pre Magento 2.4+ - vývojárska inštalácia cez konzolu (Magento nemá nahrávanie modulov v administrácii): rozbaľte do app/code/Shaim/Trackless, potom spustite bin/magento module:enable Shaim_Trackless a setup:upgrade → v Stores → Configuration → Trackless vložte api_key a potvrďte spracovateľskú zmluvu.
Požiadavky: Magento 2.4+, PHP 7.4+. Meria na serveri vrátane objednávok, položiek a marží (z poľa cost).
Stiahnuť .zip
Sylius plugin
Pre Sylius 1.12+ - vývojárska inštalácia cez Composer (Sylius nemá nahrávanie pluginov v administrácii): 1) composer require shaim/trackless-sylius-plugin, 2) zaregistrujte bundle v config/bundles.php, 3) nastavte api_key v config/packages/trackless_sylius.yaml, 4) spustite bin/console trackless:set-salt a trackless:send (vytvorí tabuľky).
Požiadavky: Sylius 1.12+, PHP 8.0+. Meria na serveri vrátane objednávok a položiek.
Stiahnuť .zip

Merací JS kód pre prenajaté platformy

Prenajaté platformy a weby, kam sa nedá nahrať serverový modul/plugin, napojíte meracím kódom v šablóne alebo cez Google Tag Manager podľa možností platformy. Kód meria návštevnosť a na podporovaných platformách aj objednávky - stránky, zdroje a kanály, zariadenia, krajiny - bez vlastných analytických cookies; konkrétne posúdenie consent lišty však závisí od celého nastavenia webu. V prehliadači sa neukladá merací identifikátor a návštevník sa pozná len z denne rotovaného serverového odtlačku.

<script async src="https://c.trackless.cz/t.js" data-token="VAS_MERICI_TOKEN"></script>

Po pridaní webu v Moje weby uvidíte podľa platformy buď hotový merací kód, alebo samotný token pre kód z návodu; neskôr ho spravujete v Môj účet. Kam napojenie vložiť:

  • Shoptet: v administrácii otvorte HTML kód (Vzhľad a obsah → Editor) a kód vložte do sekcie Záhlavie - máme pre Vás podrobný návod pre Shoptet.
  • Eshop-rychle: administrácia → E-shop → Měřící kódy → Přidat vlastní kód, pozícia Hlavička - objednávky sa načítajú automaticky z oficiálneho Eshop-rychle dataLayeru; máme pre Vás podrobný návod pre Eshop-rychle.
  • Upgates: administrácia → Doplňky / Vlastní konverzní kódy, oddiel „Kódy umístěné na všech stránkách“, pole pre <head> - máme pre Vás podrobný návod pre Upgates.
  • Webareal: administrácia → Nastavení → Nastavení webu → Základní nastavení, pole „Kód počítadla přístupů“ - máme pre Vás podrobný návod pre Webareal.
  • Webnode: Nastavenia → Nastavenia webu → HTML hlavička webu (vyžaduje platený balíček; návštevnosť, a na balíčku Profi/Business aj objednávky cez pole pre meranie konverzií) - viď návod pre Webnode.
  • Shopify: vložte vlastný pixel v Settings → Customer events → Custom pixels; nepoužíva sa bežný <script> v šablóne - viď návod pre Shopify.
  • FastCentrik: v administrácii sa zadáva iba ID Google Tag Managera; Trackless kód vložte do GTM ako vlastnú HTML značku na všetky stránky, ideálne dynamickým variantom z návodu, aby sa zachoval atribút data-token. Konverziu pridajte ako druhú značku naviazanú na e-commerce dátovú vrstvu - viď návod pre FastCentrik.
  • Mioweb: merací kód vložte do Nastavení → Web → Vlastní kódy pre hlavičku a konverzný kód do Nastavení → Prodej → Vlastní kódy - viď návod pre Mioweb.
  • Akýkoľvek iný web: vložte kód kamkoľvek do <head> šablóny.

Úprimná poznámka: meranie JS kódom môže časť návštev minúť, ak prehliadač alebo rozšírenie blokuje externé meracie skripty. Serverové moduly pre PrestaShop, WordPress/WooCommerce, Joomla / VirtueMart, OpenCart, Magento 2, Shopware 6 a Sylius merajú priamo na serveri, takže sú presnejšie. Marže a detail položiek objednávok však vedia len moduly, ktoré posielajú objednávkové dáta, alebo dávkové API /ingest (samotné objednávky a tržby zvládne aj JS kód).

Štandardné a vlastné udalosti

Popri štandardných udalostiach môžete poslať ľubovoľnú vlastnú udalosť, napríklad lead_submitted, pdf_downloaded alebo video_started. Rovnaké univerzálne volanie funguje pre dopyt, registráciu, stiahnutie, prehratie aj inú akciu. Udalosť order použite po dokončení objednávky.

window.trackless && trackless('event', {
  type: 'lead_submitted',
  id: 123,
  value: 1500.00,
  currency: 'CZK'
});

window.trackless && trackless('event', {
  type: 'order',
  id: 2026001234,
  value: 1169.00,
  value_tax_excl: 966.12,
  value_tax_incl: 1169.00,
  products_tax_excl: 900.00,
  products_tax_incl: 1089.00,
  shipping_tax_excl: 66.12,
  shipping_tax_incl: 80.00,
  currency: 'CZK'
});

Názov má 1-40 znakov, začína malým písmenom a pokračuje iba malými písmenami, číslicami alebo podčiarkovníkom: ^[a-z][a-z0-9_]{0,39}$. Neplatný názov sa uloží ako pageview. Štandardné typy pageview, view_item, view_category, search, view_cart, add_to_cart, begin_checkout, order a engagement majú vstavaný význam. Vlastný typ sa zobrazí v prehľade udalostí, ale automaticky nevstupuje do lievika ani tržieb.

Kontrakt endpointu /collect

POST  https://trackless.cz/collect

Kód t.js posiela na POST /collect malý JSON (ako text/plain, aby obišiel CORS preflight). Cieľ je v t.js predvolený; atribút data-endpoint je len voliteľný override pre testovací alebo vlastný endpoint. Polia: t = verejný merací token, u = celá URL stránky (vrátane utm_*), r = referrer, l = jazyk prehliadača, e = voliteľná udalosť. V bežnej prevádzke je odpoveď vždy 204; pri prekročení limitu vracia 429.

{ "v": 1, "t": "tlc_…", "u": "https://www.muj-eshop.cz/akce?utm_source=newsletter",
  "r": "https://www.google.com/", "l": "cs-CZ",
  "e": { "event_type": "search", "search_query": "tričko" } }

Volajte len z prehliadača návštevníka: identita návštevníka sa počíta z IP adresy a User-Agentu požiadavky - volanie zo servera by počítalo váš server ako jediného návštevníka. Pre serverové napojenia použite dávkové API /ingest. Limity: 300 požiadaviek/min na návštevníka, 4 KB na požiadavku.

Vlastná platforma (API)

Iná platforma alebo vlastné riešenie? Napojte sa priamo na API - najjednoduchšie je začať hotovým príkladom:

Vlastné udalosti zo servera

Do poľa events[] v podpísanej dávke POST /ingest vložte rovnaký event_type ako v JavaScripte. Názov môže opisovať akúkoľvek akciu a voliteľne môžete pridať id_object, quantity, value a currency.

"events": [{
  "id_event": 9001,
  "visitor_uuid": "0123456789abcdef0123456789abcdef",
  "date_add": "2026-07-30 10:15:00",
  "event_type": "lead_submitted",
  "page_type": "cms",
  "id_object": 123,
  "value": "1500.00",
  "currency": "CZK",
  "session_id": "abcdef0123456789abcdef0123456789"
}]

id_event musí byť stabilné a jedinečné v rámci webu, aby opakovanie dávky zostalo idempotentné. Pre spojenie so zdrojom návštevy posielajte aj rovnaké visitor_uuid a session_id ako v touches[]. Objednávky a tržby posielajte cez orders[], nie iba ako udalosť.

⬇ Hotový PHP príklad na stiahnutie
PHP 7.1+ · vyplníte api_key, spustíte a hotovo. Zvládne to aj začiatočník.
Stiahnuť príklad (.php)

OpenAPI 3.0 Strojovo čitateľný kontrakt: /api/openapi.yaml - naimportujte do Postmanu alebo generátora klientov. Alebo si ho prezrite priamo tu v interaktívnom Swagger UI.

Ako často posielať (odporúčaný postup)

Nie je to povinné - API prijme malú aj veľkú dávku kedykoľvek. Napriek tomu dôrazne odporúčame neposielať samostatnú požiadavku na každú návštevu alebo objednávku. Dáta v Trackless nie sú (a nemusia byť) v reálnom čase - reporty sa počítajú po dávkach, takže častým posielaním nič nezískate, len zbytočne pribúda prenosov a záťaže na vašom i našom serveri. Najlepšie a najúspornejšie pre obe strany je zbierať dáta u seba a posielať ich dávkovo.

  • Zbierajte dáta lokálne do fronty (vlastná tabuľka alebo log) a odosielajte ich dávkovo, typicky 1× denne - ideálne v noci mimo špičku, cez cron.
  • Posielajte len nové alebo zmenené dáta. Spoľahlivejšie než len čas posledného 200 je značiť si odoslané riadky (príznakom „odoslané“ alebo podľa updated_at); objednávky, ktorým sa zmenil stav, vďaka idempotentnému upsertu pokojne pošlite znova (krátky prekryv).
  • Chcete čerstvejšie čísla? Pokojne posielajte častejšie (napr. každú hodinu). Skutočný real-time však potrebný nie je.
  • Držte dávku v rozumnej veľkosti - namiesto jednej obrovskej dávky radšej pošlite niekoľko menších za sebou.
  • Číselníky (dimensions) stačí prikladať len občas, keď sa zmenia - nie v každej dávke.
  • Opakovanie je bezpečné (ukladanie je idempotentné, duplicity nevzniknú), ale opakujte len pri 429, 5xx alebo výpadku spojenia - kódy 400/403/409/413 sú trvalé chyby na strane klienta, tam opravte požiadavku alebo kľúč, nie slučku opakovania.

Presne takto fungujú aj naše oficiálne moduly a pluginy pre PrestaShop, WordPress/WooCommerce, Joomla / VirtueMart, OpenCart, Magento 2, Shopware 6 aj Sylius: dáta zbierajú priebežne do lokálnej fronty a cronom ich po dávkach odošlú (typicky raz denne; veľká fronta odíde ako niekoľko dávok za sebou).

Endpoint

POST  https://trackless.cz/ingest

Autentizácia

Každá požiadavka je podpísaná pomocou HMAC-SHA256 z presného (raw) tela požiadavky, kľúčom je api_key daného webu (získate ho po pridaní webu v sekcii Moje weby a neskôr v Môj účet). Podpis sa posiela v hlavičke X-Shaim-Signature ako malými písmenami zapísaný hex.

Úprimná poznámka: meranie JS kódom môže časť návštev minúť, ak prehliadač alebo rozšírenie blokuje externé meracie skripty. Serverové moduly pre PrestaShop, WordPress/WooCommerce, Joomla / VirtueMart, OpenCart, Magento 2, Shopware 6 a Sylius merajú priamo na serveri, takže sú presnejšie. Marže a detail položiek objednávok však vedia len moduly, ktoré posielajú objednávkové dáta, alebo dávkové API /ingest (samotné objednávky a tržby zvládne aj JS kód).

Hlavičky

HlavičkaPovinnáPopis
Content-Typeánoapplication/json
X-Shaim-SignatureánoHMAC-SHA256(raw body, api_key), hex
X-Shaim-ModulenieIdentifikácia integrácie, napr. woocommerce (len pre prehľad v ingest logu)
X-Shaim-VersionnieVerzia vašej integrácie

Telo požiadavky

Jeden JSON objekt - dávka. Všetky kolekcie sú voliteľné; pošlite len to, čo máte. Hodnoty môžu byť reťazce (API ich normalizuje). Kľúčové časti:

PoleTypPopis
shopobjekt{ "id": 1, "domain": "muj-eshop.cz" }
touchespoleNávštevy / zdroje (UTM, referer, kanál, session).
orderspoleObjednávky vrátane tržieb a atribúcie.
order_itemspolePoložky objednávok vrátane wholesale_price (nákupná cena pre maržu).
eventspoleUdalosti (zobrazenie produktu, vyhľadávanie, …).
clientpoleKontext návštevníka (server-side): zariadenie, prehliadač, OS, krajina, jazyk.
dimensionsobjektČíselníky: stavy objednávok, dopravcovia, kategórie, meny, jazyky, platobné moduly.

Úplný zoznam polí každej kolekcie je v OpenAPI špecifikácii.

Príklad tela

{
  "shop": { "id": 1, "domain": "muj-eshop.cz" },
  "orders": [
    { "id_order": 5001, "id_customer": 42, "total_paid": "1290.00",
      "currency": "CZK", "payment": "Card", "date_order": "2026-06-02 10:40:00",
      "current_state": 2, "lt_source": "google", "lt_medium": "cpc" }
  ],
  "order_items": [
    { "id_order_item": 9001, "id_order": 5001, "id_product": 7, "product_name": "Tričko",
      "quantity": 2, "unit_price_tax_excl": "533.06", "total_price_tax_excl": "1066.12",
      "total_price_tax_incl": "1290.00", "wholesale_price": "300.00" }
  ]
}

Odpovede

KódVýznam
200 OKDávka bola úspešne a trvalo uložená.
400Chýba telo/podpis alebo neplatný JSON.
403Neplatný podpis alebo neznámy účet.
409Rovnaký api_key bol použitý pre druhý e-shop (iná doména pri tom istom ID shopu). Nič sa neuložilo - je to trvalý konflikt nastavenia, nie výpadok: neopakujte, opravte kľúč (každý web má mať vlastný api_key). Telo odpovede hovorí, čo urobiť.
413Telo požiadavky je príliš veľké (limit 32 MB) - dávku rozdeľte na menšie časti.
429Prekročený rate limit - dávku po krátkej pauze odošlite znova.
500Uloženie zlyhalo - dávku odošlite znova.

Idempotencia: ukladanie je idempotentné (insert-ignore + upsert podľa ID), takže rovnakú dávku môžete bez obáv poslať znova. Deduplikácia je podľa prirodzeného kľúča (objednávky podľa id_order - upsert, takže zmenenú objednávku stačí poslať znova; položky podľa id_order_item; návštevy a udalosti podľa svojho ID) - vždy posielajte skutočné ID, chýbajúce spadne na 0 a riadky sa prepíšu. Status 200 berte ako úspech až po potvrdenom uložení.

Telo úspešnej odpovede 200 je JSON {"ok":true,"excluded_ips":[…],"geoip":{…}}. excluded_ips je centrálny zoznam vylúčených IP účtu (presné IP aj CIDR rozsahy, IPv4 aj IPv6) - integrácia ho má prečítať a pred ďalším odoslaním lokálne zahodiť zásahy, ktorých IP niektorej položke zodpovedá (vaša integrácia pozná reálnu IP, server dostáva len solený hash). geoip je ukazovateľ na aktuálnu databázu IP→krajina (DB-IP Lite, CC BY 4.0) s poľami version, sha256url; porovnajte sha256 so svojou lokálnou kópiou a stiahnite ju znova len pri zmene (to isté ako GET /api/geoip/country.json alebo /api/geoip/country.dat.gz). Klienti, ktorí telo ignorujú a kontrolujú len stavový kód, fungujú bez zmeny.

Endpointy /ingest aj /collect môžu pri nárazovej prevádzke vrátiť 429 (rate limit) - klient krátko počká a odošle znova.

Príklady podpísania a odoslania

Najjednoduchšie je stiahnuť hotový PHP príklad. Tu je stručná ukážka:

PHP

$apiKey = 'VAS_API_KEY';
$body = json_encode(['shop' => ['id' => 1, 'domain' => 'muj-eshop.cz'], 'orders' => []],
                    JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
$sig  = hash_hmac('sha256', $body, $apiKey);

$ch = curl_init('https://trackless.cz/ingest');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'X-Shaim-Signature: ' . $sig,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 200 = uloženo
// Na 200 nese tělo seznam vyloučených IP účtu - uložte si ho a před
// dalším odesláním zahoďte zásahy s odpovídající IP (přesná shoda i CIDR).
$excludedIps = $status === 200 ? (json_decode($response, true)['excluded_ips'] ?? []) : [];

Node.js

import crypto from 'node:crypto';
const apiKey = 'VAS_API_KEY';
const body = JSON.stringify({ shop: { id: 1, domain: 'muj-eshop.cz' }, orders: [] });
const sig = crypto.createHmac('sha256', apiKey).update(body).digest('hex');
const res = await fetch('https://trackless.cz/ingest', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-Shaim-Signature': sig },
  body,
});
console.log(res.status); // 200 = uloženo

Úprimná poznámka: meranie JS kódom môže časť návštev minúť, ak prehliadač alebo rozšírenie blokuje externé meracie skripty. Serverové moduly pre PrestaShop, WordPress/WooCommerce, Joomla / VirtueMart, OpenCart, Magento 2, Shopware 6 a Sylius merajú priamo na serveri, takže sú presnejšie. Marže a detail položiek objednávok však vedia len moduly, ktoré posielajú objednávkové dáta, alebo dávkové API /ingest (samotné objednávky a tržby zvládne aj JS kód).

Read-only API - stiahnutie vašich dát

Okrem posielania dát do Trackless si ich môžete aj programovo sťahovať von ako JSON - pre vlastné reporty, BI nástroj alebo automatizáciu. Slúži na to samostatný read-only token (oddelený od ingest api_key; kedykoľvek ho môžete pregenerovať, číta len váš účet).

Svoj read-only token nájdete a spravujete po prihlásení v sekcii Môj účet.

Endpointy

GET  https://trackless.cz/api/v1/export/all
GET  https://trackless.cz/api/v1/export/{report}
GET  https://trackless.cz/api/v1/bi/daily

{report} je jeden z: pages, products, channels, categories, campaigns, search, events, devices, os, browsers, countries. Parametre (voliteľné): from, to (RRRR-MM-DD), shop, basis=products|total, attr=lt|ft, vat=0|1.

Autentizácia

Token pošlite v hlavičke Authorization: Bearer <token> (odporúčané) alebo X-Api-Key: <token>. Parameter ?token= funguje tiež, ale použite ho len na rýchle vyskúšanie - končí v histórii prehliadača a v serverových/proxy logoch.

curl -H "Authorization: Bearer VAS_READ_TOKEN" \
  "https://trackless.cz/api/v1/export/all?from=2026-05-01&to=2026-05-31"

Odpoveď je JSON s kľúčmi kpis, traffic, behaviour, profit, cancelled a reports (každý report je pole objektov). Rovnaké dáta ako dashboard a in-app export.

Looker Studio a denné BI dáta

Endpoint GET /api/v1/bi/daily vracia plochý denný časový rad pre BI nástroje. Rozsah fromto zahŕňa oba krajné dni, riadky sú zoradené vzostupne a deň bez aktivity dostane nulový riadok. Filtre: shop, attr=lt|ft, basis=products|total a vat=0|1.

curl -H "Authorization: Bearer VAS_READ_TOKEN" \
  "https://trackless.cz/api/v1/bi/daily?from=2026-05-01&to=2026-05-31&attr=lt&basis=products&vat=0"

Ako bude pripojenie fungovať

  1. Do Looker Studio sa prihlásite vlastným Google účtom.
  2. V konektore zadáte vlastný Trackless read-only token. Token patrí do zabezpečených údajov konektora, nie do URL ani zdieľanej šablóny reportu.
  3. Konektor cez zabezpečenú hlavičku načíta iba účet určený týmto tokenom a vytvorí z neho Váš dátový zdroj.
  4. Použijete vlastný report alebo kópiu pripravenej šablóny. Správca spoločného konektora nezíska prístup k Vášmu Google účtu ani reportu.

Odpoveď obsahuje account, range, filters a rows. Každý riadok má stabilné anglické kľúče a číselné hodnoty pre návštevnosť, objednávky, tržby, vratky, ziskovosť, pokrytie nákupných cien, reklamné náklady a ROAS. Technické polia gross_profit_revenue, cost_lines_with_cost a cost_lines_total umožňujú správne prepočítať vážené ukazovatele pri zoskupení dní do týždňov alebo mesiacov.

Význam metrík: conversion_rate, gross_margin_pct a cost_coverage_pct sú percentá v rozsahu 0-100. Ziskovosť vždy vychádza z produktových riadkov bez DPH. Použije ich skutočnú nákupnú cenu; ak chýba a e-shop má nastavenú predvolenú maržu, použije tento odhad. cost_coverage_pct však počíta iba riadky so skutočnou nákupnou cenou. Výpočet ziskovosti je nezávislý od zvolenej hlavnej bázy tržieb. Reklamné náklady sú vedené za celý účet; pri filtri na jeden e-shop sú ad_cost a roas null, pretože ich Trackless umelo nerozdeľuje medzi e-shopy.

Obmedzenie MVP: jeden Google používateľ má v konektore súčasne uložené prihlásenie k jednému Trackless účtu. Viac e-shopov vnútri tohto účtu je podporovaných filtrom shop.

Zdieľaný Looker Studio konektor je aktívny. Prihláste sa vlastným Google účtom a vložte vlastný Trackless read-only token.

Pripojiť Trackless k Looker Studio

← Späť na úvod