Konzolnaplózó

A Pixel Manager konzolnaplózója valós idejű hibakereső eszköz. A böngésző fejlesztői konzoljában segít felderíteni a követési hibákat, ellenőrizni a pixelek adatait és figyelni a bolt konverziókövetésének állapotát.

Gyors bekapcsolás: fűzd a ?pmwloggeron paramétert bármelyik oldal URL-jéhez, és a konzolnaplózó a teljes böngészőmunkamenetre bekapcsol.

Mi a konzolnaplózó?

A konzolnaplózó teljes betekintést ad a Pixel Manager belső működésébe: részletes információt ír a böngésző fejlesztői konzoljába. Ezzel:

• Követési hibákat kereshetsz: pontosan látod, mikor sül el egy esemény, és milyen adatot hordoz.
• Ellenőrizheted a pixelek beállítását: megerősítheted, hogy a pixelek a helyes adatot kapják.
• Figyelheted a hozzájárulási állapotot: valós időben látod a hozzájárulás változásait.
• Teljesítményproblémákat deríthetsz fel: kiszúrhatod a lassú szkriptbetöltést vagy az API-hibákat.
• Tesztelheted a saját kódodat: validálhatod az eseményszűrőket és a testreszabásokat.

Hogyan működik?

A konzolnaplózó a Pixel Manager eseményfeldolgozó láncába kapcsolódik, és minden lépésnél diagnosztikai információt ír ki:

1. Eseményészlelés: naplózza, amikor követési esemény váltódik ki (kosárba tétel, vásárlás stb.).
2. Adatfeldolgozás: megmutatja az egyes pixelekhez előkészített eseményadatot.
3. Pixelvégrehajtás: kiírja az egyes hirdetési platformoknak ténylegesen elküldött adatot.
4. Rendszerfigyelés: követi a szkriptbetöltést, az API-hívásokat és a hozzájárulás változásait.

A naplózó bekapcsolása

Fűzd a ?pmwloggeron paramétert bármelyik oldal URL-jéhez:

https://sajatbolt.example/termek/pelda/?pmwloggeron

Ez a teljes böngészőmunkamenetre bekapcsolja a naplózást, amíg:

• bármelyik URL-hez hozzá nem fűzöd a ?pmwloggeroff paramétert, vagy
• ki nem törlöd a böngésző munkamenet-tárolóját (session storage).

Miért ez a módszer?

• Gyors és egyszerű a teszteléshez.
• Nem kell hozzá admin hozzáférés.
• Munkamenet-alapú, az oldalak között megmarad.
• Éles oldalon is biztonságos, mert csak a te böngésződet érinti.

A naplózó kikapcsolása

Fűzd a ?pmwloggeroff paramétert bármelyik URL-hez:

https://sajatbolt.example/?pmwloggeroff

Mit naplóz?

1. A bővítmény verziója és állapota

Az oldal betöltésekor a Pixel Manager verziója és konfigurációja jelenik meg:

Pixel Manager for WooCommerce: pro | distro: fms | active license: yes | version: 1.42.10

A sor részei:

• pro vagy free: a licencszint
• distro: fms: a terjesztési csatorna (Freemius vagy a WooCommerce Marketplace)
• active license: a licenc érvényessége (csak Pro)
• version: a bővítmény verziója

A verzióinformációs sor elnyomása

Minden más, itt leírt kimenettől eltérően a verzióinformációs sor minden oldalbetöltéskor kiíródik, akkor is, ha a konzolnaplózó ki van kapcsolva. Ez az egyetlen kimenet, amelyet a ?pmwloggeron nélkül is látsz.

Elrejtéséhez, kikapcsolásához tedd a gyermektéma functions.php fájljába:

add_filter('pmw_show_version_info', '__return_false');

A szűrő nem törli a sort, hanem a konzolnaplózóba sorolja át. Kikapcsolt naplózóval (ez az alapérték) semmi nem íródik ki. Ha hibakereséshez a ?pmwloggeron paraméterrel bekapcsolod a naplózót, a verzióinformáció újra megjelenik, ami általában kívánatos, mert hibaelhárításkor ez az első, amit ellenőrizni kell.

