# Server-Side Proxy: gyakori kérdések

> Válaszok a proxyval kapcsolatos gyakori kérdésekre: proxyzott események, GA4, kimaradás, adatbiztonság, kvóta, saját aldomain, több domain, Cloudflare.

Gyakori kérdések a SweetCode Server-Side Proxyról (Pro funkció).

## Mely események mennek át a proxyn?

Az összes böngészőből induló szerveroldali esemény, például:

- PageView
- ViewContent (termékoldal-megtekintés)
- AddToCart
- InitiateCheckout
- Search
- Subscribe
- a többi, nem vásárlási webshopesemény

A vásárlási események is a proxyn mennek. Ha a proxy nem érhető el, a vásárlási események platformonként automatikusan közvetlen küldésre váltanak a bolt szerveréről, így a bevételi adat nem vész el.

## Miért nincs proxyzva a GA4?

A GA4 Measurement Protocolja szerveroldalon csak vásárlási eseményeket küld. A böngészőből induló eseményeket a GA4 kizárólag a `gtag.js`-sel küldi, nincs szerveroldali API-útvonala, így nincs mit proxyzni. A GA4 vásárlási eseményeit a Pixel Manager továbbra is közvetlenül kezeli.

## Mi történik, ha leáll a proxy?

A [Proxy Failure Behavior](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/szerveroldal-kezeles/) beállítástól függ:

- **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. Nem vész el adat, csak átmenetileg elmarad a teljesítménynyereség.
- **Drop server-side events:** az események csendben eldobódnak, amíg a proxy helyre nem áll.

A legtöbb boltnak az alapértelmezett tartalék ajánlott.

## Biztonságban vannak az adataim?

Igen. A hirdetési platformok hitelesítő adatai (CAPI-tokenek, pixelazonosítók):

- HTTPS-en (TLS 1.3) utaznak;
- a SweetCode Cloudban AES-GCM titkosítással tárolódnak;
- soha nincsenek naplózva vagy egyszerű szövegként kitéve;
- a SweetCode Cloud portál felületén maszkolva jelennek meg (csak az utolsó 4 karakter látszik).

## Hogyan frissítem a CAPI-tokeneimet?

Úgy, ahogy eddig: módosítsd őket a Pixel Manager beállításaiban. A proxy észleli a változást, és automatikusan átküldi az új beállítást a SweetCode Cloudnak. Kézi szinkronizálásra nincs szükség, de a **Sync Now** gombbal azonnali frissítést is kérhetsz.

## Kell valamit módosítanom a hirdetési platformok felületén?

Nem. A proxy a hirdetési platformok számára átlátszó: az események ugyanabban a formátumban érkeznek az API-jaikhoz, mintha közvetlenül a bolt szerveréről mentek volna. A meglévő pixelbeállítások, közönségek és kampányok változtatás nélkül működnek tovább.

## Használhatom a proxyt csak néhány platformmal?

A proxy minden olyan cél eseményeit proxyzza, amelyhez a Pixel Managerben van CAPI-token és pixelazonosító. Ha csak a Meta CAPI van beállítva, csak a Meta eseményei mennek a proxyn át. Platformonkénti kapcsoló nincs: a proxy azt kezeli, ami aktív.

## Hat a proxy a böngészős pixelekre?

Nem. A böngészős (JavaScript) pixelek tőle függetlenül működnek. A proxy csak a követés szerveroldali részét (Conversions API-k) kezeli. A böngészős és a szerveroldali események továbbra is megfelelő deduplikációs eseményazonosítóval mennek ki.

## Mi a kvóta az ingyenes csomagban?

A SweetCode Cloud ingyenes csomagjában korlátozott a havi események száma. A pontos határt a SweetCode Cloud csomagjainak oldalán látod.

A havi korlát kizárólag a SweetCode Server-Side Proxyn át küldött eseményekre vonatkozik, nem a követésre általában. A korlát túllépése után a szerveroldali események sorsa a hibakezelési módtól függ (lásd a következő kérdést).

## Mi történik, ha túllépem a havi eseményhatárt?

A túllépés csak a proxyréteget érinti, minden más a megszokott módon követ tovább:

- A böngészős pixelkövetés zavartalanul működik.
- A közvetlen szerveroldali (CAPI) küldések folytatódnak.
- A proxy a számlázási ciklus megújulásáig vagy a csomagváltásig nem fogad új eseményt.

Ilyenkor a Pixel Manager a hibakezelési módot alkalmazza:

