Server-Side Proxy beállítása

Ez az útmutató a Server-Side Proxy aktiválását vezeti végig: fiók létrehozása, proxydomain felvétele, DNS beállítása és a Pixel Managerhez kapcsolás. Ez Pro funkció.

Előkészületek

• A Pixel Manager Pro telepítve és aktiválva van (legalább 1.57.0-s verzió).
• Legalább egy szerveroldali cél be van állítva (például Meta CAPI hozzáférési token és pixelazonosító, TikTok Events API token).
• Van DNS-hozzáférésed a bolt domainjéhez.
• Van egy e-mail-címed a SweetCode Cloud regisztrációhoz.

1. SweetCode Cloud fiók létrehozása

1. Nyisd meg a SweetCode Cloud portált (portal.sweetcode.cloud).
2. Add meg az e-mail-címedet, és kattints a bejelentkezésre.
3. A postaládádba érkező egyszer használatos hivatkozásra kattintva belépsz az irányítópultra.

A bejelentkezés jelszó nélküli, nem kell jelszót megjegyezned. Alapból ingyenes csomag jár, amelyet később magasabb kérésszámú csomagra cserélhetsz.

2. A domain felvétele a portálon

1. Az irányítópult oldalsávján válaszd a Domains menüt.
2. Kattints az Add Domain gombra.
3. Írd be a bolt domainjét (például aboltod.hu).
4. Ha szeretnéd, módosítsd az aldomain előtagját. Az alapérték ssp, így az aldomain ssp.aboltod.hu lesz.
5. Kattints az Add gombra.

A portál megmutatja a következő lépésben felveendő CNAME rekordot.

3. DNS beállítása

Vedd fel a CNAME rekordot a domain DNS-beállításaiban:

Típus	Név	Cél
CNAME	ssp	ssp.sweetcode.cloud

Ha más előtagot választottál, az ssp helyére azt írd.

Cloudflare-es DNS: „DNS only”, nem „Proxied”

Ha a domained Cloudflare DNS-t használ, a CNAME rekord proxy-állapota DNS only (szürke felhő) legyen. Ha Proxied (narancssárga felhő), a Cloudflare a saját IP-címeivel válaszol a DNS-kérésekre, és nem teszi közzé a CNAME-et. Ennek következményei:

• a SweetCode Cloud portál DNS-ellenőrzése nem látja a rekordot, és hiányzónak jelzi;
• az ssp.aboltod.hu megnyitásakor a Cloudflare 1014-es hibát ad (CNAME Cross-User Banned);
• a tanúsítvány ellenőrzése sosem ér el a SweetCode Cloudhoz, lejár az ideje, és a proxydomain a Pending DNS állapotban ragad.

A DNS only beállítás nem okoz hátrányt: az ssp.sweetcode.cloud eleve a Cloudflare peremhálózatán fut, az események így is a gyors úton mennek.

Ha a rekordot mégis proxyzva szeretnéd tartani (Cloudflare Orange-to-Orange beállítás), a tanúsítványt másképp kell ellenőrizni: a portálon nyisd meg a domaint, kattints a Check DNS Status gombra, és válaszd a Switch to TXT validation lehetőséget. A portál megad egy TXT rekordot, amelyet fel kell venned, az ssp rekord pedig maradhat narancssárga. Vedd figyelembe a hátrányt: a proxyzott rekordnál a saját Cloudflare-zónád kezeli először a kéréseket, ezért a WAF-szabályaid, a Bot Fight Mode, a sebességkorlátok és a gyorsítótár-beállítások a követési eseményekre is vonatkoznak. Egy automatikus kéréseket kihívással megállító szabály csendben eldobja az eseményeket.

A rekord felvétele után:

1. Térj vissza a SweetCode Cloud irányítópultra.
2. Kattints a domainnél a Verify DNS gombra.

A DNS-terjedés néhány percig tarthat. Ha az ellenőrzés nem sikerül, várj, és próbáld újra.

4. Csatlakoztatás a Pixel Managerhez

1. A SweetCode Cloud irányítópultján nyisd meg a domaint, és másold ki a Sync Tokent.
2. A WordPressben a WooCommerce → Pixel Manager → Server-Side fülön görgess a SweetCode Server-Side Proxy szakaszhoz.
3. Illeszd be a tokent a Sync token mezőbe.
4. Kattints az Activate gombra.

A Pixel Manager ekkor:

• ellenőrzi a szinkronizációs tokent a SweetCode Clouddal;
• lekéri a domain beállításait;
• automatikusan elküldi az összes beállított cél hitelesítő adatait (pixelazonosítók, API-tokenek).

Siker esetén megjelenik az állapotpanel a kapcsolat állapotával. Kézi szinkronizálásra nincs szükség, a célok az aktiváláskor automatikusan átkerülnek.

Ürítsd ki a gyorsítótárakat

Az aktiválás után ürítsd ki a bolt minden szerveroldali gyorsítótárát:

• objektumgyorsítótár (Redis, Memcached stb.);
• oldalgyorsítótár (WP Super Cache, W3 Total Cache, LiteSpeed stb.);
• tárhelyszintű teljes oldalas gyorsítótár (Cloudflare, Varnish stb.).

A Pixel Managernek frissített JavaScript-beállítást kell kiírnia a frontendre, a gyorsítótárazott oldalak viszont a régi beállítást tartalmazzák, amíg nem ürítesz.

5. Ellenőrzés

1. A WooCommerce → Pixel Manager → Server-Side fül SweetCode Server-Side Proxy szakaszában nézd meg az állapotpanelt: a Routing Status Active, a Config Status Synced, és az általános állapotjelvény is Active legyen.
2. A SweetCode Cloud portálon az Events → Live nézetben valós időben látod a bolt eseményeit.
3. Nyiss meg néhány termékoldalt, és tegyél egy terméket a kosárba. Az események másodpercek alatt megjelennek a portálon.

Ha nem látsz eseményeket, a Kezelés és hibaelhárítás fejezet gyakori hibáit nézd át.

Mi történik az aktiválás után

A proxy innentől magától működik:

• A böngészős események (PageView, ViewContent, AddToCart, InitiateCheckout stb.) az aldomainen át a SweetCode Cloudhoz mennek, ami továbbítja őket a beállított hirdetési platformoknak.
• A vásárlási események is a proxyn át mennek, a proxy elérhetetlensége esetén automatikus közvetlen küldéssel.
• A beállítások automatikusan szinkronizálódnak: ha módosítasz egy CAPI-tokent vagy pixelazonosítót a Pixel Managerben, az új adatok magától átkerülnek a SweetCode Cloudhoz. Naponta is fut egy szinkronizálás.