2. Követési események

Minden felhasználói interakció, amely követési eseményt vált ki, a teljes adatával naplózódik.

Példa: kosárba tétel esemény

Pixel Manager: pmw:add-to-cart event fired {
    event: Event {…},
    product: {
        id: 123,
        name: "Blue T-Shirt",
        price: 29.99,
        quantity: 1,
        category: "Clothing/Men"
    }
}

A naplózott események: pmw:page-view, pmw:view-item, pmw:view-category, pmw:search, pmw:add-to-cart, pmw:remove-from-cart, pmw:select-item, pmw:add-to-wishlist, pmw:begin-checkout, pmw:add-payment-info, pmw:place-order, pmw:purchase, pmw:login, pmw:account-created.

3. Pixelspecifikus követési hívások

Pontosan látod, milyen adatot kap az egyes hirdetési platform.

Példa: Facebook-pixel AddToCart esemény

Pixel Manager: Facebook Pixel: AddToCart event sent {
    event_name: "AddToCart",
    event_id: "pmw_1234567890_abcd",
    event_source_url: "https://sajatbolt.example/termek/pelda/",
    user_data: {
        em: "7d8c3e9a...",  // hash-elt e-mail
        ph: "4f9b2c1d...",  // hash-elt telefonszám
        client_user_agent: "Mozilla/5.0...",
        fbc: "fb.1.1234567890123.AbCdEf...",
        fbp: "fb.1.1234567890123.1234567890"
    },
    custom_data: {
        content_ids: ["123"],
        content_name: "Blue T-Shirt",
        content_type: "product",
        value: 29.99,
        currency: "HUF"
    }
}

4. A szkriptek betöltésének állapota

Figyelheted a pixelkönyvtárak betöltésének sikerét és hibáit.

Siker:

Pixel Manager: Successfully loaded primary script: https://connect.facebook.net/en_US/fbevents.js

Tartalék:

Pixel Manager: Loading fallback script: https://cdn.example.com/fbevents.js
Pixel Manager: Successfully loaded fallback script

Hiba:

Pixel Manager: Both primary and fallback scripts failed to load.

Gyakori okok:

• hirdetésblokkolók akadályozzák a szkriptbetöltést
• a CORS-szabályok blokkolják a külső erőforrásokat
• hálózati kapcsolati problémák
• hibás pixelbeállítás

Meta-pixel figyelmeztetések

A naplózó két olyan helyzetet is jelez, amely miatt a Meta-pixel a Pixel Managertől független okból nem működik:

Pixel Manager: Facebook Pixel: another script has already defined window.fbq before the Pixel Manager loaded it.

Egy másik bővítmény vagy kódrészlet előbb létrehozott egy window.fbq csonkot, ezért a Meta szabványos indítása kihagyja az fbevents.js betöltését. Távolítsd el vagy javítsd az ütköző szkriptet.

Pixel Manager: Facebook Pixel 1234567890: Meta restricts the following events for this pixel because of its business category (e.g. health and wellness): AddPaymentInfo, AddToCart, InitiateCheckout, Purchase.

A Meta blokkolja ezeket az eseményeket a pixeledhez, az fbevents.js pedig csendben eldobja őket. Ezt a Meta kényszeríti ki, a weboldalon nem javítható. Részletek: Hibaelhárítás.

5. IP-cím felismerése és földrajzi hely

Bekapcsolt szerver-szerver követésnél a naplózó az IP-cím felismerését is mutatja:

Pixel Manager: Testing the IP address of the browser because one or more server-to-server APIs are enabled and require the browser IP.
Pixel Manager: Fetching IP from cloudflare using IP version v4
Pixel Manager: Retrieved the IP address 123.45.67.89 from cloudflare which took 234 ms
Pixel Manager: Retrieved the browser geo location from the cache: {
    country: "HU",
    region: "BU",
    city: "Budapest"
}

