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 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:

a SweetCode Cloud portálon hozz létre külön domaint minden további domainhez;
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:

Indíts újraszinkronizálást (beállítások mentése, Sync Now, vagy várj az automatikus szinkronra).
Ürítsd ki az összes oldalgyorsítótárat (gyorsítótár-bővítmény, tárhely, CDN, Cloudflare, Varnish).
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 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ó írja le.

Készült: 2026. november 1.