Ako nainštalovať agenta na Shopify
Kam vložiť kód do témy Shopify, ako agent číta katalóg obchodu, čo robiť s košíkom a platbou a ako skontrolovať inštaláciu.
Shopify už má katalóg v strojovo čitateľnej forme, preto agent zbiera tovary presnejšie ako kdekoľvek inde: ceny, varianty, dostupnosť a fotografie pochádzajú priamo z obchodu.
Krok 1. Vložte kód do témy#
- V administrácii Shopify otvorte Online Store → Themes.
- Pri aktívnej téme kliknite na … → Edit code.
- V zozname súborov nájdite
layout/theme.liquid. - Vložte riadok kódu z rozhrania priamo pred uzatváraciu značku
</body>. - Uložte.
Alternatíva bez úpravy témy: Online Store → Preferences → Custom code alebo akákoľvek aplikácia na vkladanie skriptov. Výsledok je rovnaký.
<!-- Commerce Agents -->
`<script src="https://comag.vibevox.pro/widget.js" data-slug="váš-slug" async></script>`
</body>
</html>Presný riadok nájdete v rozhraní pod tlačidlom „Kopírovať kód“: v ňom je už prednastavená adresa vášho e-shopu.
Krok 2. Zozbierajte katalóg#
V nastaveniach zadajte adresu obchodu a spustite analýzu. Prehľadávač Shopify číta štruktúrované údaje o tovaroch: názov, cenu, menu, dostupnosť, popis a fotografie. Varianty (veľkosti, farby) sa do karty dostanú ako vlastnosti.
Opakovaná analýza aktualizuje ceny a dostupnosť. Spustite ju po rozsiahlych zmenách sortimentu: agent sa nepripája k vašej databáze priamo, ale pracuje so zozbieraným katalógom.
Krok 3. Nechajte platbu na obchod#
Na Shopify netreba zapínať platbu v chate. Správna schéma:
- V nastaveniach obchodu zadajte odkaz na košík — zvyčajne
https://váš-doména/cart. - Agent vyberie tovar, zobrazí kartu a pomocou tlačidla vedie kupujúceho do košíka Shopify.
- Objednávka a platba prebiehajú obvyklým spôsobom, so všetkými vašimi pravidlami doručenia a daní.
Ak chcete vidieť, ktoré dialógy končia nákupom, vložte fragment nákupného pixela na stránku s poďakovaním. V Shopify je to Settings → Checkout → Order status page → Additional scripts. Fragment s doplnením čísla objednávky a sumy nájdete v rozhraní, v sekcii „Widget a odkaz“.
Tovar sa dostane do košíka bez prerušenia konverzácie#
Tu sa Shopify prejavuje lepšie ako ostatné platformy. Agent zobrazuje karty tovarov s fotografiou, cenou a tlačidlom, no tlačidlo nielenže vedie na stránku — ono vloží tovar priamo do košíka obchodu.
Funguje to takto: v odkaze na tovar Shopify je identifikátor variantu, agent ho prenesie do vášho košíka cez štandardné rozhranie /cart/add.js. Stránka sa neobnovuje, dialóg sa neprerušuje, kupujúci vidí krátke potvrdenie a pokračuje vo výbere. Tovar je pritom už v košíku Shopify — so všetkými vašimi pravidlami zliav, daní a doručenia.
Ak variant v odkaze nie je, agent otvorí kartu tovaru a kupujúci si ho pridá sám. Nič sa nepokazí, je to len o jedno kliknutie viac.
Keď je človek pripravený, tlačidlo „Prejsť k objednávke“ vedie do /cart, kde je už všetko pripravené. Ďalej — bežná pokladňa Shopify.
A samostatne o kontexte: agent číta štruktúrované údaje stránky, na ktorej je otvorený chat. Kupujúci si prezerá konkrétny tovar a pýta sa „je to vo veľkosti L?“ — agent rozumie, o čo ide, bez dodatočných otázok.
- Otvorte obchod v inkognito režime, počkajte na tlačidlo chatu.
- Opýtajte sa na tovar podľa názvu — mala by sa objaviť karta s cenou.
- Kliknite na „Prejsť k objednávke“ — mal by sa otvoriť košík Shopify.
- Vytvorte testovaciu objednávku a uistite sa, že sa nákup zaznamenal v „Žiadostiach“.
Chat v tóne e-shopu#
Téma Shopify udáva náladu celému obchodu a chat by z nej nemal vybočovať. V nastaveniach widgetu sú tri varianty: svetlá, tmavá a „ako u návštevníka“, ktorá sa riadi nastaveniami zariadenia kupujúceho.
Pre obchody s tmavou témou nastavte tmavú napevno, pre svetlé — svetlú. Akcentová farba tlačidiel zostáva vaša v oboch prípadoch.
Krok 4. Skontrolujte#
Časté problémy#
Widget zmizol po zmene témy. Kód sa nachádza v súbore témy. Zmena alebo aktualizácia témy vymaže úpravu — vložte kód znova alebo použite Custom code, ktorý od témy nezávisí.
Katalóg sa nezozbieral úplne. Prehľadávač berie tovary z verejných stránok. Skryté z katalógu a koncepty sa nezahŕňajú, čo je správne.
Ceny v katalógu sú zastarané. Spustite analýzu stránky znova, aktualizuje ceny a dostupnosť podľa existujúcich kariet.
Widget koliduje s aplikáciou chatu. Ponechajte jeden chat: dve okná v jednom rohu si navzájom prekážajú a mätú kupujúceho.
Časté otázky#
Je potrebné mať aplikáciu z Shopify App Store#
Nie. Agent sa pripája jedným riadkom kódu, aplikáciu nie je potrebné inštalovať.
Vie agent zobrazovať varianty tovaru#
Áno, varianty sa dostanú do karty ako vlastnosti: veľkosť, farba, objem. Výber konkrétneho variantu kupujúci vykoná v košíku Shopify.
Ako je to s viacerými menami#
Agent zobrazuje ceny v mene katalógu, ktorú určí pri prehľadávaní. Multimenovosť Shopify funguje ďalej, na strane košíka a platby.
Bude agent vedieť o zásobách#
Dostupnosť sa berie v čase analýzy. Pre tovary, ktoré sa často vypredajú, spúšťajte analýzu častejšie alebo pridajte do podmienok riadok o tom, že dostupnosť sa overuje pri objednávke.
Ovplyvňuje widget rýchlosť obchodu#
Skript sa načíta asynchrónne a neblokuje vykresľovanie. Na metriky Core Web Vitals to prakticky nemá vplyv.