IP-felismerő szolgáltatások: Cloudflare (elsődleges), ipify.org (tartalék), helyi időzóna-becslés (tartalék).

6. Hozzájárulás-kezelés

Figyelheted a hozzájárulás állapotát és frissítéseit.

Facebook Consent Mode:

Pixel Manager: Facebook Consent Mode updated: {
    ad_user_data: "granted",
    ad_personalization: "granted"
}

Google Consent Mode:

Pixel Manager: Google Consent Mode updated: {
    ad_personalization: "granted",
    ad_storage: "granted",
    ad_user_data: "granted",
    analytics_storage: "granted",
    functionality_storage: "granted",
    personalization_storage: "granted",
    security_storage: "granted",
    wait_for_update: 500
}

A hozzájárulás-kezelő platform (CMP) felismerése: az első sor megnevezi a felismert CMP-t. A hozzájárulás-kezelés platformonkénti útmutatói felsorolják a pontos sorokat, amelyeket a Cookiebot, a Cookie Script, a OneTrust, az iubenda, a Complianz és a CookieYes esetén várhatsz.

Pixel Manager: Cookiebot CMP consent detected
Pixel Manager: Consent state: {
    marketing: true,
    statistics: true,
    preferences: true
}

7. A REST-végpont elérhetősége

A WordPress REST API elérhetőségét is ellenőrzi:

Pixel Manager: REST endpoint is not available. Using admin-ajax.php instead.

Ez a figyelmeztetés a következőket jelentheti:

• egy biztonsági bővítmény blokkolja a REST API-t
• a szerverbeállítás korlátozza a végpontokat
• automatikus visszaesés az admin-ajax.php használatára (lassabb, de működőképes)

Gyakori felhasználási esetek

Hiányzó események felderítése

Probléma: a kosárba tétel események nem jelennek meg a Facebookban.

Megoldás:

1. Kapcsold be a konzolnaplózót a ?pmwloggeron paraméterrel.
2. Kattints a kosárba tétel gombra.
3. Nézd meg a konzolban az eseménynaplót:

Pixel Manager: pmw:add-to-cart event fired {product: {...}}

Értékelés:

• Az esemény naplózva van, de nincs Facebook-kimenet: ellenőrizd a Facebook-pixel beállítását vagy a hozzájárulást.
• Nincs naplózott esemény: JavaScript-hiba vagy témakompatibilitási probléma.
• Az esemény naplózva van, és van Facebook-kimenet is: nézd meg az adatot a Facebook Events Managerben.

Ha az eseményt naplózza és átadja a Metának, de az soha nem jelenik meg az Events Managerben, és a böngésző Hálózat paneljén sincs hozzá facebook.com/tr kérés, keress a konzolban üzleti kategória-korlátozásra vonatkozó figyelmeztetést. A Meta a korlátozott kategóriájú pixeleknél (jellemzően egészség és wellness) blokkolja az olyan konverziós eseményeket, mint az AddToCart és a Purchase, és hiba nélkül, a saját könyvtárában eldobja őket.

A pixeladatok pontosságának ellenőrzése

Probléma: rossz termékár megy a Google Adsnek.

Megoldás:

1. Kapcsold be a konzolnaplózót.
2. Nézd meg a termékoldalt, vagy tegyél kosárba.
3. Hasonlítsd össze az eseményadatot a pixelkimenettel:

Pixel Manager: pmw:add-to-cart event fired {
    product: { price: 29.99 }  // a termék ára
}
Pixel Manager: Google Ads: add_to_cart event sent {
    value: 34.99  // a Google Adsnek küldött érték
}

Értékelés:

• Ha az árak eltérnek, nézd meg, nincs-e egyedi szűrőd, amely módosítja az árat.
• A Pixel Managerben nyisd meg a General → Order configuration részt, és nézd át a Marketing value logic beállítást.

Eseményszűrők tesztelése

