Kde stav napojenia uvidíte#
Stav každého napojenia a posledné aktualizácie nájdete v sekcii Napojenia (ľavé menu, ikona zástrčky) — v bloku Aktualizácia dát je tabuľka s históriou posledných spustení a ich stavom:
- Úspešne — načítanie dát prebehlo bez chyby
- Prebieha — Margly práve sťahuje
- Chyba synchronizácie — načítanie zlyhalo
- Čiastočne — niektoré dáta sa podarilo stiahnuť, niečo zlyhalo
Pod ňou je log posledných synchronizácií s časmi a podrobnosťami.
Najčastejšie príčiny zlyhania#
Neplatný API kľúč alebo OAuth token#
Token bol deaktivovaný, zmazaný alebo mu vypršala platnosť. Margly sa k platforme nemôže prihlásiť.
Čo s tým:
- Otvorte administráciu platformy (Shoptet, Google Ads, Meta, Sklik, Heureka).
- Pri platformách s API kľúčom (Shoptet, Sklik, Heureka) vygenerujte nový kľúč a vložte ho do Margly v Napojenia → [platforma].
- Pri OAuth platformách (Google, Meta, Upgates / Shopify doplnok) kliknite na Znova pripojiť (alebo preinštalujte doplnok pri Upgates / Shopify) a prejdite OAuth znova.
Nedostatočné oprávnenia#
Token je platný, ale Margly nemá oprávnenia ku konkrétnemu zdroju. Typické pri Google Ads Manager (MCC) alebo Meta Business Manageri, kde používateľ nie je pridaný ako oprávnený správca reklamného účtu.
Čo s tým:
- V platforme skontrolujte, že váš účet má aspoň oprávnenia na čítanie daného reklamného účtu / property / vlastníctva.
- Pokiaľ spravuje agentúra, požiadajte ich o pridanie oprávnení.
- V Margly sa odpojte a znova pripojte. Google OAuth pri novom prihlásení znova vyvolá súhlasovú obrazovku; pokiaľ máte v prehliadači prihlásených viac Google účtov, ukáže sa aj výber účtu.
Zlá URL CSV feedu#
URL Shoptet CSV feedu (objednávky / produkty / zákazníci), ktorú ste do Margly vložili, nie je dostupná. Týka sa výhradne napojenia Shoptet cez CSV feedy — pri napojení cez API kľúč ani pri Upgates / Shopify (cez doplnok) žiadnu URL do Margly nezadávate.
Čo s tým:
- Privátna URL Shoptet feedu musí v sebe obsahovať tajný token, ktorý Shoptet pri generovaní feedu vytvorí — bez neho Shoptet feed odmietne stiahnuť.
- V Shoptet administrácii pri danej sekcii exportu nesmie byť zaškrtnuté obmedzenie „Povoliť iba z konkrétnej IP adresy" (pri produktoch) ani „Permanentný odkaz" (pri objednávkach a zákazníkoch).
Prečerpaný limit dotazov (rate limit)#
Externá platforma vás dočasne blokuje kvôli príliš mnoho dotazom. Margly to v rámci bežiaceho volania skúsi znova s pauzami v ráde sekúnd — konkrétne:
- Sklik a Heureka: pauzy 1, 3, 10 sekúnd (až 3 pokusy)
- Meta: pauzy 5, 15, 60 sekúnd (až 3 pokusy)
- Shoptet: exponenciálne pauzy so stropom 60 sekúnd (až 3 pokusy)
Čo s tým:
- Väčšinou nič — Margly to vyrieši v rámci aktuálneho behu sám. Pokiaľ limit pretrvá, zvyšok sa stiahne pri ďalšom plánovanom načítaní podľa tarifu.
- Pokiaľ sa chyba opakuje denne, napíšte na support@margly.io.
Výpadok platformy (chyba na strane poskytovateľa)#
Externá platforma (Shoptet, Google, Meta, …) má výpadok alebo dočasnú chybu. Nie je to chyba Margly.
Čo s tým:
- Počkajte. Margly to automaticky skúsi znova pri ďalšom plánovanom načítaní podľa vášho tarifu (Starter 1×/deň, Professional 2×/deň, Business / Enterprise / Trial 4×/deň).
- Pre uistenie skontrolujte stránku stavu danej platformy (napr. status.cloud.google.com pre Google služby).
Timeout / dlhotrvajúci dotaz#
Veľký e-shop alebo slabšie API platformy spôsobí, že načítanie sa nestihne dokončiť v časovom okne. Margly o zlyhaní vytvorí in-app notifikáciu — max 1× za deň per e-shop, nezávisle od toho, koľko slotov a koľko typov dát (objednávky / produkty / zákazníci) ten deň zlyhalo. E-mail v tomto prípade neposielame.
Čo s tým:
- Pokiaľ jednorazové, ignorujte — Margly to chytí pri ďalšom plánovanom načítaní.
- Pokiaľ opakovane, napíšte na support@margly.io — môžeme pre váš e-shop nasadiť menšie dávky sťahovania.
Čo robiť, keď Margly nevidí všetky dáta#
Chýbajú staršie objednávky#
Margly pri prvom napojení stiahne históriu rôzne dlhú podľa platformy:
| Platforma | História, ktorú Margly sťahuje |
|---|---|
| Shoptet | Koľko platforma cez API poskytne (Margly nelimituje) |
| Upgates | Koľko platforma cez API poskytne |
| Shopify | Koľko platforma cez Admin API poskytne |
| Google Ads | 365 dní (1 rok) |
| Google Analytics 4 | 365 dní |
| Search Console | 480 dní (cca 16 mesiacov) |
| Meta Ads | 730 dní (2 roky) |
| Sklik | 365 dní |
| Heureka | až 730 dní (reálne okno obmedzuje Heureka API) |
Čo s tým:
- Pokiaľ potrebujete dlhšiu históriu, ozvite sa na support@margly.io — prejdeme možnosti individuálne.
Chýbajú nákupné ceny produktov#
Margly číta nákupné ceny výhradne z napojeného e-shopu (Shoptet, Upgates, Shopify). Pokiaľ ich tam nemáte vyplnené, hrubá marža vyjde umelo vysoká — typicky 100 % (revenue mínus nula), alebo sa v dashboarde namiesto percenta zobrazí pomlčka „—".
Čo s tým:
- Doplňte nákupné ceny v administrácii vášho e-shopu. Margly ich pri ďalšom načítaní dát stiahne. Manuálny zápis nákupných cien v Margly k dispozícii nie je.
Chýbajú konverzie pri reklamných kampaniach#
Pre per-kampaň výsledky (tržbu z kampane, ROAS, POAS, PNO) musí byť nasadený konverzný tracking priamo v reklamnej platforme:
- Google Ads — konverzný pixel alebo Google Tag Manager s konverznou akciou „Purchase".
- Meta Ads — Meta Pixel s udalosťou Purchase na e-shope (prípadne Conversions API).
- Sklik — Sklik konverzný kód s odovzdaním hodnoty objednávky (bez neho sa konverzie síce počítajú, ale tržbu Sklik nevykáže).
- Heureka — meranie konverzií v Heureka administrácii (Heureka API bez neho vráti nulové objednávky a tržby, aj keď Margly je správne napojený).
Google Analytics 4 pridáva v dashboarde pohľad na agregované zdroje návštevnosti (koľko objednávok prišlo z google / cpc, organic, direct apod.). Pre per-kampaň atribúciu ale slúži konverzný tracking tej danej reklamnej platformy, nie GA4.
Ako ručne spustiť načítanie dát#
Manuálne načítanie sa spúšťa priamo z karty konkrétneho napojenia v sekcii Napojenia (nie z bloku „Aktualizácia dát", ktorý len zobrazuje históriu):
- Shoptet, Upgates, Shopify — v sekcii napojenia e-shopu má každý typ dát (objednávky / produkty / zákazníci) vlastné tlačidlo. Label sa mení podľa stavu („Spustiť" / „Prebieha synchronizácia" / „Skúsiť znova" / „Hotovo").
- Sklik — v Sklik karte tlačidlo Aktualizovať dáta.
- Heureka — v Heureka karte tlačidlo Synchronizovať.
- Google a Meta — Margly aktualizuje iba automaticky, samostatné tlačidlo v UI nie je.
Kedy kontaktovať podporu#
Napíšte na support@margly.io, pokiaľ:
- Chyba sa opakuje 3+ dní v rade.
- Načítanie dát beží dlhšie než 30 minút bez výsledku.
- Vidíte dáta, ktoré zjavne nesedia (napr. tržby na nule, aj keď máte objednávky v e-shope).
- V Margly chýba kompletná platforma, ktorú potrebujete napojiť.
Do e-mailu uveďte: názov e-shopu, platformu, časový rozsah problému, screenshot chyby.
Čo ďalej#
- Aktualizácia dát — kedy sa dáta automaticky načítavajú
- Prvé načítanie dát — čo sa deje hneď po napojení