# Hibaelhárítási ellenőrzőlista

> Rendszerállapot-ellenőrzések, az első generálás működése, naplózás, az Együtt vásárolták és a Mások ezt is megvették erősítők finomhangolása.

## Rendszerállapot-ellenőrzések

A bővítmény saját ellenőrzéseket ad a rendszerállapot-jelentéshez. A **WooCommerce → Állapot** oldalon, a **Termékajánlások** szakaszban mindegynek sikeresnek kell lennie.

![A Rendszerállapot Termékajánlások szakasza: adatbázis-verzió, visszacsatolási teszt, sorba állítás tesztje, oldalgyorsítótár teszt](./kepek/hibaelharitas-rendszerallapot.webp)

*A Rendszerállapot Termékajánlások szakasza: adatbázis-verzió, visszacsatolási teszt, sorba állítás tesztje, oldalgyorsítótár teszt* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-status)

A képen a **Visszacsatolási teszt** hibát jelez: ezt a tárhelynek kell javítania.

- **Visszacsatolási teszt sikertelen.** Fordulj a tárhelyszolgáltatódhoz.
- **Feladatok sorba állításának tesztje sikertelen.** A cron vagy az Action Scheduler hibájára utal. A részleteket az **Eszközök → Webhely állapota** oldalon találod. A bővítmény műveleteit a `prl` előtagról ismered fel.
- **Oldalgyorsítótár használata.** Ha használsz gyorsítótárat, a helyes eredményhez be kell kapcsolnod az **AJAX használata** opciót a **WooCommerce → Beállítások → Ajánlások** oldalon.

## Az első megjelenés: „Ajánlások generálása…”

Amikor egy ajánlómotort először nézel meg a frontenden, még nincs eredmény, és az adminisztrátorok egy „Ajánlások generálása folyamatban” jellegű üzenetet látnak. Ez a WordPress minden ütemezési rendszerére (például a cronra) és a bővítmény generálási logikájára jellemző.

A kiszolgáló védelme érdekében a bővítmény nem fut le költséges adatbázis-műveleteket minden oldalmegtekintéskor. Az eredményt az első betöltéskor állítja elő, majd naponta frissíti. Pontosabban: a 24 óránként első látogató indítja el az ajánlások (újra)generálását, amely sorba kerül a kiszolgálón. Az elkészülés általában pár másodperc, de ha a sor tele van, kis eséllyel a kérés elveszik.

Ha egy oldalt egy hétig senki sem néz meg, az ott lévő ajánlások az első megtekintésig nem frissülnek. Az algoritmus egyetlen hátulütője, hogy az új termékek kis késéssel jelennek meg az ajánlásokban.

Erről a motor telepítése után megjelenő értesítés is tájékoztat: az újonnan telepített ajánlások az első kérés után röviddel elkészülnek, és a beállított időközönként frissülnek.

## Ha az ajánlás mégsem jelenik meg

1. Ellenőrizd, használsz-e oldalgyorsítótárat, és ha igen, be van-e kapcsolva az **AJAX használata**.
2. Győződj meg róla, hogy fut valamilyen cron-feladat.
3. Nézd meg a **WooCommerce → Állapot → Ajánlások várólistája** oldalon, vannak-e függő feladatok.
4. A **WooCommerce → Állapot → Ütemezett műveletek** oldalon keresd a függő `prl` műveleteket, és azt, hogy nem tölti-e meg a sort egy másik bővítmény.
5. Az **Eszközök → Webhely állapota** oldalon keress teljesítmény- vagy cron-hibákat.
6. Ha mindez rendben van, végezz teljes ütközésvizsgálatot: kapcsold ki a többi bővítményt, és válts alapértelmezett témára.

### Témaütközés

A témaütközés tipikus jele, hogy a motor a telepített helyen nem látszik. A bővítmény alapértelmezett helyei megkövetelik, hogy a téma sablonjai tartalmazzák az alapértelmezett WooCommerce-horgokat, ahogy a WooCommerce kódolási szabályai előírják. Előfordul, hogy egy horog teljesen hiányzik a témából, váratlan helyen van, vagy ritkán kétszer is szerepel. Ilyenkor fordulj a téma szerzőjéhez, vagy használd az ingyenes egyedi helyek kiegészítőt, amellyel shortcode-dal telepíthetsz motorokat.

### A szűrők és erősítők együtt nem adnak eredményt

