Miten AI Commercen haku toimii kahdella hakukoneella?

AI Commercen haku toimii kahdella hakukoneella: se käyttää joko Algolia-integraatiota tai sisäänrakennettua tietokantahakua. Algolia valitaan, kun kaupalle on määritetty sekä ALGOLIA_APP_ID että ALGOLIA_API_KEY. Jos jompikumpi tunnus puuttuu, haku käyttää automaattisesti tietokantahakua. Molemmissa tavoissa tulokset muodostetaan nykyisen kauppakielen perusteella.

Valinta tehdään ennen hakua. Jos määritetty Algolia-haku epäonnistuu ajon aikana, järjestelmä ei siirry samassa pyynnössä tietokantahakuun, vaan palauttaa tyhjän tuloksen ja haun tilapäisestä häiriöstä kertovan virheen. Tämä ero on tärkeä vianmäärityksessä: tietokantahaku on puuttuvien Algolia-tunnusten vaihtoehto, ei Algolian ajonaikaisen virheen piilotettu varajärjestelmä.

Algolia-haussa tuotteita pyydetään enintään 10 ja kategorioita enintään 10; kategorioista hydratoidaan paikallisesta tietokannasta enintään 5. Tietokantahaku rajaa näkyvän tuotelistan 10 parhaaseen ja kategoriaosumat 5 parhaaseen.

Paranna tuotehaun löydettävyyttä

AI Commerce -tuotehaun löydettävyyttä parannetaan Tuotteet-näkymässä täyttämällä asiakkaalle näkyvä tuotenimi jokaisella kielellä. Pidä nimi lyhyenä ja informatiivisena ja sijoita tärkeimmät sanat, kuten brändi ja malli, alkuun. Täytä myös tuotteen SKU/malli, koska tietokantahaku painottaa nimeä ja mallikoodia voimakkaasti.

Lisää variaatioiden mallikoodit ja viivakoodit, jotta suora koodihaku löytää oikean tuoteversion. Täytä Lyhyt kuvaus ja varsinainen Kuvaus jokaisella kielellä; ne auttavat epäsuorissa hauissa pienemmällä painolla. Varmista lisäksi valmistajan nimi ja ylläpidä Tuotetagit-näkymässä kielikohtaiset tagit aiheille, synonyymeille, kampanjoille ja sesongeille. Hallintapaneelin kenttämuutokset tallentuvat heti.

Paranna kategoriahaun löydettävyyttä

AI Commerce -kategoriahaun löydettävyyttä parannetaan Kategoriat-näkymässä täyttämällä selkeä kategorian nimi ja URL-osa jokaisella käytössä olevalla kielellä. Tietokantahaku painottaa kategorian nimeä ja URL-osaa voimakkaasti, joten niiden tulee kuvata asiakkaan käyttämää käsitettä ilman tarpeetonta sisäistä sanastoa.

Täytä myös kategorian yläkuvaus eli tuotelistauksen yläpuolella näkyvä kuvaus. Kuvaustekstin paino on nimeä pienempi, mutta se auttaa laajemmissa ja epäsuorissa hakutermeissä. Pidä eri kieliversioiden nimet, URL-osat ja kuvaukset sisällöllisesti vastaavina. Hallintapaneelin kenttämuutokset tallentuvat heti.

Hallitse Algolia-asetuksia

AI Commerce -Algolia-haku otetaan käyttöön Konfiguraatiot-näkymän Integraatiot-osiossa määrittämällä Algolian sovellus-ID ja API-avain. Sovellus-ID:n näkyvä nimi on Algolian sovellus-ID, ja API-avain on salainen arvo. Kun molemmat tunnukset ovat käytössä, kaupan asiakasnäkymän haku valitsee Algolian tietokantahaun sijasta.

Algolia-indeksien pitää olla ajan tasalla suhteessa kaupan tuotteisiin, kategorioihin, kieliin, tageihin, valmistajiin ja variaatiokoodeihin. Jos tunnukset ovat määritettyinä mutta haku palauttaa tilapäisen virheen, tarkista Algolia-yhteys, indeksit ja tunnukset; ajonaikainen virhe ei käynnistä automaattista SQL-varahakua.

