Integrace Upgates doplňku

This post is also available in: Angličtina

V následujícím článku si ukážeme, jak snadno propojit Váš Upgates účet se Sambou pomocí našeho doplňku.

Doplněk Samba.ai pro Upgates

Doplněk Samba.ai pro Upgates naleznete v Upgates Marketplace ZDE.

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.

Potřebujete s instalací naši pomoc?

Nemáte čas nebo nejste si jisti, jak na to? Žádný problém! Stačí v nastavení doplňku vybrat možnost Potřebuji s integrací pomoc, poslat nám své kontaktní údaje a my za vás integraci dokončíme. Případně se nám rovnou ozvěte na support@samba.ai.

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-czvas-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.

Stavy implementace Trackování zákazníků

V Sambě můžete pozorovat celkem 3 stavy vaší implementace:

  • Modrý: Výchozí stav. Funkce zatím nebyla implementována
  • Žlutý: Stav upozornění. Tento stav upozorňuje na fakt, že některá část implementace není zcela v pořádku. Může se jednat o chybu v rámci některé z metod sledování zákazníků. Může se ale také jednat o fakt, že metoda pouze nebyla delší dobu spuštěna. V každém případě doporučujeme vše zkontrolovat.
  • Zelený: Vše je nastaveno v pořádku.

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. 

Počáteční generování

Upozorňujeme, že počáteční vygenerování prvotních exportů může trvat až 24 hodin. Do té doby vám Samba může hlásit, že se nepodařilo připojit ke zdroji dat. Vyčkejte prosím a zkuste to prosím později. V případě potřeby kontaktujte naši podporu.

3.3 Pravidelné načítání dat

Proč je to důležité?

Prvotní exporty s celou historií objednávek a zákazníků se generují pouze jednorázově či na dotaz, proto je důležité následně přejít k inkrementálnímu zpracování.

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:

  1. URL adresu inkrementálního feedu si jednoduše jedním kliknutím zkopírujte do schránky.
  2. Následně jděte do Samby do sekce Nastavení účtu > Integrace > Nastavení připojení.
  3. Zde zvolte u objednávkového feedu typ stahování dat jako Inkrementální. Typ inkrementu ponechte jako Statická URL.
  4. 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:

Potřebujete s instalací naši pomoc?

Nemáte čas nebo nejste si jisti, jak na to? Žádný problém! Stačí v nastavení doplňku vybrat možnost Potřebuji s integrací pomoc, poslat nám své kontaktní údaje a my za vás integraci dokončíme. Případně se nám rovnou ozvěte na support@samba.ai nebo využijte in-app chat podporu.

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.

This post is also available in: Angličtina

Upraveno 31 března, 2026

Byl pro vás tento článek užitečný?

Mohlo by vás zajímat