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

> Az állapotpanel, a kikapcsolás, a kézi és automatikus szinkronizálás, a hibakezelési mód, a kvóta és a gyakori hibák megoldá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](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/szerveroldal-beallitas/)).

### 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.