Tietokantahaun tuotepainot

AI Commerce -tietokantahaun tuoteosumat pisteytetään kentän ja hakutavan mukaan. LIKE tarkoittaa osittaista merkkijono-osumaa, FULLTEXT BOOLEAN termipohjaista boolean-hakua ja FULLTEXT NATURAL LANGUAGE luonnollisen kielen fulltext-hakua. Saman tuotteen osumat eri kentissä kertyvät relevanssipisteiksi.

Tietokantahaun kategoriapainot

AI Commerce -tietokantahaun kategoriaosumat pisteytetään kolmesta kenttäryhmästä. Kategorian nimi ja URL-osa saavat boolean-fulltext-haussa painon 200, kategorian nimi saa lisäksi LIKE-haussa painon 200 ja kategorian yläkuvaus saa luonnollisen kielen haussa painon 10.

Kategoriahaussa kieli rajataan nykyiseen kauppakieleen, osumat järjestetään relevanssipisteen mukaan ja tietokantahaku palauttaa enintään 5 kategoriaa. Selkeä nimi ratkaisee siksi useammin kuin pitkä kuvaus.

Algolia-haun käsittely

AI Commerce -Algolia-haku lähettää yhden multi-query-pyynnön indekseihin <APP_ALIAS>_products ja <APP_ALIAS>_categories. Molempiin kyselyihin lisätään suodatus languageId = nykyinen kieli, ja Algolialta pyydetään vain osuvien tuotteiden ja kategorioiden ID:t. Tuotteita ja kategorioita pyydetään kummastakin enintään 10.

Näkyvät tuote- ja kategoriatiedot hydratoidaan ID-listojen perusteella paikallisesta tietokannasta nykyisellä kielellä. Tuotteiden näkyvä enimmäismäärä on 10 ja kategorioiden 5. Algolian oma indeksikonfiguraatio määrää sen sisäisen relevanssin; tässä kuvatut SQL-painot 400, 200, 100, 70, 50 ja 10 koskevat vain sisäänrakennettua tietokantahakua.

Sisäänrakennetun tietokantahaun käsittely

AI Commerce -sisäänrakennetun tietokantahaun käsittely käynnistyy, kun Algolia-tunnuksia ei ole määritetty. Hakuteksti puretaan sanoiksi, tyhjät sekä pelkän -- tai +-merkin sisältävät osat poistetaan ja käyttöön otetaan enintään kolme ensimmäistä merkittävää termiä. Haku suoritetaan quick-search-tyyppinä edellä kuvatuilla LIKE-, FULLTEXT BOOLEAN- ja FULLTEXT NATURAL LANGUAGE -ehdoilla.

Tietokantahaku laskee tuotteille ja kategorioille relevanssipisteet kenttäkohtaisten painojen summana ja järjestää osumat laskevasti. Tuotekysely valmistellaan enintään 20 ehdokkaalle, mutta asiakkaalle palautettava tuotelista katkaistaan 10 parhaaseen. Kategoriakysely palauttaa enintään 5 osumaa.

Testaa haku asiakkaan termeillä

AI Commerce -haun testaaminen asiakkaan termeillä kattaa nimet, mallit, SKU-koodit, viivakoodit, brändit ja synonyymit jokaisella kaupan kielellä. Testaa erityisesti kolmen tärkeimmän termin yhdistelmiä, koska sisäänrakennettu tietokantahaku käyttää enintään kolmea ensimmäistä merkittävää sanaa.

Jos tulos ei nouse odotetusti, tarkista ensin tuotenimi, SKU, variaation mallikoodi, viivakoodi, valmistaja, tagit ja kieli. Tarkista kategorioille nimi, URL-osa ja yläkuvaus. Algolia-kaupassa varmista lisäksi indeksin ajantasaisuus. Näin täsmälliset koodit ja selkeät nimet nostavat suorat osumat, kun taas tagit ja kuvaukset tukevat laajempia hakuja.