# Server-Side Proxy beállítása

> A proxy aktiválása az elejétől a végéig: SweetCode Cloud fiók, domain, DNS CNAME, szinkronizációs token, gyorsítótárak ürítése, ellenőrzés.

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 Token**t.
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](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/szerveroldal-kezeles/) 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.