# Click ID rögzítése

> A hirdetési kattintásazonosítók (gclid, fbclid és mások) mentése a rendeléshez, és a rögzítés minőségét mutató jelentés.

A Click ID rögzítése Pro funkció.

Minden hirdetési platform azonosítót ad a hirdetésre kattintó látogatónak: a Google Ads `gclid`-et, a Meta `fbclid`-et, a TikTok `ttclid`-et. Ez az azonosító köti össze a bolt vásárlását a hirdetéssel, amely hozta.

A gond az, hogy a kattintásazonosító csak a böngészőben él: a belépőoldal paramétereként érkezik, és mire a rendelés létrejön, eltűnik a címsorból. A szerveroldali követés viszont a rendelés létrehozásakor fut, néha sokkal később (fizetési webhookból, állapotváltozáskor vagy utólagos feltöltéskor), amikor az eredeti látogatásból semmi sem maradt.

A Pixel Manager ezért rögzíti a látogatás kattintásazonosítóit, és egy pillanatképet ment a rendeléshez. Minden szerveroldali célpont ebből olvassa az azonosítót, még az is, amelyet a rendelés leadása után kapcsoltál be.

## Mely azonosítókat rögzíti?

| Platform | Azonosító |
|---|---|
| Google Ads | `gclid`, `wbraid`, `gbraid` |
| Meta (Facebook) | `fbclid` |
| Microsoft Advertising | `msclkid` |
| TikTok | `ttclid` |
| Snapchat | `scid` (az URL-ben `ScCid`-ként érkezik) |
| Pinterest | `epik` |
| Reddit | `rdt_cid` |
| Nextdoor | `ndclid` |
| OpenAI | `oppref` |

Csak azokat a platformokat rögzíti, amelyek be vannak állítva a Pixel Managerben. A kattintásazonosító személyes adat, és értelmetlen volna olyan platformé után tárolni, amelynek nincs célpontja a boltban.

## Honnan származik az azonosító?

Egyetlen forrás túl sok rendelést hagyna ki, ezért négy rétegből olvas, és az első olyat veszi, amelyben van érték:

1. **A hirdetési platform saját sütije.** A legtartósabb forrás, a platform címkéje írja (például a Google Ads `_gcl_aw` sütije).
2. **A Pixel Manager saját sütije, a `pmw_click_ids`** (régebben `_pmw_click_ids`). A belépőoldalon íródik a böngészőben, a szerverről frissül, 90 napig él, és túléli azt is, ami a többi réteget nem: a bezárt lapot, a lejárt WooCommerce-munkamenetet és a le nem futott platformcímkéket. A `wbraid` és `gbraid` azonosítóknak nincs platformsütijük, ezért náluk ez az egyetlen süti.
3. **A WooCommerce-munkamenet.** A kosár- és pénztároldalakon a böngésző által jelentett értékek.
4. **Az aktuális kérés URL-je**, azoknál a látogatásoknál, amelyek ugyanazon az oldalon érkeznek és vásárolnak.

A rögzítés ott történik, ahol a vásárló böngészője még jelen van: a pénztárnál, a rendelés kifizetése oldalon, és a megerősítő oldalon, második esélyként. Így azoknál a rendeléseknél is megvan az azonosító, ahol a vásárló sosem tér vissza a fizetési szolgáltatótól.

## Marketing-hozzájárulás kell hozzá

A `pmw_click_ids` süti marketingsütinek számít, ezért a bővítmény csak akkor írja, ha a látogató megadta a marketing-hozzájárulást. A platformok saját sütijére (az első réteg) ugyanez érvényes, mert az őket író címkék sem futnak hozzájárulás előtt.

Kifejezett beleegyezést kérő bannernél ennek közvetlen következménye van: az azonosítóval rendelkező rendelések aránya nem lehet magasabb, mint a marketingkategóriát elfogadó látogatók aránya. Ha a bannert ritkán fogadják el, vagy a marketingkategória nincs jól bekötve a hozzájárulás-kezelőbe, a rögzítési arány is csökken. Ez elvárt működés, nem követési hiba. A hozzájárulás kezeléséről a [Hozzájárulás és adatvédelem](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/hozzajarulas/) fejezet szól.

## Egy rendelés kattintásazonosítójának kiolvasása

A Click ID Capture Quality jelentés a teljes bolt képét adja. Ha egy konkrét rendelést vizsgálsz (tipikusan olyan konverziót, amelyet a hirdetési platform nem jelentett), annak azonosítójára és a kattintás dátumára van szükséged.

Mindkettő olyan rendelési metában van, amelynek kulcsa aláhúzással kezdődik. A WordPress ezeket védettnek tekinti, és elrejti a rendelés képernyőjéről, ezért a WooCommerce adminisztrációjában nem látod őket. A kulcsok:

| Meta kulcs | Mit tartalmaz |
|---|---|
| `_pmw_click_ids` | A látogatás során rögzített összes kattintásazonosító `kulcs => érték` térképként, például `gclid => Cj0KCQ…` |
| `_pmw_click_ids_provenance` | Melyik réteg és melyik rögzítési pont szolgáltatta az egyes azonosítókat |
| `_wpm_gclid` | Csak a Google Ads azonosítója, a régebbi mechanizmus megmaradt tartaléka a régebbi rendelésekhez |
| `_wc_order_attribution_session_start_time` | A hozzárendelt látogatás rögzítésének időpontja, vagyis a kattintás dátuma. Ezt a WooCommerce rendelés-hozzárendelése írja, nem a Pixel Manager |

A legmegbízhatóbb módszer a WP-CLI, mert ugyanúgy működik HPOS-os és hagyományos (bejegyzéstáblás) rendeléstárolásnál is. Cseréld ki a rendelésazonosítókat a sajátjaidra:

```bash
wp eval 'foreach ([123,124] as $id) { $o = wc_get_order($id); if (!$o) { echo "$id: not found\n"; continue; } echo $id . " | click IDs: " . wp_json_encode($o->get_meta("_pmw_click_ids", true)) . " | legacy gclid: [" . $o->get_meta("_wpm_gclid", true) . "] | click date: [" . $o->get_meta("_wc_order_attribution_session_start_time", true) . "]\n"; }'
```

Adatbázis-klienssel (phpMyAdmin, Adminer) HPOS-os boltnál az első, a bejegyzéstáblában tárolt rendelésnél a második lekérdezést használd. Ha más a táblaprefixed, módosítsd a `wp_` részt.

```sql
SELECT order_id, meta_key, meta_value FROM wp_wc_orders_meta
WHERE order_id IN (123,124)
  AND meta_key IN ('_pmw_click_ids','_wpm_gclid','_wc_order_attribution_session_start_time');
```

```sql
SELECT post_id, meta_key, meta_value FROM wp_postmeta
WHERE post_id IN (123,124)
  AND meta_key IN ('_pmw_click_ids','_wpm_gclid','_wc_order_attribution_session_start_time');
```

A `_pmw_click_ids` szerializált tömbként tárolódik, így az adatbázis-kliensben például `a:1:{s:5:"gclid";s:95:"Cj0KCQ…";}` alakú. A WP-CLI olvasható JSON-ként írja ki, ezért ajánlott. Ha a lekérdezés semmit sem ad, lehet, hogy a megjelenített rendelésszámot használtad a belső rendelésazonosító helyett. Nyisd meg a rendelést az adminisztrációban, és az azonosítót a címsorból vedd.

### Az eredmény értelmezése

- **Nincs kattintásazonosító a rendelésen.** A rendelést hozó látogatásnak nem volt, vagy a marketing-hozzájárulás sosem lett megadva, így semmi sem tárolódhatott. A hirdetési platformnak nincs mihez kötnie a konverziót, ezért nem jelenti, bármilyen jól futott is a pixel.
- **Van azonosító, de a kattintás dátuma régebbi a platform kattintási ablakánál.** A Google Ads alapértelmezett ablaka 30 nap. Az ablakon kívüli kattintást nem számolja. A WooCommerce ettől még megjelölheti a hirdetést a rendelés forrásának, mert az ő hozzárendelése az ablaktól függetlenül van beállítva.
- **Van azonosító, és a dátum az ablakon belül van.** A hozzárendeléshez minden megvolt. Ha a platform mégsem jelenti a rendelést, az ok később keresendő: a vásárló böngészőjében blokkolt kérés, ugyanarra a konverzióazonosítóra író másik címke, vagy a platform saját hozzárendelési modellje. Kezdd azzal, amit a rendelések listájának pipája bizonyít és nem bizonyít (lásd a [Diagnosztika és tesztelés](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/diagnosztika-es-tesztelles/) fejezetet).

## A Click ID Capture Quality jelentés

A Pixel Manager **Support → Debug report** részében van egy szakasz, amely megmutatja, hogyan megy a rögzítés a boltodban. Például:

```text
## Click ID Capture Quality ##
Orders scanned (newest first):     250 (2026-05-12 to 2026-09-14)
Click ID capture active since:     2026-08-26
Orders created since then:         39
With at least one click ID:        26 (67%)
Browser conversion pixel missed:   4
  of those, with a click ID:       2 (50%)
  of those, not storefront orders: 3 (75%)
Not from the storefront checkout:  3 (8%)
Click IDs by key:                  gclid 26
Order origin (created_via):
  checkout:                        36 (storefront)
  rest-api:                        2
  admin:                           1
Capture layer (per click ID):
  platform_cookie:                 21
  pmw_cookie:                      5
Capture point (per click ID):
  order_created via wc-ajax:checkout: 26
```