Probléma: az egyedi eseményszűrőm nem működik.

Megoldás: nézd meg a konzolban a szűrés előtti és utáni adatot:

Pixel Manager: pmw:purchase event fired {
    order_total: 100.00  // az eredeti érték
}
Pixel Manager: Facebook Pixel: Purchase event sent {
    value: 90.00  // a szűrő után
}

Ha az értékek megegyeznek, pedig nem kellene, a szűrőd valószínűleg nem működik.

Hozzájárulási problémák felderítése

Probléma: a pixelek nem sülnek el a sütik elfogadása után.

Megoldás:

1. Utasítsd el az összes sütit.
2. Kapcsold be a konzolnaplózót.
3. Fogadd el a marketing sütiket.
4. Keresd a hozzájárulás-frissítési naplókat:

Pixel Manager: Google Consent Mode updated: {
    ad_storage: "granted",
    analytics_storage: "granted"
}

Ha a hozzájárulás az elfogadás után is „denied”:

• a sütihozzájárulás-kezelő bővítmény rosszul van beállítva
• JavaScript-ütközés van a CMP és a Pixel Manager között
• a sütibanner nincs megfelelően integrálva

A naplózó hibaelhárítása

A naplózó semmit nem ír ki

1. Ellenőrizd az URL-paramétert. Győződj meg róla, hogy a ?pmwloggeron szerepel az URL-ben, és az oldal újratöltődött.
2. Kemény frissítés. A ?pmwloggeron hozzáadása után: Windows/Linux: Ctrl + Shift + R, Mac: Cmd + Shift + R.
3. Konzolszűrők. Ellenőrizd, hogy a konzol nincs szűrve: töröld a szűrőmező szövegét, és kapcsold be az összes naplószintet (Info, Warnings, Errors).
4. JavaScript-hibák. Keress olyan hibát, amely a Pixel Manager betöltése előtt keletkezik: javítsd ki az akadályozó hibákat, és ellenőrizd a téma- és bővítményütközéseket.

Nincsenek pixelspecifikus naplók

Lehetséges okok:

1. A pixel nincs bekapcsolva. A Pixel Managerben nyisd meg a Tracking Pixels fület, bontsd ki az érintett platform kártyáját, és ellenőrizd, hogy a pixel be van-e kapcsolva, helyes azonosítókkal.
2. Nincs hozzájárulás. Nézd meg a hozzájárulási naplókat a konzolban, ellenőrizd a sütibanner beállítását, és próbáld ideiglenesen kikapcsolt hozzájárulási móddal.
3. Az esemény nem sül el. Keresd a pmw:event-name naplókat. Ha nincs eseménynapló, maga az esemény nem váltódik ki: ellenőrizd a WooCommerce-kompatibilitást.
4. JavaScript-ütközés. Ideiglenesen kapcsold ki a többi bővítményt, váltsd át az alapértelmezett WooCommerce-témára, és nézd meg a böngészőkonzol hibáit.

Túl sok a konzolkimenet

• Használj konzolszűrőket. Egy adott pixelre: Pixel Manager:.*Facebook. Egy eseménytípusra: Pixel Manager:.*purchase.
• Töröld rendszeresen a konzolt. A console.clear() paranccsal, vagy billentyűparanccsal: Windows/Linux: Ctrl + L, Mac: Cmd + K.
• Csak az éppen tesztelt oldalakon kapcsold be. Add hozzá a ?pmwloggeron paramétert a tesztoldalon, végezd el a tesztet, és ha kész, használd a ?pmwloggeroff paramétert.

Teljesítmény

• URL-paraméterrel bekapcsolva (munkamenet-alapú) a hatása minimális.
• Csak azokat a böngészőket érinti, amelyeken a naplózó be van kapcsolva.
• Nincs szerveroldali teljesítményhatása.
• A tényleges követés pontosságát nem befolyásolja.
• Éles oldalon biztonságos módja a ?pmwloggeron URL-paraméter. Csak hibakeresés közben kapcsold be, és utána kapcsold ki.

