Mikä debug-näkymä on ja miksi se on olemassa?

Monimutkaisissa verkkokaupoissa sama tuote voi näyttää eri hinnan tai eri alennuksen riippuen esimerkiksi asiakkaasta, maasta, alennussäännöistä ja niiden järjestyksestä. Tämän takia pelkkä Hallintapaneelin näkymä ei aina riitä selvittämään, miksi tuotesivu käyttäytyy tietyllä tavalla.

AI Commerce -alustan tuotesivuille on siksi lisätty ylläpidolle tarkoitettu debug-näkymä, joka tuo esiin taustatietoa suoraan siinä käyttöliittymässä, missä ilmiö näkyy. Näkymän tarkoitus on nopeuttaa virhejäljitystä ja tehdä näkyväksi syitä, jotka muuten jäisivät “piiloon”.
 

Mitä hyötyä debug-näkymästä on?

Debug-näkymä auttaa ymmärtämään esimerkiksi:

• miksi tuotesivun hinta tai alennus näyttää erilaiselta kuin odotat
• miksi tuotesivun logiikka poikkeaa Hallintapaneelissa näkyvästä tiedosta
• mikä selittää päällekkäisiä alennuksia ja niiden yhteisvaikutusta
• onko hintahistoriassa kohtia, jotka voivat vaikuttaa EU:n 30 päivän alennusmyyntisäännön tulkintaan

Tämä on hyödyllistä sekä kauppiaalle että integraatiopartnereille (esim. tuotetiedon tai hinnoittelun parissa työskenteleville), koska ongelman syyt löytyvät nopeammin ilman arvailua.

Mitä tuotesivulle lisätty debug-näkymä näyttää?

Tuotesivulla näkyvä admin-debug-elementti näyttää muun muassa:

• tuotteen hintahistorian (milloin tuote on ollut milläkin hinnalla)
• alennuksen tyypin ja vaikutuksen
• jos tuotteella on useita päällekkäisiä alennuksia, näet kuinka suuri vaikutus on kunkin alennustyypin osalta

Tämä tekee päällekkäisistä alennuksista helpommin ymmärrettäviä ja auttaa tunnistamaan tilanteet, joissa hinnan käyttäytyminen ei ole odotettua.

Näkyvyys ja käyttöoikeudet

Debug-tieto ei näy tavallisille asiakkaille. Se näkyy vain, jos:

• käytössäsi on admin-tili, tai
• olet saanut pääsyn asiakastilille asiakastilin lukitusominaisuuden kautta administa (eli kirjautuminen on peräisin admin-hallintapaneelista)

Näin varmistetaan, että kyseinen taustatieto on vain ylläpidon ja selvitystyön käytössä.

Näin käytät debug-näkymää tuotesivulla

1. Varmista, että olet kirjautunut ylläpidon oikeuksilla
   • Debug-näkymä näkyy vain admin-tilillä tai asiakastilin lukituksen kautta avatussa asiakasistunnossa (kirjautuminen peräisin admin-hallintapaneelista).
2. Avaa ongelmallinen tuotesivu siinä käyttöliittymässä, missä ilmiö näkyy
   • Tarkastele sivua samassa kontekstissa, jossa ongelma ilmenee (esim. asiakkaan maa, asiakastyyppi, aktiiviset alennussäännöt ja niiden järjestys).
3. Etsi tuotesivulta admin-debug-elementti
   • Elementti on tarkoitettu näyttämään “selittävää dataa” suoraan tuotesivulla ylläpidolle.
4. Tarkista hintahistoria
   • Varmista, milloin tuote on ollut milläkin hinnalla.
   • Tunnista hintahistoriasta kohdat, jotka voivat vaikuttaa EU:n 30 päivän alennusmyyntisäännön tulkintaan.
5. Tarkista alennukset ja niiden vaikutus
   • Katso alennuksen tyyppi ja vaikutus.
   • Jos alennuksia on useita päällekkäin, tarkista debug-näkymästä kunkin alennustyypin vaikutus erikseen.
   • Tämän avulla näet, mikä selittää päällekkäiset alennukset ja niiden yhteisvaikutuksen.
6. Vertaa tuotesivun logiikkaa Hallintapaneelin tietoihin
   • Jos Hallintapaneelissa näkyvä tieto poikkeaa tuotesivun toteutuneesta hinnasta/alennuksesta, debug-näkymä auttaa paikallistamaan syyn (esim. asiakas, maa, sääntöjen järjestys, päällekkäiset alennukset).
7. Kirjaa löydökset jatkotoimia varten
   • Ota ylös hintahistorian havainnot (mitä hintoja ja milloin).
   • Kirjaa alennusten tyypit ja vaikutukset (erityisesti päällekkäiset alennukset).
   • Välitä kooste kauppiaan ja/tai integraatiopartnerin käyttöön, jotta korjaus voidaan tehdä ilman arvailua.

Laajennettavuus: sama ajatus muihinkin kohtiin

Debug-näkymä tuotesivulla on esimerkki siitä, miten ylläpidolle voidaan tuoda “selittävää dataa” myös muualle. Rajapinta välittää jo nyt käyttöliittymään enemmän tietoa kuin mitä normaalisti näytetään, ja partneri voi tarvittaessa tuoda tätä tietoa näkyviin vain admin-käyttäjille.

Samaa periaatetta voidaan hyödyntää esimerkiksi kassalla, jolloin voitaisiin selvittää:

• miksi jokin rahtitapa on piilotettu
• miksi jokin maksutapa ei näy
• mitkä säännöt vaikuttavat valintoihin ja missä järjestyksessä

Voiko debug-näkymää muokata?

Kyllä. Voit pyytää integraatiokumppaniasi:

• siirtämään debug-elementin toiseen paikkaan tuotesivulla
• laajentamaan sen sisältöä (näyttämään lisää taustatietoa)
• rakentamaan vastaavia debug-elementtejä muihin näkymiin (esim. kassa)

Mistä editoidaan?

• Tuotesivun debug-elementin sijainti ja näkyvä sisältö määritellään tuotesivun käyttöliittymässä (frontend-toteutus), ja muutokset tehdään tyypillisesti integraatiokumppanin toimesta.
• Rajapinta voi välittää käyttöliittymään enemmän tietoa kuin mitä normaalisti näytetään, ja tätä “ylimääräistä” dataa voidaan tuoda näkyviin vain admin-käyttäjille.

Yhteenveto ja suositeltu seuraava askel

Kun tuotesivun hinta tai alennus näyttää oudolta, tarkista asia ensisijaisesti tuotesivun debug-näkymästä: se näyttää hintahistorian sekä alennusten tyypit ja vaikutukset (myös päällekkäiset alennukset eriteltynä). Kirjaa havainnot ja hyödynnä niitä seuraavissa korjaustoimissa tai integraatiomuutoksissa.

Avainsanat

• debug-näkymä
• tuotesivu
• hintahistoria
• päällekkäiset alennukset
• alennussäännöt
• EU 30 päivän alennusmyyntisääntö
• Hallintapaneeli
• AI Commerce
• virhejäljitys
• kassan debug