Server-Side Proxy kezelése és hibaelhárítása

Az aktiválás után a proxy állapotát, kapcsolatát és viselkedését a WooCommerce → Pixel Manager → Server-Side fül SweetCode Server-Side Proxy szakaszában kezeled. Ez Pro funkció.

Állapotpanel

Routing Status

A Routing Status azt mutatja, hogy a DNS jól van-e beállítva, és aktív-e a proxydomain.

Állapot	Jelentése
Active	A DNS ellenőrzött, a proxy irányítja a forgalmat.
Pending DNS	A domain fel van véve a portálon, de a CNAME még nincs ellenőrizve.
Disabled	A domaint letiltották a SweetCode Cloud portálon.
Deleted	A domaint törölték a SweetCode Cloud portálról.

Config Status

A Config Status azt mutatja, hogy a Pixel Manager céljainak hitelesítő adatai szinkronban vannak-e a SweetCode Clouddal.

Állapot	Jelentése
Synced	A hitelesítő adatok sikeresen átkerültek a SweetCode Cloudhoz.
Waiting for Config	A domain létezik a SweetCode Cloudban, de még nem érkezett meg a beállítás.
Sync Error	Az utolsó átküldés nem sikerült, a hibaüzenet megmondja az okát.

Általános állapot

A proxy akkor működik teljesen (Active), ha mind a négy feltétel teljesül:

1. A proxy be van kapcsolva a Pixel Managerben.
2. Van mentett szinkronizációs token.
3. A Routing Status Active.
4. A Config Status Synced.

Ha bármelyik feltétel hiányzik, az állapotjelvény Inactive, és az események nem a proxyn át mennek.

Csomag és használat

Az állapotpanel azt is megmutatja:

• a csomag nevét (Free, Pro, Business vagy Scale);
• az idei számlázási időszakban elküldött események számát a havi korláthoz képest;
• a felhasznált keret százalékát jelzősávval.

Kikapcsolás és újraaktiválás

A proxyt ideiglenesen kikapcsolhatod a kapcsolat elvesztése nélkül:

• Disable: a proxy nem irányítja tovább az eseményeket, de a kapcsolat adatai (szinkronizációs token, domainbeállítások) megmaradnak.
• Re-activate: a proxy a meglévő kapcsolattal újra irányítja az eseményeket, a tokent nem kell újra megadni.

Ez hibakereséshez, vagy az átmeneti közvetlen szerveroldali küldéshez hasznos.

Sync Now

A Sync Now gombbal kézzel elküldheted a SweetCode Cloudnak a céljaid aktuális beállítását. Ez a Meta, TikTok, Pinterest, Snapchat, Reddit, OpenAI, Nextdoor és a Google Analytics 4 Measurement Protocol összes beállított pixelazonosítóját és API-tokenjét átküldi, a pmw_facebook_pixel_identifiers szűrővel hozzáadott további Meta-pixeleket is.

Mikor használd:

• egy CAPI-token vagy pixelazonosító módosítása után (ez egyébként magától is szinkronizál);
• ha szűrős kódrészlettel adtál hozzá vagy módosítottál pixeleket, és nem akarod megvárni az automatikus észlelést;
• ha a Config Status Sync Error, és újra akarod próbálni;
• egy kapcsolati hiba elhárítása után.

Automatikus szinkronizálás

A Pixel Manager négy módon szinkronizálja a beállításokat a SweetCode Clouddal:

1. Hitelesítő adat módosításakor. Ha elmentesz egy CAPI-tokent, pixelazonosítót vagy más szinkronizált beállítást, aszinkron szinkronizálás indul.
2. Szűrővel adott beállítás változásakor. A szűrőből jövő célok (például a pmw_facebook_pixel_identifiers szűrővel hozzáadott Meta-pixelek) soha nem érik a beállításokat, így nincs mit menteni. A Pixel Manager ezért legfeljebb ötpercenként összeveti a tényleges célbeállítást az utoljára elküldöttel, és változás esetén szinkronizál. A kódrészlet módosítása után az új beállítás így néhány percen belül él.
3. Napi szinkronizálás. Naponta egyszer, a szerver helyi ideje szerint 3:15-kor ütemezett szinkronizálás fut.
4. A portál kérésére. A SweetCode Cloud portál újraszinkronizálást kérhet a Pixel Managertől, például csomagváltás után.