Gyakori kérdések

Lassítja a konzolnaplózó az oldalamat? Nem jelentősen, ha URL-paraméterrel kapcsolod be. Csak a böngészőkonzolba ír, és nem befolyásolja az oldal betöltési sebességét vagy a követés pontosságát.

Láthatják a vásárlók a hibakeresési naplókat? Nem. A konzolnaplók csak a böngésző fejlesztői eszközeiben látszanak, amelyeket a tipikus vásárlók nem nyitnak meg. Éles oldalon azért ne kapcsold be globálisan, hogy elkerüld az adatok véletlen kitettségét.

Követ több adatot a naplózó bekapcsolása? Nem. A naplózó csak azt jeleníti meg, amit a Pixel Manager már feldolgoz. Nem hoz létre, nem módosít és nem küld további követési adatot.

Szűrhetem, mi naplózódik? A konzolnaplózó mindent kiír (mindent vagy semmit). A böngésző konzolszűrő funkciójával a kívánt eseményekre vagy pixelekre szűkíthetsz.

Hogyan tüntessem el a „Pixel Manager for WooCommerce: pro | distro: fms | …” sort a konzolból? Az a sor minden oldalbetöltéskor kiíródik, akkor is, ha a konzolnaplózó ki van kapcsolva. Add hozzá a gyermektéma functions.php fájljához: add_filter('pmw_show_version_info', '__return_false');.

Láthatják a látogatók a licencem állapotát a konzolban? Igen. A verzióinformációs sor tartalmazza a licencszintet és Pro esetén azt, hogy a licenc aktív-e, és bárki látja, aki megnyitja a böngésző fejlesztői eszközeit. Nem tartalmaz hitelesítő adatot, kulcsot vagy vásárlói adatot, de ha nem akarod hirdetni, nyomd el a pmw_show_version_info szűrővel.

Meddig marad aktív a ?pmwloggeron? A teljes böngészőmunkamenetre aktív marad, amíg a ?pmwloggeroff paramétert egy URL-hez nem fűzöd, kézzel nem törlöd a munkamenet-tárolót, vagy be nem zárod a böngészőt (a munkamenet véget ér).

Használhatom inkognitó módban? Igen. Fűzd a ?pmwloggeron paramétert az inkognitóablak URL-jéhez. Tesztelésre ez egyenesen ajánlott, mert elkerülhető vele a gyorsítótárazott adat.

Működik AJAX-os kosárba tétellel? Igen. A konzolnaplózó minden eseményt követ, akár oldalbetöltés, akár AJAX-kérés váltja ki.

Láthatok korábbi naplókat? Nem. A konzolnaplók az oldal frissítésekor törlődnek. Megőrzésükhöz kapcsold be a Chrome DevTools „Preserve log” beállítását, vagy mentsd el a konzolkimenetet a frissítés előtt.

Összefoglalás

A konzolnaplózó fontos eszköz:

• hibakereséshez: gyorsan kiderítheted, miért nem sülnek el az események vagy miért nem töltődnek be a pixelek,
• ellenőrzéshez: megerősítheted, hogy a hirdetési platformok a helyes adatot kapják,
• figyeléshez: valós időben követheted a hozzájárulás változásait és a rendszerállapotot,
• teszteléshez: validálhatod az egyedi szűrőket és a beállítási változtatásokat.

Gyors indulás:

1. Fűzd a ?pmwloggeron paramétert bármelyik URL-hez.
2. Nyisd meg a böngésző fejlesztői eszközeit (F12).
3. Válts a Console fülre.
4. Végezz műveletet (kosárba tétel, pénztár stb.).
5. Nézd át a konzolkimenetet a követési adatokért.
6. Ha végeztél, fűzd az URL-hez a ?pmwloggeroff paramétert.

Kapcsolódó fejezetek: PHP-szűrők, Diagnosztika és tesztelés, Hibaelhárítás, Hozzájárulás-kezelés.