Kde stav napojení uvidíte#
Stav každého napojení a poslední aktualizace najdete v sekci Napojení (levé menu, ikona zástrčky) — v bloku Aktualizace dat je tabulka s historií posledních spuštění a jejich stavem:
- Úspěšně — načítání dat proběhlo bez chyby
- Probíhá — Margly právě stahuje
- Chyba synchronizace — načtení selhalo
- Částečně — některá data se podařilo stáhnout, něco selhalo
Pod ní je log posledních synchronizací s časy a podrobnostmi.
Nejčastější příčiny selhání#
Neplatný API klíč nebo OAuth token#
Token byl deaktivován, smazán nebo vypršela mu platnost. Margly se k platformě nemůže přihlásit.
Co s tím:
- Otevřete administraci platformy (Shoptet, Google Ads, Meta, Sklik, Heureka).
- U platforem s API klíčem (Shoptet, Sklik, Heureka) vygenerujte nový klíč a vložte ho do Margly v Napojení → [platforma].
- U OAuth platforem (Google, Meta, Upgates / Shopify doplněk) klikněte na Znovu připojit (nebo přeinstalujte doplněk u Upgates / Shopify) a projděte OAuth znovu.
Nedostatečná oprávnění#
Token je platný, ale Margly nemá oprávnění ke konkrétnímu zdroji. Typické u Google Ads Manager (MCC) nebo Meta Business Manageru, kde uživatel není přidán jako oprávněný správce reklamního účtu.
Co s tím:
- V platformě zkontrolujte, že váš účet má alespoň oprávnění ke čtení daného reklamního účtu / property / vlastnictví.
- Pokud spravuje agentura, požádejte je o přidání oprávnění.
- V Margly se odpojte a znovu připojte. Google OAuth při novém přihlášení znovu vyvolá souhlasovou obrazovku; pokud máte v prohlížeči přihlášených víc Google účtů, ukáže se i výběr účtu.
Špatná URL CSV feedu#
URL Shoptet CSV feedu (objednávky / produkty / zákazníci), kterou jste do Margly vložili, není dostupná. Týká se výhradně napojení Shoptet přes CSV feedy — u napojení přes API klíč ani u Upgates / Shopify (přes doplněk) žádnou URL do Margly nezadáváte.
Co s tím:
- Privátní URL Shoptet feedu musí v sobě obsahovat tajný token, který Shoptet při generování feedu vytvoří — bez něj Shoptet feed odmítne stáhnout.
- V Shoptet administraci u dané sekce exportu nesmí být zaškrtnuté omezení „Povolit pouze z konkrétní IP adresy" (u produktů) ani „Permanentní odkaz" (u objednávek a zákazníků).
Přečerpaný limit dotazů (rate limit)#
Externí platforma vás dočasně blokuje kvůli příliš mnoha dotazům. Margly to v rámci běžícího volání zkusí znovu s prodlevami v řádu sekund — konkrétně:
- Sklik a Heureka: prodlevy 1, 3, 10 sekund (až 3 pokusy)
- Meta: prodlevy 5, 15, 60 sekund (až 3 pokusy)
- Shoptet: exponenciální prodlevy se stropem 60 sekund (až 3 pokusy)
Co s tím:
- Většinou nic — Margly to vyřeší v rámci aktuálního běhu sám. Pokud limit přetrvá, zbytek se stáhne při dalším plánovaném načtení podle tarifu.
- Pokud se chyba opakuje denně, napište na support@margly.io.
Výpadek platformy (chyba na straně poskytovatele)#
Externí platforma (Shoptet, Google, Meta, …) má výpadek nebo dočasnou chybu. Není to chyba Margly.
Co s tím:
- Počkejte. Margly to automaticky zkusí znovu při dalším plánovaném načtení dle vašeho tarifu (Starter 1×/den, Professional 2×/den, Business / Enterprise / Trial 4×/den).
- Pro ujištění zkontrolujte stránku stavu dané platformy (např. status.cloud.google.com pro Google služby).
Timeout / dlouhotrvající dotaz#
Velký e-shop nebo slabší API platformy způsobí, že načítání se nestihne dokončit v časovém okně. Margly o selhání vytvoří in-app notifikaci — max 1× za den per e-shop, nezávisle na tom, kolik slotů a kolik typů dat (objednávky / produkty / zákazníci) ten den selhalo. E-mail v tomto případě neposíláme.
Co s tím:
- Pokud jednorázové, ignorujte — Margly to chytne při dalším plánovaném načtení.
- Pokud opakovaně, napište na support@margly.io — můžeme pro váš e-shop nasadit menší dávky stahování.
Co dělat, když Margly nevidí všechna data#
Chybí starší objednávky#
Margly při prvním napojení stáhne historii různě dlouhou podle platformy:
| Platforma | Historie, kterou Margly stahuje |
|---|---|
| Shoptet | Kolik platforma přes API poskytne (Margly nelimituje) |
| Upgates | Kolik platforma přes API poskytne |
| Shopify | Kolik platforma přes Admin API poskytne |
| Google Ads | 365 dní (1 rok) |
| Google Analytics 4 | 365 dní |
| Search Console | 480 dní (cca 16 měsíců) |
| Meta Ads | 730 dní (2 roky) |
| Sklik | 365 dní |
| Heureka | až 730 dní (reálné okno omezuje Heureka API) |
Co s tím:
- Pokud potřebujete delší historii, ozvěte se na support@margly.io — projdeme možnosti individuálně.
Chybí nákupní ceny produktů#
Margly čte nákupní ceny výhradně z napojeného e-shopu (Shoptet, Upgates, Shopify). Pokud je tam nemáte vyplněné, hrubá marže vyjde uměle vysoká — typicky 100 % (revenue mínus nula), nebo se v dashboardu místo procenta zobrazí pomlčka „—".
Co s tím:
- Doplňte nákupní ceny v administraci vašeho e-shopu. Margly je při dalším načtení dat stáhne. Manuální zápis nákupních cen v Margly k dispozici není.
Chybí konverze u reklamních kampaní#
Pro per-kampaň výsledky (tržbu z kampaně, ROAS, POAS, PNO) musí být nasazený konverzní tracking přímo v reklamní platformě:
- Google Ads — konverzní pixel nebo Google Tag Manager s konverzní akcí „Purchase".
- Meta Ads — Meta Pixel s událostí Purchase na e-shopu (případně Conversions API).
- Sklik — Sklik konverzní kód s předáním hodnoty objednávky (bez něj se konverze sice počítají, ale tržbu Sklik nevykáže).
- Heureka — měření konverzí v Heureka administraci (Heureka API bez něj vrátí nulové objednávky a tržby, i když Margly je správně napojený).
Google Analytics 4 přidává v dashboardu pohled na agregované zdroje návštěvnosti (kolik objednávek přišlo z google / cpc, organic, direct apod.). Pro per-kampaň atribuci ale slouží konverzní tracking té dané reklamní platformy, ne GA4.
Jak ručně spustit načtení dat#
Manuální načtení se spouští přímo z karty konkrétního napojení v sekci Napojení (ne z bloku „Aktualizace dat", který jen zobrazuje historii):
- Shoptet, Upgates, Shopify — v sekci napojení e-shopu má každý typ dat (objednávky / produkty / zákazníci) vlastní tlačítko. Label se mění podle stavu („Spustit" / „Probíhá synchronizace" / „Zkusit znovu" / „Hotovo").
- Sklik — v Sklik kartě tlačítko Aktualizovat data.
- Heureka — v Heureka kartě tlačítko Synchronizovat.
- Google a Meta — Margly aktualizuje pouze automaticky, samostatné tlačítko v UI není.
Kdy kontaktovat podporu#
Napište na support@margly.io, pokud:
- Chyba se opakuje 3+ dní v řadě.
- Načítání dat běží déle než 30 minut bez výsledku.
- Vidíte data, která zjevně nesedí (např. tržby na nule, i když máte objednávky v e-shopu).
- V Margly chybí kompletní platforma, kterou potřebujete napojit.
Do e-mailu uveďte: název e-shopu, platformu, časový rozsah problému, screenshot chyby.
Co dál#
- Aktualizace dat — kdy se data automaticky načítají
- První načtení dat — co se děje hned po napojení