Test Connection

A Test Connection gombbal ellenőrizheted, hogy a WooCommerce szervered eléri-e a proxy végpontját a beállított aldomainen. Ez megerősíti, hogy a DNS, az SSL és a Cloudflare Worker is működik.

Hibakezelési mód (Proxy Failure Behavior)

Ez a beállítás azt szabályozza, mi történjen, ha a proxy nem érhető el: akár átmeneti kimaradás miatt, akár mert túlléptted a havi eseménykeretet.

Lehetőség	Működés
Fall back to PMW internal event router (alapérték)	A Pixel Manager közvetlenül a bolt szerveréről küldi az eseményeket a hirdetési platformoknak, pont úgy, mint a proxy bekapcsolása előtt. Nem vész el esemény. Cserébe a CAPI-terhelés visszakerül a szerverre, így a proxy tehermentesítő hatása addig kiesik, amíg a proxy újra el nem érhető (vagy a keret nem újul meg).
Drop server-side events	Az események csendben eldobódnak. Csak akkor használd, ha semmilyen körülmények között nem szeretnél közvetlen szerverhívást, például mert fontosabb a bolt szerverének tehermentesítése, mint hogy leállás alatt is minden szerveroldali konverzió megérkezzen.

A beállítás látogatói munkamenetenként értékelődik ki, így minden új látogatónál friss ellenőrzés fut, és a munkamenetek automatikusan visszaállnak a proxyra, amint újra elérhető.

Az alapértelmezett tartalék a legtöbb boltnak ajánlott: így sosem vész el konverziós adat, sem kimaradáskor, sem kvótatúllépés után.

Kvótafigyelmeztetések

A SweetCode Cloud csomagjainak havi eseményhatáruk van. A Pixel Manager figyeli a használatot, és a határ közeledtekor jelez:

• 80%-nál: a Pixel Manager irányítópultján egy lehetőségkártya javasolja a csomag bővítését.
• 100%-nál (túllépett kvóta): kiemelt értesítés jelenik meg. A proxy a következő számlázási ciklusig, vagy a csomagváltásig nem fogad új eseményt. A szerveroldali események alapból nem vesznek el, hanem közvetlen küldésre váltanak a bolt szerveréről (lásd a hibakezelési módot). Csak akkor dobódnak el, ha te választottad a Drop server-side events lehetőséget.

A használatot az állapotpanelen vagy a SweetCode Cloud portálon láthatod.

Leválasztás (Disconnect)

A leválasztás végleges és visszafordíthatatlan. A kapcsolat összes adata (szinkronizációs token, domainbeállítások, visszahívási tokenek) törlődik a Pixel Managerből. Az újrabekapcsoláshoz új szinkronizációs token kell a SweetCode Cloud portálról.

1. Kattints a Disconnect gombra a Server-Side Proxy szakaszban.
2. Erősítsd meg a műveletet a párbeszédablakban.

A leválasztás után a Pixel Manager minden szerveroldali eseményt újra közvetlenül a bolt szerveréről küld.

Hibaelhárítás

A Routing Status „Pending DNS”

• Ellenőrizd, hogy jól vetted-e fel a CNAME rekordot: ssp.aboltod.hu → ssp.sweetcode.cloud.
• Cloudflare esetén a rekord DNS only (szürke felhő) legyen. A Proxied (narancssárga felhő) rekord elrejti a CNAME-et a nyilvános DNS elől, így az ellenőrzés soha nem sikerülhet.
• A DNS-terjedés ritkán akár 24-48 óráig is tarthat. Próbáld újra a Verify DNS gombbal a SweetCode Cloud portálon.

Cloudflare 1014-es hiba (CNAME Cross-User Banned)

Az ssp.aboltod.hu megnyitásakor a Cloudflare 1014-es hibaoldalát látod, a SweetCode Cloud portál pedig a „No CNAME record found”, „Hostname deleted” és „SSL validation_timed_out” üzenetek valamelyikét jelzi, pedig a CNAME szerepel a Cloudflare-fiókodban.

