Kako instalirati agenta na Shopify
Gdje umetnuti kod u Shopify temu, kako agent čita katalog trgovine, što učiniti s košaricom i plaćanjem i kako provjeriti instalaciju.
Shopify već ima strojno čitljiv katalog, stoga agent prikuplja proizvode preciznije nego bilo gdje drugdje: cijene, varijante, dostupnost i fotografije dolaze iz same trgovine.
Korak 1. Umetnite kod u temu#
- U adminu Shopifyja otvorite Online Store → Themes.
- Kod aktivne teme kliknite … → Edit code.
- Na popisu datoteka pronađite
layout/theme.liquid. - Umetnite redak koda iz administracijskog sučelja neposredno prije završne oznake
</body>. - Spremite.
Alternativa bez uređivanja teme: Online Store → Preferences → Custom code ili bilo koja aplikacija za umetanje skripti. Rezultat je isti.
<!-- Commerce Agents -->
<script src="https://comag.vibevox.pro/widget.js" data-slug="vaš-slug" async></script>
</body>
</html>
Točan redak uzmite u administracijskom sučelju pomoću gumba „Kopiraj kod“: u njemu je već postavljen URL vaše trgovine.
Korak 2. Prikupljanje kataloga#
U postavkama navedite URL trgovine i pokrenite analizu. Shopify pretraživač čita strukturirane podatke o proizvodima: naziv, cijenu, valutu, dostupnost, opis i fotografije. Varijante (veličine, boje) prikazuju se na kartici kao karakteristike.
Ponovna analiza ažurira cijene i dostupnost. Pokrenite je nakon većih promjena asortimana: agent se ne povezuje izravno s vašom bazom podataka, već radi s prikupljenim katalogom.
Korak 3. Ostavite plaćanje trgovini#
Na Shopifyju ne trebate uključivati plaćanje u chatu. Ispravna shema je:
- U postavkama trgovine navedite poveznicu na košaricu — obično
https://vaša-domena/cart. - Agent odabire proizvod, prikazuje karticu i putem gumba vodi kupca u Shopify košaricu.
- Naplata i plaćanje odvijaju se uobičajenim putem, sa svim vašim pravilima dostave i poreza.
Kako biste vidjeli koji dijalozi završavaju kupnjom, umetnite fragment piksela kupnje na stranicu zahvale. U Shopifyju je to Settings → Checkout → Order status page → Additional scripts. Fragment s umetnutim brojem narudžbe i iznosom nalazi se u administracijskom sučelju, u odjeljku „Widget i poveznica“.
Proizvod ulazi u košaricu bez prekida razgovora#
Ovdje se Shopify pokazuje boljim od ostalih platformi. Agent prikazuje kartice proizvoda s fotografijom, cijenom i gumbom, ali gumb ne samo da vodi na stranicu — on stavlja proizvod u košaricu trgovine.
To funkcionira ovako: u poveznici proizvoda Shopify nalazi se identifikator varijante, agent ga prosljeđuje vašoj košarici putem standardnog sučelja /cart/add.js. Stranica se ne osvježava, dijalog se ne prekida, kupac vidi kratku potvrdu i nastavlja birati. Proizvod je pritom već u Shopify košarici — sa svim vašim pravilima popusta, poreza i dostave.
Ako varijante nema u poveznici, agent otvara karticu proizvoda, a kupac je sam dodaje. Ništa se ne kvari, samo je jedan klik više.
Kada je osoba spremna, gumb „Idi na naplatu“ vodi na /cart, gdje je sve već prikupljeno. Dalje slijedi uobičajena Shopify blagajna.
I zasebno o kontekstu: agent čita strukturirane podatke stranice na kojoj je otvoren chat. Kupac gleda određeni proizvod i pita „ima li u veličini L?“ — agent razumije o čemu je riječ, bez ponovnog postavljanja pitanja.
- Otvorite trgovinu u anonimnom načinu, pričekajte gumb za chat.
- Pitajte za proizvod po nazivu — trebala bi se pojaviti kartica s cijenom.
- Kliknite „Idi na naplatu“ — trebala bi se otvoriti Shopify košarica.
- Izvršite testnu narudžbu i provjerite je li kupnja zabilježena u „Zahtjevima“.
Chat u skladu s izgledom trgovine#
Shopify tema postavlja ton cijeloj trgovini, a chat se ne bi smio izdvajati iz nje. U postavkama widgeta postoje tri opcije: svijetla, tamna i „kao kod posjetitelja“, koja prati postavke uređaja kupca.
Za trgovine s tamnom temom postavite tamnu fiksno, za svijetle — svijetlu. Naglašena boja gumba ostaje vaša u oba slučaja.
Korak 4. Provjerite#
Česti problemi#
Widget je nestao nakon promjene teme. Kod se nalazi u datoteci teme. Promjena ili ažuriranje teme briše izmjenu — umetnite kod ponovno ili koristite Custom code, koji ne ovisi o temi.
Katalog nije u potpunosti prikupljen. Pretraživač uzima proizvode s javnih stranica. Skriveni od kataloga i nacrti ne ulaze, to je ispravno.
Cijene u katalogu su zastarjele. Ponovno pokrenite analizu stranice, ona će ažurirati cijene i dostupnost za postojeće kartice.
Widget se sukobljava s aplikacijom za chat. Ostavite samo jedan chat: dva prozora u istom kutu smetaju jedan drugome i zbunjuju kupca.
Česta pitanja#
Treba li aplikacija iz Shopify App Storea#
Ne. Agent se povezuje jednim retkom koda, aplikaciju nije potrebno instalirati.
Može li agent prikazivati varijante proizvoda#
Da, varijante se prikazuju na kartici kao karakteristike: veličina, boja, volumen. Odabir određene varijante kupac vrši u Shopify košarici.
Što je s više valuta#
Agent prikazuje cijene u valuti kataloga, koju određuje prilikom pretraživanja. Shopifyjeva podrška za više valuta radi dalje, na strani košarice i plaćanja.
Hoće li agent znati o zalihama#
Dostupnost se uzima u trenutku analize. Za proizvode koji se često rasprodaju, pokrenite analizu češće ili dodajte u uvjete redak o tome da se dostupnost provjerava prilikom naplate.
Utječe li widget na brzinu trgovine#
Skripta se učitava asinkrono i ne blokira prikaz. To praktički ne utječe na metrike Core Web Vitals.
