This post is also available in:

V následujícím článku si ukážeme, jak snadno propojit Váš Upgates účet se Sambou pomocí našeho doplňku.
Co vše doplněk zařizuje
Doplněk Samba.ai automaticky nastavuje a spravuje klíčové funkce pro vaši integraci s platformou Samba.ai. Zde je přehled podporovaných oblastí:
-
Datové feedy: Automatická synchronizace zákaznických, produktových a objednávkových feedů z Upgates do Samba.ai.
-
Trackování zákazníků: Plná integrace trackovacích skriptů, které umožní sledovat zákaznické chování na webu. Například opuštění košíku, projevení nákupního zájmu, opakované objednávky konkrétních produktů apod.
Důležité upozornění: Pro plné využití všech funkcí Samba.ai (včetně kapacitně neomezených feedů a pokročilých možností) doporučujeme přejít z omezeného Free plánu na některý z našich placených plánů. Podrobnosti o platebních plánech a možnosti upgradu najdete zde.
Instalace doplňku
V Upgates Marketplace najděte náš doplněk Samba.ai doplněk pro Upgates a klikněte na Aktivovat.
V administraci Upgates pak provedete instalaci doplňku.
Ihned po dokončení instalace doplňku se můžete prokliknout do jeho nastavení. Po prokliku se dostanete na hlavní stránku doplňku, kde můžete přistoupit k iniciálnímu nastavení.
Celý proces propojení doplňku se skládá ze tří kroků.
- Registrace účtu v Sambě
- Propojení účtů
- Datové exporty
1. Zaregistrujte se do Samby
V rámci nastavení doplňku je třeba vyplnit Trackpoint ID vašeho e-shopu, které najdete ve svém účtu Samba. Pokud účet ještě nemáte, je nezbytné si ho vytvořit.
Zde je návod, jak provést registraci v Samba.ai.
Po dokončení registrace naleznete vaše Trackpoint ID v Nastavení účtu > Přehled
Podpora jazykových mutací e-shopu
Doplněk Samba.ai plně podporuje všechny jazykové mutace vašeho e-shopu na platformě Upgates. Pro každou jazykovou verzi (např. CZ, EN, SK) si v systému Samba.ai vytvořte samostatný e-shop účet.
-
Správa v administraci doplňku: Každý účet se spravuje nezávisle v administraci doplňku. To znamená originální a správné Trackpoint ID pro každou mutaci, oddělené nastavení integrace, mapování objednávek, atd.
- Výběr jazykové mutace: Požadovanou jazykovou mutaci si můžete zvolit pomocí rozevíracího seznamu v levé horní části doplňku.
-
Integrace feedů: Feedy se integrují zvlášť pro každou jazykovou mutaci.
Příklad: Pokud máte e-shop s mutacemi CZ/SK/PL, vytvořte si v Sambě tři samostatné účty – vas-eshop-cz, vas-eshop-sk a vas-eshop-pl. Pro CZ mutaci nahrajete feed z Upgates CZ, pro SK mutaci pak SK feed, atd.
2. Propojení účtu
Vaše zkopírované Trackpoint ID vložte v nastavení doplňku do příslušného okna a uložte kliknutím na Pokračovat.
Díky doplňku Samba.ai pro vás odpadá jakékoliv nastavování trackování zákazníků. Vše je na váš web implementováno automaticky skrze doplněk.
Co trackování pokrývá
-
cartInteraction: Sledování interakcí s košíkem. -
customerLoggedIn: Detekce přihlášení zákazníka. -
productId: Identifikace konkrétních produktů. -
order: Kompletní trackování objednávek včetně hodnoty a stavu.
Výsledek: Po aktivaci máte ihned funkční trackování všech těchto klíčových událostí, které Samba.ai využívá.
Kontrola trackování
V administraci vašeho účtu v Samba.ai můžete úspěšnost této implementace zkontrolovat v sekci Nastavení e-shopu > Integrace.
3. Datové exporty
Třetí krok instalace se skládá ze tří částí:
- Konfigurace datových exportů
- Prvotní načtení dat
- Pravidelné načítání dat
3.1 Konfigurace datových exportů
Zde si můžete nakonfigurovat mapování objednávek. Pro každý stav objednávky, který je uvedený v administraci Upgates, si můžete zvolit stav v Sambě. Samba zpracovává jen objednávky označené jako Dokončené. Objednávkám, které nechcete, aby Samba brala v potaz, proto nastavte jiný stav (Rozpracovaná, Zrušená). Například tedy objednávku, kterou v administraci e-shopu evidujete jako Přijatou, můžete v Sambě namapovat jako Dokončenou = Samba s ní bude pracovat.
Dále je zde možnost nastavit tzv. dodatečná nastavení. Ty obsahují volbu mezi využíváním dlouhých a krátkých popisků a používání produktových variant jako separátních produktů.
3.2 Prvotní načtení dat
Zde vám doplněk nabídne URL odkazy tzv. prvotních exportů. Tyto exporty obsahují data za celou historii vašeho e-shopu. Odkazy si lehce zkopírujete najednou pomocí modrého tlačítka „Zkopírovat do schránky“ v doplňku.
Následně přejděte do svého účtu v Samba.ai do sekce Nastavení účtu > Integrace > Nastavení připojení a zde zkopírované URL odkazy vložte. Samba se již sama postará o přiřazení jednotlivých feedů na patřičná místa.
3.3 Pravidelné načítání dat
Po úspěšném prvotním načtení dat v Sambě, prosíme, přejděte na tzv. inkrementální exporty. Tyto exporty obsahují pouze změny z databází od poslední aktualizace dat a pravidelně probíhají 1x denně. Tím je zajištěna neustálá synchronizace dat mezi vaším e-shopem a systémem Samba.ai. Zároveň je díky tomu méně zatěžována infrastruktura a samotná aktualizace dat je rychlejší, protože nemusí pracovat s kompletní databází, ale pouze s inkrementem, což je vyžadováno samotným systémem Upgates.
V této sekci máte vygenerované URL adresy jednotlivých inkrementálních feedů – objednávkový a zákaznický – každý se nastavuje zvlášť. Začneme s objednávkovým feedem:
- URL adresu inkrementálního feedu si jednoduše jedním kliknutím zkopírujte do schránky.

- Následně jděte do Samby do sekce Nastavení účtu > Integrace > Nastavení připojení.
- Zde zvolte u objednávkového feedu typ stahování dat jako Inkrementální. Typ inkrementu ponechte jako Statická URL.
- Nahraďte původní odkaz (z prvotního načtení dat) tím inkrementálním.
Stejným postupem nyní pokračujte s inkrementálním zákaznickým feedem.
Na závěr klikněte v Sambě na tlačítko Uložit konfiguraci.
Pro okamžité načtení feedů můžete nyní v Sambě vyzkoušet ruční Obnovení načtení dat, které bude od této chvíle probíhat automaticky 1x denně.
Kliknutím na Dokončit v rozhraní doplňku si ověříte, že vaše integrace je kompletní. Gratulujeme!
Jak dál s integrací
Samba.ai nabízí celou škálu funkcionalit. Níže najdete seznam funkcí, které si můžete aktivovat ve vašem Samba.ai účtu:
Odinstalace doplňku
Pokud budete chtít doplněk Samba.ai odinstalovat, stačí si v administraci vašeho e-shopu otevřít sekci Doplňky > Seznam doplňků, zde najít Samba.ai a pomocí ikonky v pravém dolním rohu doplněk odinstalovat.