- **Fall back to PMW internal event router** (alapérték): a szerveroldali események közvetlenül a bolt szerveréről mennek a hirdetési platformoknak, ahogy a proxy bekapcsolása előtt. Nem vész el esemény, de a CAPI-terhelés visszakerül a szerverre, amíg a keret meg nem újul vagy csomagot nem váltasz.
- **Drop server-side events:** a szerveroldali események csendben eldobódnak, amíg a proxy helyre nem áll. Csak akkor válaszd, ha semmilyen közvetlen szerveroldali hívást nem szeretnél.

Alapértelmezés szerint a túllépés nem dobja el az eseményeket, csak ha kifejezetten a **Drop server-side events** lehetőséget választottad. 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, amint a proxy újra elérhető.

## Hol találom a SweetCode Cloud előfizetés számláit?

A SweetCode Cloud portálon, a **Billing → Payments** menüben. Minden fizetéshez tartozik egy **Invoice** hivatkozás. A proxy előfizetése a bővítmény licencétől külön számlázódik, ezért a proxy számlái nem a bővítmény vásárlói fiókjában vannak.

## Használhatok egyedi aldomaint?

Igen. Az alapértelmezett aldomain-előtag az `ssp` (`ssp.aboltod.hu`), de a domain portálon való felvételekor átírhatod, például `adat.aboltod.hu` vagy `kovetes.aboltod.hu` lehet.

## Használhatom a proxyt egy WordPress-telepítésen több domainnel?

Igen. Ha egyetlen WordPress-telepítésed több domaint szolgál ki (WordPress Multisite nélkül), minden domainhez külön SSP proxyvégpontot köthetsz. Ehhez:

1. a SweetCode Cloud portálon hozz létre külön domaint minden további domainhez;
2. add hozzá a `pmw_ssp_additional_domains` szűrőt a gyermektémád `functions.php` fájljához.

A Pixel Manager ezután minden domainen a megfelelő proxy URL-t írja ki a látogatóknak, és az összes domaint szinkronban tartja a CAPI-beállításaiddal.

## Frissítettem a csomagomat, de az események még mindig nem mennek a proxyn. Miért?

A csomagváltás vagy a számlázási ciklus megújulása után a Pixel Managernek meg kell tudnia, hogy a kvóta már nincs túllépve. Ez szinkronizálással történik: automatikusan (naponta 3:15-kor, vagy a SweetCode Cloud kérésére), vagy kézzel (mentsd el a Pixel Manager beállításait, vagy kattints a **Sync Now** gombra).

A sikeres szinkronizálás után is előfordulhat, hogy a bolt oldalgyorsítótára még a régi `quota_exceeded` jelzőt tartalmazó HTML-t szolgálja ki. Ez a leggyakoribb ok, amiért a proxy nem áll vissza.

Emellett a Pixel Manager JavaScriptje a proxy állapotát a böngésző sessionStorage-ában tárolja. Az a látogatói munkamenet, amelyik már találkozott a kvótatúllépéssel, a lap bezárásáig a tartalék útvonalon marad. Ez új lapok megnyitásával magától megoldódik.

A proxy visszaállítása:

1. Indíts újraszinkronizálást (beállítások mentése, **Sync Now**, vagy várj az automatikus szinkronra).
2. Ürítsd ki az összes oldalgyorsítótárat (gyorsítótár-bővítmény, tárhely, CDN, Cloudflare, Varnish).
3. Ellenőrizd egy új böngészőlapon, hogy mennek-e kérések a proxy aldomainjére a Network lapon.

A teljes helyreállítási listát a [Kezelés és hibaelhárítás](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/szerveroldal-kezeles/) fejezet „Túllépett kvóta” része tartalmazza.

## Működik a proxy Cloudflare-rel?

Igen. Ha a domained Cloudflare DNS-t használ, a CNAME rekord proxy-állapota **DNS only** (szürke felhő) legyen.

A **Proxied** (narancssárga felhő) rekord elrejti a CNAME-et a nyilvános DNS elől, ezért a portál DNS-ellenőrzése nem működik, a proxy aldomainje a Cloudflare 1014-es hibáját (CNAME Cross-User Banned) adja, és a tanúsítvány sem tud kiállítódni.

Ha a rekordot proxyzva kell tartanod, a portálon váltsd a domaint TXT tanúsítvány-ellenőrzésre (**Check DNS Status → Switch to TXT validation**). A részleteket és a kompromisszumokat a [beállítási útmutató](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/szerveroldal-beallitas/) írja le.