Soronként:

- **Orders scanned:** meddig nézett vissza a jelentés, a legrégebbi és a legújabb rendelés dátumával. Mindig a legújabb 250 rendelés, ami a legtöbb boltnál több hónap.
- **Click ID capture active since:** az a nap, amikor a bolt először futtatott olyan változatot, amely tudott azonosítót rögzíteni. Az ennél régebbi rendelések nem hordozhatnak azonosítót, ezért a továbbiakból kimaradnak.
- **Orders created since then:** a rendelések száma, amelyből a többi érték készül. Ez a fontos szám: ha kicsi, minden alatta lévő százalék pontatlan.
- **With at least one click ID:** maga a rögzítési arány.
- **Browser conversion pixel missed:** azok a rendelések, amelyek vásárlója nem jutott el a megerősítő oldalra, így nem futhatott böngészős pixel. Az alatta lévő sor mutatja, hány hordoz mégis kattintásazonosítót. Pontosan ezt a rést zárja be a szerveroldali követés.
- **of those, not storefront orders:** a fenti szám azon része, amelynél eleve nem volt böngészős esemény, mert a rendelést nem a pénztáradon adták le. Ha a magas hiányszám szinte csak ezekből áll, az normális, nem hibás pixel.
- **Not from the storefront checkout:** ugyanez az elv az összes átvizsgált rendelésre. Azokat, amelyeknél a WooCommerce nem rögzített eredetet, nem számolja ide.
- **Click IDs by key:** mely platformok szállítanak ténylegesen kattintásokat.
- **Order origin (created_via):** a rendelések bontása létrehozójuk szerint. A `checkout` a klasszikus pénztár, a `store-api` a blokkos pénztár, mindkettő (storefront) jelölést kap. Minden más, például `rest-api`, `admin` vagy előfizetés-megújítás, böngésző nélkül érkezik. Ezek is küldenek szerveroldali vásárlási eseményt, ezért mutathat egy hirdetési platform sokkal több szerveroldali, mint böngészős eseményt azoknál a boltoknál, amelyek integrációkon át értékesítenek.
- **Capture layer:** a négy forrás közül melyik szolgáltatta az egyes azonosítókat.
- **Capture point:** melyik pénztári folyamatban készült a pillanatkép. Akkor hasznos, ha csak egy pénztártípusnál vesznek el azonosítók.

Frissítés után közvetlenül ez jelenhet meg helyette:

```text
Orders scanned (newest first):     250 (2026-05-12 to 2026-08-26)
Click ID capture active since:     2026-08-26
Orders created since then:         0
No order was created after click ID capture became active on this shop,
so there is nothing to measure yet. Check again once orders come in.
```

Ez nem hiba: csak annyit jelent, hogy a funkció újabb a legutóbbi rendelésednél. Pár hét rendelés után nézd meg újra.

## Mit ellenőrizz, ha alacsony az arány?

- **Frissen frissítettél?** Az **Orders created since then** sort nézd meg először: néhány rendelés még semmit sem mond.
- **Futottak kampányok az időszakban?** Kattintásazonosító csak akkor rögzíthető, ha a látogatók ténylegesen hirdetésen át érkeznek.
- **Megadják a marketing-hozzájárulást?** Kifejezett beleegyezést kérő boltnál ez a legnagyobb tényező. Ellenőrizd, hogy a banner marketingkategóriája jól van-e hozzárendelve, és hogy a látogatók milyen gyakran fogadják el.
- **Be van állítva a platform?** Nem beállított platformhoz nem rögzít semmit.
- **A rendeléseid egyáltalán a pénztáradból jönnek?** Nézd meg a **Not from the storefront checkout** sort és az **Order origin** bontást. Az integrációból, az adminból vagy előfizetés-megújításként létrejött rendelés mögött nincs böngészős látogatás, így azonosítót sem hordozhat. Ahol a rendelések többsége így érkezik, az alacsony arány puszta számtan.
- **Futnak a Pixel Manager szkriptjei?** Ha egy optimalizáló késlelteti, halasztja vagy eltávolítja őket, a böngészőréteg sosem írja a sütit. Lásd a [Kompatibilitás és gyorsítótár](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/kompatibilitas/) fejezetet.
- **Blokkolja egy tűzfal a böngésző jelentését?** Egy ModSecurity- vagy WAF-szabály, amely a kosár és a pénztár `admin-ajax.php` felé menő `POST` kérésére `406`-tal válaszol, csendben kizárja a kattintásazonosítókat a WooCommerce-munkamenetből. Lásd a [Hibaelhárítás](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/hibaelharitas/) fejezetet.