Ok: az ssp rekord Proxied (narancssárga felhő). A Cloudflare ilyenkor a saját IP-címeivel válaszol, és nem teszi közzé a CNAME-et, ezért a portál nem látja a rekordot, és a tanúsítvány ellenőrzése sem működik.

Megoldás:

1. A Cloudflare-ben nyisd meg a DNS → Records oldalt, és szerkeszd az ssp rekordot.
2. A Proxy status értékét állítsd Proxied-ről DNS only-ra (szürke felhő).
3. A célt hagyd ssp.sweetcode.cloud-on, és mentsd.
4. A SweetCode Cloud portálon nyisd meg a domaint, és kattints a Check DNS Status gombra.

Ha a rekordot proxyzva akarod tartani, a portálon váltsd a domaint TXT tanúsítvány-ellenőrzésre (lásd a beállítási útmutatót).

A Config Status „Sync Error”

• Olvasd el az állapotpanelen a Last Sync Error üzenetet.
• Kattints a Sync Now gombra az újrapróbáláshoz.
• Győződj meg róla, hogy a szervered kimenő HTTPS-kéréseket küldhet az ssp.sweetcode.cloud felé.
• Nézd meg, hogy tűzfal vagy biztonsági bővítmény nem blokkolja-e a kimenő kéréseket.

Az események nem jelennek meg a portálon

• Ellenőrizd, hogy az általános állapot Active (mind a négy feltétel teljesül).
• Ürítsd ki a bolt összes gyorsítótárát.
• A böngésző fejlesztői eszközeinek Network lapján nézd meg, mennek-e kérések a proxy aldomainjére.
• Próbáld ki a Test Connection gombot.

Túllépett kvóta

Ha elérted a SweetCode Cloud havi eseményhatárát, a proxy 403 hibát ad, és újraszinkronizálási visszahívást indít a Pixel Manager felé. A Pixel Manager ekkor egy quota_exceeded jelzőt állít be a beállításaiban, és minden oldal JavaScript-adatrétegébe beleírja. Emiatt a frontend már nem a proxyn át küldi az eseményeket: a hibakezelési módtól függően közvetlenül a bolt szerveréről mennek, vagy eldobódnak.

Helyreállítás lépésről lépésre

A csomagváltás vagy a számlázási ciklus megújulása után a proxy használatát így állítsd vissza:

1. Indíts újraszinkronizálást. Valamelyik megoldás megfelel:
   • mentsd el a Pixel Manager beállításait (ez automatikusan szinkronizál);
   • kattints a Sync Now gombra a Server-Side Proxy szakaszban;
   • kattints a Resync gombra a domain részletes oldalán a SweetCode Cloud portálon;
   • vagy várd meg a napi automatikus szinkronizálást (a szerver ideje szerint 3:15).
2. Ürítsd ki az oldalgyorsítótárakat. Ezt a lépést felejtik el leggyakrabban. Ürítsd a gyorsítótár-bővítményt (WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache stb.), a tárhelyszolgáltató gyorsítótárát, a Cloudflare-t vagy más CDN-t, és a Varnish-t vagy bármilyen más fordított proxy gyorsítótárát.
3. Ellenőrizd. Nyiss egy új böngészőlapot (vagy inkognitóablakot), látogasd meg a boltot, és a Network lapon nézd meg, mennek-e kérések a proxy aldomainjére (például ssp.aboltod.hu).

Miért kritikus a gyorsítótár ürítése? A Pixel Manager a quota_exceeded jelzőt közvetlenül az oldalak HTML-jébe írja. Még ha az újraszinkronizálás a szerveren törli is a jelzőt, a gyorsítótárazott oldalak HTML-jében a régi érték marad, a látogatók a régi állapotot látják, és az események nem a proxyn át mennek. Emellett a Pixel Manager JavaScriptje a proxy állapotát lapfülenként a böngésző sessionStorage-ában is tárolja. Az a látogatói munkamenet, amelyik már látta a kvótatúllépést, a tartalék útvonalon marad, amíg új lapot nem nyit. Ez a munkamenetek cserélődésével magától megoldódik.