Tämän ohjeen avulla ymmärrät, miten AI Commercen haku löytää tuotteet ja kategoriat ja miten voit sisällöllä vaikuttaa tulosten relevanssiin. Käytännön vinkeillä varmistat, että asiakkaat löytävät oikean tuotteen nopeasti – riippumatta siitä, käytetäänkö Algoliaa vai sisäänrakennettua tietokantahakua.

Pääperiaatteet lyhyesti

• Haku toimii kahdella tavalla: Algolia-integraatio tai automaattinen tietokantahaku (fallback).
• Algolia-haussa haku kohdistuu sekä tuotteisiin että kategorioihin ja huomioi kaupan kielen.
• Tietokantahaussa termeistä normalisoidaan vain kolme merkittävintä sanaa, ja osumat pisteytetään kenttäkohtaisilla painoilla.
• Tulokset rajataan nopeuden ja relevanssin varmistamiseksi: tuotteet max 10, kategoriat tyypillisesti 5–10 (Algoliassa 10 haetaan, joista 5 näytetään).

Vaiheittainen ohje: paranna löydettävyyttä

1. Nimeä tuotteet selkeästi
   • Täytä Tuotteen nimi (products_name) kullekin kielelle. Haku painottaa tätä voimakkaasti.
   • Pidä tärkeimmät avainsanat nimen alussa (esim. brändi + malli).
2. Lisää malli- ja koodikentät
   • Täytä Tuotemalli/SKU (products_model) sekä variaatioiden mallikoodi (products_stock_model).
   • Lisää viivakoodit/UPC:t variaatioille (products_stock_barcode). Haku löytää suorat koodisyötteet nopeasti.
3. Hyödynnä tagit ja brändi
   • Käytä Tuotteen tagit (products_tags) per kieli nostamaan teemoja ja synonyymejä.
   • Varmista Valmistajan nimi (manufacturers_name) on oikein – brändihaku toimii tämän kautta.
4. Kirjoita informatiiviset kuvaukset
   • Täytä Tuotteen lyhyt kuvaus (products_short_description) ja Tuotteen kuvaus (products_description). Näitä käytetään matalammalla painolla, mutta ne auttavat epäsuorissa hauissa.
5. Huolehdi kategorioiden laadusta
   • Täytä Kategorian nimi (categories_name) ja Kategorian URL (categories_url) selkeästi.
   • Käytä Kategorian lyhyt kuvaus (categories_description_top) tukemaan laajempia hakutermejä.
6. Muista monikielisyys
   • Algolia ja fallback-haku huomioivat kielen. Täytä nimet, kuvaukset ja tagit jokaiselle kielelle.
7. Testaa kuten asiakkaasi etsisi
   • Kokeile hakua kolmella tärkeimmällä termillä (esim. “brändi malli koodi”). Fallback-haku huomioi vain kolme merkittävintä sanaa.

Mistä editoidaan

• Hallintapaneeli: muokkaa tuote- ja kategoriokenttiä (nimet, URL-osoitteet, kuvaukset, tagit, koodit/viivakoodit) kielikohtaisesti.
• Algolia: jos syötät Algolia-avaimet kauppaan, haku käyttää Algoliaa; ilman avaimia käytössä on automaattinen tietokantahaku.

Kenttien painotukset ja hakutavat

Näiden avulla ymmärrät, miksi tietyt osumat nousevat listalla korkeammalle. “Hakutapa” kertoo käytetyn haun logiikan: LIKE = osumahaku, FULLTEXT BOOLEAN = termipohjainen, FULLTEXT NATURAL LANGUAGE = luonnollisen kielen haku.

Tuoteosumat

Kategoriaosumat

Algolia vs. varahaku – miten järjestelmä päättää?

Algolia-käyttö (kun avaimet on määritetty)

• Haku tekee yhden multi-query -pyynnön: kohteina products ja categories.
• Hakua suodatetaan ehdolla “languageId = nykyinen kieli”, jotta tulokset vastaavat asiakkaan kieltä.
• Tuotteista haetaan enintään 10 osumaa ja kategorioista 10, joista käyttöliittymä yleensä näyttää 5 parhainta.
• Algolia palauttaa vain osuvien entiteettien ID:t; varsinainen näkyvä sisältö “hydratoidaan” paikallisesta tietokannasta.

Tietokantahaku (automaattinen fallback)

• Kun Algolia ei ole käytettävissä, haku suorittaa “quick-search” -prosessin SQL:llä.
• Hakusana siistitään ja normalisoidaan; mukaan otetaan enintään kolme merkittävintä termiä.
• Hakutyyppi asetetaan quick-searchiksi, ja ListingSearch rakentaa ehdot eri kentille painotuksineen (LIKE, FULLTEXT BOOLEAN, FULLTEXT NATURAL LANGUAGE).
• Tulokset pisteytetään ja rajataan 10 parhaaseen osumaan.

Parhaat käytännöt sisällölle

• Pidä nimet lyhyinä, informatiivisina ja kielikohtaisina. Aloita brändillä ja mallilla.
• Syötä kaikki koodit: SKU, variaation mallikoodit ja viivakoodit. Nämä tuottavat vahvoja osumia.
• Käytä tagit nostoihin ja synonyymeihin, erityisesti kampanjateemoihin ja sesonkisanoihin.
• Huolehdi kategoriatiedoista: selkeä Kategorian nimi ja siisti Kategorian URL parantavat kategoriahakua.
• Muista kieliversiot: täytä nimet, kuvaukset ja tagit jokaiselle kielelle, koska haku suodattaa kielen mukaan.

Yhteenveto

AI Commercen haku on rakennettu nostamaan selkeästi nimetyt tuotteet ja täsmälliset koodit (SKU, viivakoodit) listan kärkeen, ja täydentämään tätä kuvailevilla teksteillä ja tageilla. Varmista, että avainkentät ovat täytetty kielikohtaisesti ja testaa hakua tärkeimmillä asiakas­termeillä. Jos Algolia on käytössä, haku skaalautuu nopeasti; ilman Algoliaa sisäänrakennettu haku varmistaa silti hyvät tulokset, kun sisältö on kunnossa.

Avainsanat

• AI Commerce haku
• Algolia integraatio
• Tuotehaku painotus
• Kategoriahaku
• FULLTEXT BOOLEAN
• SKU ja viivakoodi
• Hakutermit optimointi
• Hallintapaneeli asetukset
• Tuotteen tagit
• Monikielinen verkkokauppa