Ha a szűrők és az erősítők kombinációja a boltodban nem ad találatot, távolíts el néhány erősítőt, vagy válassz jobban illő stratégiát. Általában olyan erősítőket érdemes választani, amelyek illenek a termékeid típusához és a rendelések számához.

Ha pontosan látni akarod, miért kevés a találat, kapcsold be a naplózást:

1. Nyisd meg a **WooCommerce → Beállítások → Ajánlások** oldalt.
2. Fűzd hozzá a böngésző címsorában az oldal címéhez: `&prl_debug=yes`.
3. A **Haladó** szakaszban jelöld be a **Naplózás** mellett a **Bekapcsolás** jelölőnégyzetet.
4. Mentsd a beállítást.

![Az Ajánlások beállítások oldal a Naplózás opcióval és az erősítők finomhangoló beállításaival](./kepek/hibaelharitas-beallitasok-naplozas.webp)

*Az Ajánlások beállítások oldal a Naplózás opcióval és az erősítők finomhangoló beállításaival* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-settings&tab=prl_settings&prl_debug=yes)

A képen a **Haladó** szakasz **Naplózás** opciója és alatta az **Erősítő finomhangolása** szakaszok látszanak. Ezek csak a `prl_debug=yes` paraméterrel jelennek meg.

Ezután a **WooCommerce → Ajánlások → Elhelyezések** oldalon generáltasd újra a motort, majd a naplókat a **WooCommerce → Állapot → Naplók** alatt találod. Keresd a `wc_prl_generator_tasks` naplót. Benne van a teljesítménymérés, a haladás és a hibák, vagyis minden, ami az ajánlások generálása közben történik.

## Az Együtt vásárolták és a Mások ezt is megvették erősítők finomhangolása

Az **Együtt vásárolták** (FBT) és a **Mások ezt is megvették** (OAB) erősítők statisztikai algoritmusok. Mindkettő:

1. kiértékeli a „relevanciát” egy termék (például egy ceruza) és a bolt összes többi terméke között,
2. a legrelevánsabb jelölteket ajánlja.

Az **Együtt vásárolták** erősítőnél a relevancia azt jelenti, hogy a legjobb jelöltek nagyobb eséllyel kerülnek ugyanabba a rendelésbe, mint a vizsgált termék. Például az a rendelés, amelyben egy adott ceruza van, nagy eséllyel radírt is tartalmaz, ezért a radír jó ajánlás a ceruzát nézőknek.

A **Mások ezt is megvették** erősítőnél a relevancia azt jelenti, hogy a jelöltet nagyobb eséllyel veszi meg valaki, ha a vizsgált terméket valamikor megvette (nem feltétlenül ugyanabban a rendelésben). Aki például telefont vett, nagy eséllyel vesz laptopot is, ezért a telefont nézőknek jó ajánlás lehet az azonos márkájú laptop.

Az algoritmusok paramétereit a **WooCommerce → Beállítások → Ajánlások** oldalon módosíthatod, ha az oldal címéhez hozzáfűzöd a `&prl_debug=yes` paramétert. Az **Együtt vásárolták** paraméterei a **Mások ezt is megvették** erősítőre is vonatkoznak.

**Fontos:** az alapértékek átírása kevésbé jelentős ajánlásokhoz vezethet. Ha például egy telefonból 500 rendelés van, és ezek közül 10 tartalmaz ceruzát is, az nem jelenti azt, hogy a telefont nézőknek ceruzát kell ajánlani: a kapcsolat nem elég erős.

### Hogyan működik az Együtt vásárolták erősítő

Az erősítő azokat a termékeket ajánlja, amelyeket gyakran vettek együtt, a következők alapján:

1. a bolt összes rendelésének száma,
2. a megtekintett termék rendeléseinek száma,
3. azoknak a rendeléseknek a száma, amelyekben a megtekintett terméket egy másik termékkel együtt vették,
4. az összes olyan rendelés száma, amely a másik terméket tartalmazta (ebből derül ki, hogy a két termék együttvásárlása valódi kapcsolat, és a másik termék nem egyszerűen szinte minden rendelésben szerepel).

Hogy az eredmény értelmes legyen, minden ajánlott terméknek szerepelnie kell a megtekintett terméket tartalmazó rendelések legalább 10%-ában. Ez nehéz lehet, ha a termék sok rendelésben szerepel: ha 500-szor rendelték, egy másik termékkel legalább 50 rendelésben kell együtt szerepelnie ahhoz, hogy ajánlott legyen.
