Čo sa deje po napojení#
Akonáhle pripojíte e-shop (Shoptet, Upgates, Shopify — doplnky pre Shopify a Shoptet pripravujeme) alebo reklamný systém či externú službu (Google Ads, Meta, Sklik, Heureka, Google Analytics 4, Search Console), Margly začne sťahovať historické dáta. Nie je to okamžité — záleží na veľkosti vášho e-shopu.
Čo sa sťahuje a v akom poradí#
Produkty (1–3 minúty)
Margly najprv stiahne katalóg produktov — názvy, SKU, ceny, nákupné ceny (pokiaľ ich e-shop poskytuje), kategórie, zásoby. Bez produktov nemožno spočítať marže.
Zákazníci (1–5 minút)
Databáza zákazníkov s e-mailmi, menami, mestom, dátumom registrácie. Slúži na výpočet LTV a opakovaných objednávok.
Objednávky (5–30 minút)
Najviac dát. Margly stiahne plnú históriu, ktorú e-shop cez API/feed poskytuje. Berie objednávky, položky, dopravu, zľavy, storno stavy. Pre priebežné aktualizácie potom Margly pri každom načítaní kontroluje zmeny za posledných 60 dní (typicky zachytí storno, refund, zmeny stavu).
Výpočet marží
Po stiahnutí Margly prepočíta marže, ABC analýzu produktov, kohorty zákazníkov. To trvá ďalšie 1–2 minúty.
Reklamné systémy a externé služby bežia paralelne#
Akonáhle pripojíte reklamné systémy alebo externé služby dostupné v aplikácii, Margly sťahuje dáta týchto platforiem paralelne s e-shopom. Väčšinou je hotovo do 5 minút, pretože reklamných dát je rádovo menej.
Ako spoznám, že je načítanie hotové#
- V sekcii Napojenia v bloku Aktualizácia dát vidíte stav každej platformy. Zelená bodka = hotovo, žltá = beží, červená = chyba.
- Po dokončení dostanete e-mail „Prvý prehľad je pripravený" s odkazom na dashboard.
- V dashboarde sa objavia reálne čísla (dovtedy vidíte placeholdery).
Čo keď načítanie zlyhá#
Najčastejšie príčiny a čo s nimi:
- Neplatný API kľúč / token — vráťte sa do sekcie Napojenia a kľúč obnovte. Postup sa líši podľa platformy:
- Shoptet (API kľúč) — v Shoptet administrácii vygenerujte nový API kľúč a vložte ho v Margly
- Shoptet (CSV feedy) — v Shoptet administrácii obnovte privátne URL feedov (objednávky, produkty, zákazníci) a vložte nové URL v Margly
- Shoptet (autorizovaný doplnok — pripravujeme) / Upgates (doplnok) / Shopify (doplnok — pripravujeme) — token vám doplnok odovzdáva automaticky, takže v prípade zlyhania je nutné doplnok preinštalovať v marketplace danej platformy
- Reklamné systémy a externé služby cez OAuth (Google Ads / Meta / GA4 / Search Console) — kliknite na Znova pripojiť a prejdite OAuth znova so správnym účtom
- Sklik / Heureka (API kľúč) — v danej platforme vygenerujte nový API token a vložte ho v Margly
- Timeout / chyba na strane platformy — veľký e-shop alebo slabšie API. Margly to skúsi znova pri ďalšom plánovanom načítaní. Frekvencia sa líši podľa tarifu — Starter 1×/deň (ráno), Professional 2×/deň (ráno + večer), Business / Enterprise / Trial 4×/deň (ráno, poludnie, večer, noc). Detaily v Aktualizácia dát. O zlyhaní sa dozviete ako in-app notifikáciu (max 1× za deň per e-shop, agreguje všetky sloty aj typy dát — e-mail v tomto prípade neposielame).
- Prekročený limit (429) — platforma vás na chvíľu zablokovala (Google Ads má denné limity). Margly počká do ďalšieho plánovaného načítania.
- Permissions chyba — v Google Ads / Meta nemáte prístup k niektorému účtu, ku ktorému Margly OAuth poslal. Stiahnite si OAuth znova so správnym účtom.
Čo ďalej po prvom prehľade#
- Prejdite si Dashboard prehľad — čo ktorá karta znamená.
- Pokiaľ chýbajú nákupné ceny pri produktoch (Margly ich číta výhradne z napojenej platformy — Shoptet, Upgates, Shopify), doplňte ich v administrácii vášho e-shopu. Margly ich pri ďalšom načítaní dát aktualizuje.
- Po 7 dňoch skúste AI Poradcu — potrebuje aspoň týždeň dát, aby vás spoznal.