Co se děje po napojení#
Jakmile připojíte e-shop (Shoptet, Upgates, Shopify — doplňky pro Shopify a Shoptet připravujeme) nebo reklamní systém či externí službu (Google Ads, Meta, Sklik, Heureka, Google Analytics 4, Search Console), Margly začne stahovat historická data. Není to okamžité — záleží na velikosti vašeho e-shopu.
Co se stahuje a v jakém pořadí#
Produkty (1–3 minuty)
Margly nejdřív stáhne katalog produktů — názvy, SKU, ceny, nákupní ceny (pokud je e-shop poskytuje), kategorie, zásoby. Bez produktů nelze spočítat marže.
Zákazníci (1–5 minut)
Databáze zákazníků s e-maily, jmény, městem, datem registrace. Slouží k výpočtu LTV a opakovaných objednávek.
Objednávky (5–30 minut)
Nejvíc dat. Margly stáhne plnou historii, kterou e-shop přes API/feed poskytuje. Bere objednávky, položky, dopravu, slevy, storno stavy. Pro průběžné aktualizace pak Margly při každém načtení kontroluje změny za posledních 60 dní (typicky zachytí storno, refund, změny stavu).
Výpočet marží
Po stažení Margly přepočítá marže, ABC analýzu produktů, kohorty zákazníků. To trvá další 1–2 minuty.
Reklamní systémy a externí služby běží paralelně#
Jakmile připojíte reklamní systémy nebo externí služby dostupné v aplikaci, Margly stahuje data těchto platforem paralelně s e-shopem. Většinou je hotovo do 5 minut, protože reklamních dat je řádově méně.
Jak poznám, že je načtení hotové#
- V sekci Napojení v bloku Aktualizace dat vidíte stav každé platformy. Zelený puntík = hotovo, žlutý = běží, červený = chyba.
- Po dokončení dostanete e-mail „První přehled je připraven" s odkazem na dashboard.
- V dashboardu se objeví reálná čísla (do té doby vidíte placeholdery).
Co když načtení selže#
Nejčastější příčiny a co s nimi:
- Neplatný API klíč / token — vraťte se do sekce Napojení a klíč obnovte. Postup se liší podle platformy:
- Shoptet (API klíč) — v Shoptet administraci vygenerujte nový API klíč a vložte ho v Margly
- Shoptet (CSV feedy) — v Shoptet administraci obnovte privátní URL feedů (objednávky, produkty, zákazníci) a vložte nové URL v Margly
- Shoptet (autorizovaný doplněk — připravujeme) / Upgates (doplněk) / Shopify (doplněk — připravujeme) — token vám doplněk předává automaticky, takže v případě selhání je nutné doplněk přeinstalovat v marketplace dané platformy
- Reklamní systémy a externí služby přes OAuth (Google Ads / Meta / GA4 / Search Console) — klikněte na Znovu připojit a projděte OAuth znovu se správným účtem
- Sklik / Heureka (API klíč) — v dané platformě vygenerujte nový API token a vložte ho v Margly
- Timeout / chyba na straně platformy — velký e-shop nebo slabší API. Margly to zkusí znovu při dalším plánovaném načtení. Frekvence se liší podle tarifu — Starter 1×/den (ráno), Professional 2×/den (ráno + večer), Business / Enterprise / Trial 4×/den (ráno, poledne, večer, noc). Detaily v Aktualizace dat. O selhání se dozvíte jako in-app notifikaci (max 1× za den per e-shop, agreguje všechny sloty i typy dat — e-mail v tomto případě neposíláme).
- Překročený limit (429) — platforma vás na chvíli zablokovala (Google Ads má denní limity). Margly počká do dalšího plánovaného načtení.
- Permissions chyba — v Google Ads / Meta nemáte přístup k některému účtu, ke kterému Margly OAuth poslal. Stáhněte si OAuth znovu se správným účtem.
Co dál po prvním přehledu#
- Projděte si Dashboard přehled — co která karta znamená.
- Pokud chybí nákupní ceny u produktů (Margly je čte výhradně z napojené platformy — Shoptet, Upgates, Shopify), doplňte je v administraci vašeho e-shopu. Margly je při dalším načtení dat aktualizuje.
- Po 7 dnech zkuste AI Poradce — potřebuje aspoň týden dat, aby vás poznal.