Jak Margly aktualizuje data#
Margly stahuje data automaticky na pozadí podle vašeho plánu — z e-shopu (Shoptet / Shopify / Upgates), z reklamních platforem (Google Ads, Meta, Sklik, Heureka), z Google Analytics a Search Console. Nemusíte na nic klikat, Margly se sám připojí a stáhne, co je nového.
Časy aktualizací — 4 denní okna (sloty)#
Margly má 4 pevně dané sloty v UTC, ve kterých probíhá aktualizace. Konkrétní časy se nemění, neposouvají se náhodně:
| Slot | UTC | CZ čas (zima → léto) |
|---|---|---|
| ranní | 03:00 | 04:00 → 05:00 |
| polední | 11:00 | 12:00 → 13:00 |
| večerní | 17:00 | 18:00 → 19:00 |
| noční | 22:00 | 23:00 → 00:00 |
Které sloty pro vás Margly spustí, závisí na plánu (viz tabulka níže).
Kolikrát denně podle plánu#
| Plán | Počet aktualizací / den | Sloty |
|---|---|---|
| Starter | 1× | ranní |
| Professional | 2× | ranní + večerní |
| Business | 4× | ranní + polední + večerní + noční |
| Enterprise | 4× | stejné jako Business |
| Trial (14 dní) | 4× | Margly v trialu jede na úrovni Business |
Co Margly při každé aktualizaci stáhne#
Při každé aktualizaci Margly stáhne nová a změněná data:
- Nové objednávky od poslední aktualizace
- Změny existujících objednávek za posledních 60 dní (storna, vrácení, refundace) — i pozdější změny stavu se promítnou
- Změny produktů (cena, dostupnost, nákupní cena, sazba DPH)
- Nové výdaje z reklamních platforem za poslední dny
První plné stažení celé historie se neděje znovu — proběhlo jen jednou po napojení (viz První načtení dat). Další aktualizace už dotahují jen rozdíly.
Kde vidíte stav aktualizací#
V sekci Napojení (ikona zástrčky v levém menu) najdete blok „Aktualizace dat". Margly tam ukazuje:
- Frekvenci: „Vaše data se aktualizují N× denně" + konkrétní místní časy.
- Příští aktualizaci: „Příští aktualizace přibližně v HH:MM".
- Tabulku posledních aktualizací — datum a čas, slot (ranní / polední / večerní / noční), počet zpracovaných objednávek, stav.
Stavy v tabulce#
Margly nepoužívá emoji — vidíte ikonu a text:
- Úspěšně — aktualizace doběhla, data jsou aktuální.
- Probíhá — aktualizace právě běží (točící se kolečko).
- Částečně — část dat se stáhla, část selhala (typicky timeout u velkého e-shopu). U částečné aktualizace Margly zobrazí kolik záznamů zpracoval a důvod selhání.
- Chyba synchronizace — aktualizace selhala celá. Klikněte pro detail nebo viz Řešení problémů s napojením.
Pod blokem Aktualizace dat je ještě rozbalovací sekce Historie synchronizací — kompletní log všech aktualizací (objednávky, produkty, zákazníci, náklady, GA4, Search Console, Google Ads, Meta Ads, Sklik), kterou si můžete projít.
Ruční načtení dat — kde a za jakých podmínek#
Margly nemá jedno univerzální „Načíst všechna data nyní" tlačítko. Ruční načtení existuje jen u některých napojení a u většiny z nich jen v omezeném režimu — typicky jako záchranná brzda při chybě nebo pro úplně první načtení, ne jako tlačítko „dej mi čerstvá data kdykoli".
Co kde najdete#
| Platforma | Kde tlačítko je | Kdy je aktivní |
|---|---|---|
| Shoptet — CSV import | Napojení → karty Objednávky / Produkty / Zákazníci, tlačítko „Sync nyní" | Jen pokud dnes ještě neproběhlo načtení daného typu. Po dnešním úspěchu tlačítko zšedne a Margly napíše „Dnes již synchronizováno. Další sync proběhne automaticky." Reset až další den. |
| Shoptet — API (ručně ověřený klíč) | Napojení → karta Synchronizace dat, tlačítka u Objednávek / Produktů / Zákazníků | Vyžaduje ověřený API klíč a potvrzená mapování polí. Pak: „Spustit" (před prvním načtením) nebo „Opakovat" (po chybě / částečném načtení). Po úspěchu se přepne na „Dokončeno" a je zablokované — další manuální spuštění až po další chybě. |
| Shoptet — doplněk z App Store | Stejná karta Synchronizace dat | Stejné chování jako u manuálního API klíče — potřebuje potvrzená mapování, pak Spustit / Opakovat / Dokončeno. |
| Shopify | Napojení → karta Synchronizace dat | Po OAuth napojení. Stejné chování: Spustit poprvé → Probíhá… → Dokončeno (zablokované). Opakovat jen při chybě. |
| Upgates | Napojení → karta Synchronizace dat | Po uložení API klíče. Stejné chování jako Shopify. |
| Sklik | Napojení → karta Sklik, tlačítko „Aktualizovat data" | Po napojení opakovaně k dispozici (rate limit 3 spuštění / 5 minut). |
| Heureka | Napojení → karta Heureka, tlačítko „Synchronizovat" | Po napojení satelitu opakovaně k dispozici (rate limit 10 spuštění / 10 minut). |
| Search Console | Reklama → záložka Search Console (ne Napojení!) — tlačítko „Synchronizovat nyní" | Jen jednou — zobrazí se, pokud Margly ještě nemá žádná data ze SC. Po prvním načtení tlačítko zmizí. |
| Google Ads / Meta Ads / Google Analytics | — | Tlačítko vůbec není. Margly tahá tyto platformy výhradně v automatických slotech. |
Co to znamená v praxi#
- U Shoptetu, Shopify a Upgates ručně nezískáte „čerstvá data kdykoli". Tlačítko slouží primárně k opakování po chybě a k prvnímu spuštění. Když poslední automatické načtení proběhlo v pořádku, Margly další manuál nepustí — počká na další slot.
- Shoptet v CSV režimu má hard limit jeden manuální sync na typ dat za kalendářní den.
- Sklik a Heureka můžete spouštět opakovaně (jen v rámci rate limitu).
- Google Ads, Meta Ads a Google Analytics ručně přetáhnout nelze — vždy se čeká na slot.
Kdy má ruční načtení smysl#
Vzhledem k omezením výše to bývají hlavně tyto situace:
- První načtení po napojení, pokud chcete urychlit start (typicky Shopify / Upgates / Shoptet API hned po nastavení).
- Po vyřešení chyby napojení — obnovili jste vypršelý token nebo URL feedu, chcete to ověřit hned (Spustit / Opakovat).
- Bootstrap Search Console — jednorázové stažení dat hned po napojení GSC, abyste nečekali do dalšího slotu.
- Sklik / Heureka — když potřebujete čerstvá čísla z dnešního dne mezi sloty.
Co dělat, když se data nenačtou#
Chybu Margly přeloží do češtiny — nevidíte technické HTTP kódy. Typické hlášky a co s nimi:
- „Neplatný API klíč" nebo „Token vypršel" — obnovte token u platformy (Shoptet admin / Shopify partneři / Google Ads / Meta Business) a uložte nový v napojení v Margly.
- „E-shop nedostupný" / „URL nefunguje" — zkontrolujte URL e-shopu v napojení. Typicky překlep nebo změna domény.
- „Překročen limit požadavků platformy" — platforma vás dočasně omezila. Margly to vyřeší v dalším slotu sám, není potřeba nic dělat.
- „Platforma neodpovídá" / „Platforma má výpadek" — výpadek na straně Google / Meta / Shoptet / Sklik. Počkejte, Margly to v dalším slotu zkusí znovu.
- „Aktualizace byla přerušena (timeout)" — typicky velký e-shop, slabé API protistrany. Pokud se opakuje, napište na support@margly.io.
Detailní průvodce řešením podle platformy: Řešení problémů s napojením.
Co dál#
- První načtení dat — co se děje hned po napojení e-shopu
- Řešení problémů s napojením — když data nedoteklá
- Plány a porovnání — kolik aktualizací denně podle plánu