Ako Margly aktualizuje dáta#
Margly sťahuje dáta automaticky na pozadí podľa vášho plánu — z e-shopu (Shoptet / Shopify / Upgates), z reklamných platforiem (Google Ads, Meta, Sklik, Heureka), z Google Analytics a Search Console. Nemusíte na nič klikať, Margly sa sám pripojí a stiahne, čo je nové.
Časy aktualizácií — 4 denné okná (sloty)#
Margly má 4 pevne dané sloty v UTC, v ktorých prebieha aktualizácia. Konkrétne časy sa nemenia, neposúvajú sa náhodne:
| Slot | UTC | CZ čas (zima → leto) |
|---|---|---|
| ranný | 03:00 | 04:00 → 05:00 |
| poludný | 11:00 | 12:00 → 13:00 |
| večerný | 17:00 | 18:00 → 19:00 |
| nočný | 22:00 | 23:00 → 00:00 |
Ktoré sloty pre vás Margly spustí, závisí od plánu (pozri tabuľku nižšie).
Koľkokrát denne podľa plánu#
| Plán | Počet aktualizácií / deň | Sloty |
|---|---|---|
| Starter | 1× | ranný |
| Professional | 2× | ranný + večerný |
| Business | 4× | ranný + poludný + večerný + nočný |
| Enterprise | 4× | rovnaké ako Business |
| Trial (14 dní) | 4× | Margly v triale ide na úrovni Business |
Čo Margly pri každej aktualizácii stiahne#
Pri každej aktualizácii Margly stiahne nové a zmenené dáta:
- Nové objednávky od poslednej aktualizácie
- Zmeny existujúcich objednávok za posledných 60 dní (storná, vrátenia, refundácie) — aj neskoršie zmeny stavu sa premietnu
- Zmeny produktov (cena, dostupnosť, nákupná cena, sadzba DPH)
- Nové výdavky z reklamných platforiem za posledné dni
Prvé plné stiahnutie celej histórie sa nedeje znova — prebehlo len raz po napojení (pozri Prvé načítanie dát). Ďalšie aktualizácie už doťahujú len rozdiely.
Kde vidíte stav aktualizácií#
V sekcii Napojenia (ikona zástrčky v ľavom menu) nájdete blok „Aktualizácia dát". Margly tam ukazuje:
- Frekvenciu: „Vaše dáta sa aktualizujú N× denne" + konkrétne miestne časy.
- Ďalšiu aktualizáciu: „Ďalšia aktualizácia približne v HH:MM".
- Tabuľku posledných aktualizácií — dátum a čas, slot (ranný / poludný / večerný / nočný), počet spracovaných objednávok, stav.
Stavy v tabuľke#
Margly nepoužíva emoji — vidíte ikonu a text:
- Úspešne — aktualizácia dobehla, dáta sú aktuálne.
- Prebieha — aktualizácia práve beží (točiace sa koliesko).
- Čiastočne — časť dát sa stiahla, časť zlyhala (typicky timeout pri veľkom e-shope). Pri čiastočnej aktualizácii Margly zobrazí koľko záznamov spracoval a dôvod zlyhania.
- Chyba synchronizácie — aktualizácia zlyhala celá. Kliknite pre detail alebo pozri Riešenie problémov s napojením.
Pod blokom Aktualizácia dát je ešte rozbaľovacia sekcia História synchronizácií — kompletný log všetkých aktualizácií (objednávky, produkty, zákazníci, náklady, GA4, Search Console, Google Ads, Meta Ads, Sklik), ktorú si môžete prejsť.
Ručné načítanie dát — kde a za akých podmienok#
Margly nemá jedno univerzálne „Načítať všetky dáta teraz" tlačidlo. Ručné načítanie existuje len pri niektorých napojeniach a pri väčšine z nich len v obmedzenom režime — typicky ako záchranná brzda pri chybe alebo pre úplne prvé načítanie, nie ako tlačidlo „daj mi čerstvé dáta kedykoľvek".
Čo kde nájdete#
| Platforma | Kde tlačidlo je | Kedy je aktívne |
|---|---|---|
| Shoptet — CSV import | Napojenia → karty Objednávky / Produkty / Zákazníci, tlačidlo „Sync teraz" | Len pokiaľ dnes ešte neprebehlo načítanie daného typu. Po dnešnom úspechu tlačidlo zošedne a Margly napíše „Dnes už synchronizované. Ďalší sync prebehne automaticky." Reset až ďalší deň. |
| Shoptet — API (ručne overený kľúč) | Napojenia → karta Synchronizácia dát, tlačidlá pri Objednávkach / Produktoch / Zákazníkoch | Vyžaduje overený API kľúč a potvrdené mapovania polí. Potom: „Spustiť" (pred prvým načítaním) alebo „Opakovať" (po chybe / čiastočnom načítaní). Po úspechu sa prepne na „Dokončené" a je zablokované — ďalšie manuálne spustenie až po ďalšej chybe. |
| Shoptet — doplnok z App Store | Rovnaká karta Synchronizácia dát | Rovnaké správanie ako pri manuálnom API kľúči — potrebuje potvrdené mapovania, potom Spustiť / Opakovať / Dokončené. |
| Shopify | Napojenia → karta Synchronizácia dát | Po OAuth napojení. Rovnaké správanie: Spustiť prvýkrát → Prebieha… → Dokončené (zablokované). Opakovať len pri chybe. |
| Upgates | Napojenia → karta Synchronizácia dát | Po uložení API kľúča. Rovnaké správanie ako Shopify. |
| Sklik | Napojenia → karta Sklik, tlačidlo „Aktualizovať dáta" | Po napojení opakovane k dispozícii (rate limit 3 spustenia / 5 minút). |
| Heureka | Napojenia → karta Heureka, tlačidlo „Synchronizovať" | Po napojení satelitu opakovane k dispozícii (rate limit 10 spustení / 10 minút). |
| Search Console | Reklama → záložka Search Console (nie Napojenia!) — tlačidlo „Synchronizovať teraz" | Len raz — zobrazí sa, pokiaľ Margly ešte nemá žiadne dáta zo SC. Po prvom načítaní tlačidlo zmizne. |
| Google Ads / Meta Ads / Google Analytics | — | Tlačidlo vôbec nie je. Margly ťahá tieto platformy výhradne v automatických slotoch. |
Čo to znamená v praxi#
- Pri Shoptete, Shopify a Upgates ručne nezískate „čerstvé dáta kedykoľvek". Tlačidlo slúži primárne na opakovanie po chybe a na prvé spustenie. Keď posledné automatické načítanie prebehlo v poriadku, Margly ďalší manuál nepustí — počká na ďalší slot.
- Shoptet v CSV režime má hard limit jeden manuálny sync na typ dát za kalendárny deň.
- Sklik a Heureku môžete spúšťať opakovane (len v rámci rate limitu).
- Google Ads, Meta Ads a Google Analytics ručne pretiahnuť nemožno — vždy sa čaká na slot.
Kedy má ručné načítanie zmysel#
Vzhľadom na obmedzenia vyššie to bývajú hlavne tieto situácie:
- Prvé načítanie po napojení, pokiaľ chcete urýchliť štart (typicky Shopify / Upgates / Shoptet API hneď po nastavení).
- Po vyriešení chyby napojenia — obnovili ste vypršaný token alebo URL feedu, chcete to overiť hneď (Spustiť / Opakovať).
- Bootstrap Search Console — jednorazové stiahnutie dát hneď po napojení GSC, aby ste nečakali do ďalšieho slotu.
- Sklik / Heureka — keď potrebujete čerstvé čísla z dnešného dňa medzi slotmi.
Čo robiť, keď sa dáta nenačítajú#
Chybu Margly preloží do češtiny — nevidíte technické HTTP kódy. Typické hlášky a čo s nimi:
- „Neplatný API kľúč" alebo „Token vypršal" — obnovte token pri platforme (Shoptet admin / Shopify partneri / Google Ads / Meta Business) a uložte nový v napojení v Margly.
- „E-shop nedostupný" / „URL nefunguje" — skontrolujte URL e-shopu v napojení. Typicky preklep alebo zmena domény.
- „Prekročený limit požiadaviek platformy" — platforma vás dočasne obmedzila. Margly to vyrieši v ďalšom slote sám, nie je potreba nič robiť.
- „Platforma neodpovedá" / „Platforma má výpadok" — výpadok na strane Google / Meta / Shoptet / Sklik. Počkajte, Margly to v ďalšom slote skúsi znova.
- „Aktualizácia bola prerušená (timeout)" — typicky veľký e-shop, slabé API protistrany. Pokiaľ sa opakuje, napíšte na support@margly.io.
Detailný sprievodca riešením podľa platformy: Riešenie problémov s napojením.
Čo ďalej#
- Prvé načítanie dát — čo sa deje hneď po napojení e-shopu
- Riešenie problémov s napojením — keď dáta nepritečené
- Plány a porovnanie — koľko aktualizácií denne podľa plánu