Kako namestiti agenta na Shopify

Kam vstaviti kodo v temi Shopify, kako agent bere katalog trgovine, kaj storiti s košarico in plačilom ter kako preveriti namestitev.

6. september 2026

Shopify že ima katalog v strojno berljivi obliki, zato agent zbira izdelke natančneje kot kjer koli drugje: cene, različice, razpoložljivost in fotografije prihajajo neposredno iz trgovine.

Korak 1. Vstavite kodo v temo#

1. V administraciji Shopify odprite Spletna trgovina → Teme.
2. Pri aktivni temi kliknite … → Uredi kodo.
3. Na seznamu datotek poiščite layout/theme.liquid.
4. Vstavite vrstico kode iz nadzorne plošče tik pred zaključno oznako </body>.
5. Shrani.

Alternativa brez urejanja teme: Spletna trgovina → Nastavitve → Koda po meri ali katera koli aplikacija za vstavljanje skript. Rezultat je enak.

    <!-- Commerce Agents -->
<script src="https://comag.vibevox.pro/widget.js" data-slug="vaš-slug" async></script>
  </body>
</html>

Natančno vrstico dobite v nadzorni plošči z gumbom „Kopiraj kodo“: v njej je že vstavljen naslov vaše spletne trgovine.

Korak 2. Zberite katalog#

V nastavitvah navedite naslov trgovine in zaženite analizo. Pajek Shopify bere strukturirane podatke o izdelkih: ime, ceno, valuto, razpoložljivost, opis in fotografije. Različice (velikosti, barve) se v kartico uvrstijo kot lastnosti.

Ponovna analiza posodobi cene in razpoložljivost. Zaženite jo po večjih spremembah asortimana: agent se ne povezuje neposredno z vašo bazo podatkov, temveč deluje z zbranim katalogom.

Korak 3. Pustite plačilo trgovini#

Na Shopifyju plačila v klepetu ni treba vključiti. Pravilna shema je:

1. V nastavitvah trgovine navedite povezavo do košarice — običajno https://vaša-domena/cart.
2. Agent izbere izdelek, prikaže kartico in z gumbom kupca preusmeri v košarico Shopify.
3. Zaključek nakupa in plačilo potekata po običajni poti, z vsemi vašimi pravili dostave in davkov.

Da bi videli, kateri dialogi se končajo z nakupom, vstavite fragment piksla nakupa na stran zahvale. V Shopifyju je to Nastavitve → Blagajna → Stran s statusom naročila → Dodatni skripti. Fragment z vstavljenim številom naročila in zneskom je v nadzorni plošči, v razdelku „Pripomoček in povezava“.

Izdelek pride v košarico, ne da bi prekinil pogovor#

Tukaj se Shopify izkaže bolje kot druge platforme. Agent prikazuje kartice izdelkov s fotografijo, ceno in gumbom, vendar gumb ne vodi zgolj na stran — izdelek doda v košarico trgovine.

To deluje takole: v povezavi izdelka Shopify je identifikator različice, agent ga posreduje vaši košarici prek standardnega vmesnika /cart/add.js. Stran se ne osveži, dialog se ne prekine, kupec vidi kratko potrditev in nadaljuje z izbiranjem. Izdelek je pri tem že v košarici Shopify — z vsemi vašimi pravili popustov, davkov in dostave.

Če različice v povezavi ni, agent odpre kartico izdelka in kupec jo doda sam. Nič se ne pokvari, le en klik več je potreben.

Ko je oseba pripravljena, gumb „Nadaljuj na blagajno“ vodi v /cart, kjer je že vse zbrano. Nato sledi običajna blagajna Shopify.

In še posebej o kontekstu: agent bere strukturirane podatke strani, na kateri je odprt klepet. Kupec si ogleduje določen izdelek in vpraša „je na voljo v velikosti L?“ — agent razume, o čem govori, brez ponovnega spraševanja.

• Odprite trgovino v načinu brez beleženja zgodovine, počakajte na gumb za klepet.
• Vprašajte za izdelek po imenu — prikazati se mora kartica s ceno.
• Kliknite „Nadaljuj na blagajno“ — odpreti se mora košarica Shopify.
• Oddajte testno naročilo in se prepričajte, da je bil nakup zabeležen v „Zahtevkih“.

Klepet v tonu spletne trgovine#

Tema Shopify določa vzdušje celotne trgovine, in klepet ne sme izstopati. V nastavitvah pripomočka so tri možnosti: svetla, temna in „kot pri obiskovalcu“, ki sledi nastavitvam naprave kupca.

Za trgovine s temno temo nastavite temno fiksno, za svetle — svetlo. Poudarjena barva gumbov ostane vaša v obeh primerih.

Korak 4. Preverite#

Pogoste težave#

Pripomoček je izginil po spremembi teme. Koda je v datoteki teme. Sprememba ali posodobitev teme izbriše spremembo — vstavite kodo znova ali uporabite Kodo po meri, ki ni odvisna od teme.

Katalog ni bil zbran v celoti. Pajek zajema izdelke z javnih strani. Skriti pred katalogom in osnutki niso vključeni, kar je pravilno.

Cene v katalogu so zastarele. Zaženite analizo spletnega mesta znova, posodobila bo cene in razpoložljivost obstoječih kartic.

Pripomoček je v konfliktu z aplikacijo za klepet. Pustite en klepet: dve okni v enem kotu si medsebojno ovirata in zmedeta kupca.

Pogosta vprašanja#

Ali je potrebna aplikacija iz Shopify App Store#

Ne. Agent se poveže z eno vrstico kode, aplikacije ni treba namestiti.

Ali agent zna prikazati različice izdelka#

Da, različice se v kartico uvrstijo kot lastnosti: velikost, barva, volumen. Izbiro določene različice kupec opravi v košarici Shopify.

Kaj pa več valut#

Agent prikazuje cene v valuti kataloga, ki jo določi med pregledovanjem. Večvalutnost Shopify deluje naprej, na strani košarice in plačila.

Ali bo agent vedel za zaloge#

Razpoložljivost se zajame v trenutku analize. Za izdelke, ki se pogosto izčrpajo, zaženite analizo pogosteje ali dodajte v pogoje vrstico, da se razpoložljivost preveri ob zaključku nakupa.

Ali pripomoček vpliva na hitrost trgovine#

Skript se naloži asinhrono in ne blokira izrisovanja. Na metrike Core Web Vitals to praktično ne vpliva.