# Hibaelhárítás

> Gyakori hibák és megoldásaik: nem működő pixelek, hiányzó konverziók, Meta és Google Ads figyelmeztetések, GA4 Unassigned forgalom, felületi hibák.

## Először: a konzol-naplózó

Fűzd az oldal URL-jéhez a `?pmwloggeron` paramétert, és nézd a böngésző konzolját (F12 → Console). Itt látod, mely események és pixelhívások futnak. Részletek: [Diagnosztika és tesztelés](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/diagnosztika-es-tesztelles/).

## A pixelek nem működnek

A két leggyakoribb ok:

- **Gyorsítótár:** a szerver még a régi oldalakat szolgálja ki. Töröld a gyorsítótárat (CDN, tárhely, bővítmény).
- **Minifikálás, összevonás:** egyes optimalizáló bővítmények annyira átalakítják a beszúrt JavaScriptet, hogy a pixelek leállnak. Kapcsold ki őket, és próbáld újra.

A pontos kizárásokat a [Kompatibilitás és gyorsítótár](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/kompatibilitas/) fejezetben találod. Ha csak egyes események hiányoznak, az ok általában speciálisabb (lásd lent a Metánál).

## Nincs konverzió, vagy kevesebb, mint a rendelés

- A Google Adsben kevesebb a konverzió, mint a boltban: a böngészős követés csak azokat méri, akik elérik a megerősítő oldalt, és a hirdetési platform csak a hirdetéshez köthető konverziót számolja. Nézd meg a **Diagnostics** fül fizetési mód pontossági jelentését.
- A megerősítő oldal újratöltésekor nem számolódik újra a rendelés: az **Order duplication prevention** megakadályozza.
- A megerősítő oldal üres vagy nagyon lassan töltődik be: gyakori ok egy inkompatibilis bővítmény, vagy lassú harmadik fél általi rendelésszinkronizáció.
- Egyéni köszönő oldal: a megfelelő WooCommerce hookokat kell használnia ([Kompatibilitás és gyorsítótár](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/kompatibilitas/)).

## Google Ads

- **Tag not placed correctly (a címke nincs jól elhelyezve):** a figyelmeztetést egy olyan robot váltja ki, amely nem lép interakcióba az oldallal, ezért a lusta betöltés mellett kaphatod. Ártalmatlan, a valódi látogatók konverziói mérődnek, mert a kosár- és pénztároldal mindig azonnal betölti a követést. Ha zavar, kapcsold ki a **General → Lazy-load the Pixel Manager** kapcsolót, vagy a figyelmeztetést okozó harmadik fél bővítményt.
- **A mért konverziós érték túl magas:** ellenőrizd a **Marketing value logic** beállítást ([Általános beállítások](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/altalanos/)).
- A Google Tag Assistant több gtag.js telepítést jelezhet: ha ugyanazt a Google címkét egy másik bővítmény vagy Tag Manager is betölti, csak egyet hagyj meg.

## Meta (Facebook)

- **Csak a `PageView` és a `ViewContent` érkezik meg, az `AddToCart`, `InitiateCheckout` és `Purchase` hiányzik:** a Meta a pixel üzleti kategóriája miatt csendben eldobja ezeket. A bővítmény felől nem javítható, a Meta Events Managerben kell rendezni.
- **Duplázott `Purchase`:** a Meta automatikus eseményészlelése is elküldheti a vásárlást. Kapcsold ki az Events Managerben. Ha a duplák ezután is megmaradnak, az az `fbevents.js` könyvtár ismert hibája lehet. Az Event Setup Tool szabályai is okozhatnak plusz eseményeket.
- **Az Events Manager több konverziót mutat, mint ahány rendelés van:** gyakran duplikáció vagy a Meta Conversions API Gateway miatt (kapcsold le).
- **A Meta kevesebb eseményt mutat, mint ahány látogatód van:** a lusta betöltés, a reklámblokkolók és a hozzájárulás megtagadása is okozhatja.
- **Szerveroldali vásárlás késik:** az első szerveroldali esemény legfeljebb egy másodpercet vár a `_fbp` sütire ([Követőpixelek](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/pixelek/)).
- **Az Events Managerben a böngészős és szerveroldali események száma eltér:** a szerveroldali csatorna a böngésző nélküli rendeléseket is tartalmazza (ERP, admin, előfizetés-megújítás), ezért több lehet. Ez nem hiba.

## GA4

- **Unassigned forgalom:** a Measurement Protocol azokat a rendeléseket is jelenti, amelyek látogatójának nem volt GA4 munkamenete, ezért a bevétel helyes, de csatorna nélkül jelenik meg. Egy része a hozzájárulási banner helyes működése, egy része olyan közeg, amelyre a GA4 csatornacsoportodnak nincs szabálya, ez nem követési veszteség.
- **(not set) kezdőlap:** a Measurement Protocolon küldött, késve fizetett rendelésekre jellemző.
- **A GA4 kevesebb rendelést mutat, mint a WooCommerce:** a Measurement Protocol korlátai miatt, és mert nem minden vásárló éri el a megerősítő oldalt.
- **Visszatérítés nem vonja le a bevételt:** a **Support → Logger** napló megmutatja, kimegy-e a visszatérítési kérés, és mekkora összeggel.

## Felületi és beállítási hibák

- **A beállítások nem mentődnek, az admin „API error 403” vagy „blocked before it reached WordPress” hibát mutat:** biztonsági tűzfal blokkolja a bővítmény REST-kéréseit. Engedélyezd a REST végpontokat a tűzfalban.
- **A front-end kérések HTTP 406-tal hibáznak, és a rendelések elveszítik a kattintásazonosítókat:** szintén tűzfal blokkolja a kéréseket.
- **A REST végpontok nem működnek:** ellenőrizd, hogy a WordPress REST API elérhető-e.
- **Egyéni, fizetettnek számító rendelésállapotot nem ismer fel a bővítmény:** a szerveroldali vásárlás csak a bővítmény által fizetettnek tekintett állapotoknál megy ki.
- **A kosárba tétel (vagy más űrlap) csendben hibázik, ha a hozzájárulás meg van tagadva:** ellenőrizd a hozzájárulási beállításokat ([Hozzájárulás és adatvédelem](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/hozzajarulas/)).
- **A `pmw_get_cart_items` hívás nem lassítja az oldalt:** a betöltési esemény után fut, a standard WordPress Ajax-szal tölti le a minikosár termékadatait, mert a gyorsítótárazott HTML-ben ez elavulhatna.

## Action Scheduler

A bővítmény a háttérfeladatokhoz az Action Schedulert használja. Ha a feladatok sorában sok a sikertelen, megszakított vagy befejezett bejegyzés, tisztítsd ki őket, zárolt adatbázis esetén pedig cseréld le a táblákat újakra. Ha a `as_has_scheduled_action()` függvény nincs definiálva, az Action Scheduler elavult vagy hiányos.

## Támogatás kérése

Hiba jelentéséhez vagy javaslathoz használd a **Support** fül gombjait. A kérésedhez csatold a **Generate debug report** gombbal készített jelentést és a letöltött naplót.