# OpenAI

> Az OpenAI pixel beállítása: pixelazonosító, Conversions API, ChatGPT-kattintásazonosító, Advanced Matching, hozzájárulás és az eseményleképezés.

Az OpenAI böngészős pixel az ingyenes változatban is megvan. A Conversions API és az Advanced Matching Pro funkció. A bővítmény bétában kezeli. A beállítások a **Tracking Pixels** fül **OpenAI** kártyáján vannak.

![Az OpenAI kártya a Pixel ID, a Conversions API Token és az Advanced Matching beállítással](./kepek/pixelek-openai.webp)

*Az OpenAI kártya a Pixel ID, a Conversions API Token és az Advanced Matching beállítással* (https://minta-bolt.hu/wp-admin/admin.php?page=pmw)

A képen a **Pixel ID** alapmező és a **Show advanced settings** alatti **Conversions API Token** mező, valamint az **Advanced Matching** kapcsoló látható.

## Alapbeállítás

1. Nyisd meg az OpenAI Ads Managert, és lépj a **Conversions** fülre.
2. Hozz létre egy új pixelt, és másold ki a pixelazonosítóját.
3. A Pixel Managerben a **Tracking Pixels → OpenAI** kártyán illeszd be az azonosítót a **Pixel ID** mezőbe, és kattints a **Save** gombra.

## Conversions API (CAPI)

Pro funkció. A Conversions API az OpenAI pixel opcionális kiegészítése, amely a konverziós adatot valós időben, az OpenAI szerver-szerver protokolljával küldi. Pontosabb konverziókövetést ad, főleg azoknál az eseményeknél, amelyeket a böngészős követés hirdetésblokkolók vagy adatvédelmi beállítások miatt elveszíthet.

1. Nyisd meg az OpenAI Ads Managert, és lépj a **Conversions** fülre.
2. Hozz létre egy API-kulcsot a pixeledhez, és másold ki.
3. A Pixel Managerben a **Tracking Pixels → OpenAI** kártyán, a **Show advanced settings** alatt illeszd be a kulcsot a **Conversions API Token** mezőbe, és mentsd a beállításokat.

Az OpenAI nem használ teszteseménykódot. Az eseményeket a pixeled és az API-kulcsod alapján automatikusan érvényesíti, ezért nincs külön tesztmező.

A Conversions API hívásait a [Server-Side Proxy](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/szerveroldal/) is át tudja venni a WooCommerce szervertől, így csökken a szerver terhelése, és az események egy saját aldomainen át mennek.

### ChatGPT-kattintásazonosító (oppref)

Ha a látogató a ChatGPT-ből érkezik, a céloldal URL-je tartalmaz egy `oppref` paramétert. Ez az OpenAI kattintásazonosítója, amellyel az OpenAI a ChatGPT-beli interakciótól a végső vásárlásig nyomon követheti a látogatót. A Pixel Manager a céloldalon magától rögzíti az azonosítót, a pénztáron át megőrzi, és az összes Conversions API eseményhez, a vásárlásihoz is csatolja. Beállítás nem kell.

### Böngészőazonosító (obref)

Az OpenAI pixel a böngészőazonosítót az `__obref` sütiben tárolja. A Pixel Manager kiolvassa, és minden Conversions API eseményhez `user.obref` néven csatolja, a szerverről küldött vásárlási eseményhez is, így az OpenAI a szerveroldali eseményt ahhoz a böngészőhöz tudja párosítani, amelyben a hirdetésre kattintottak. Csak akkor olvassa ki, ha a marketing-hozzájárulás meg van adva. Beállítás nem kell.

## Advanced Matching

Pro funkció. Az Advanced Matching az OpenAI pixel opcionális kiegészítése, amely a konverziós adatot a konverzióért felelős személlyel párosítja. Hash-elt vásárlóazonosítókat küld az OpenAInak a weboldali események párosításához. Az eszközök közötti fizetések követését is lehetővé teszi, amit más módon nem lehetne megtenni. Ennek eredményeként pontosabban látod a konverziókat az OpenAI Ads Managerben.

Kapcsold be a **Tracking Pixels → OpenAI → Advanced Matching** helyen.

Bekapcsolva a Pixel Manager a böngészős pixelen és a Conversions API-n is elküldi a következő mezőket, az OpenAI előírása szerint normalizálva és hash-elve (SHA-256, kisbetűs hexadecimális):

| Mező | Hogyan megy |
|---|---|
| E-mail-cím | hash-elve |
| Telefonszám | hash-elve, nemzetközi formátumban `+` nélkül |
| Keresztnév, vezetéknév | hash-elve, kisbetűsen, szóközök és írásjelek nélkül |
| Vásárlóazonosító (bejelentkezett vásárlóknál) | hash-elve |
| Számlázási ország | nyersen, kétbetűs kóddal |
| Számlázási régió (megye, állam) | nyers névvel, például `California` |
| Számlázási város | nyersen |
| Számlázási irányítószám | nyersen |

Az értékek a bejelentkezett vásárló profiljából jönnek, a rendelés visszaigazoló oldalán pedig a rendelés számlázási adataiból. A Conversions API az OpenAI listaformátumában (`emails_sha256`, `countries` és így tovább) kapja őket.

Az OpenAI automatikus Advanced Matchinget is kínál, amelyet pixelenként az OpenAI Ads Managerben kapcsolsz be, és amellyel a pixel maga ismeri fel és hash-eli az oldalon látható vásárlói adatokat. Ez a Pixel Manager Advanced Matchingjétől függetlenül működik, és együtt is használható vele.

## Hozzájárulás

Az OpenAI pixel csak akkor töltődik be, ha a látogató megadta a marketing-hozzájárulást. Ha a látogató később a sütibannerben visszavonja, a Pixel Manager utasítja az OpenAI SDK-t, hogy hagyja abba az események küldését (`oaiq("consent", false)`), és újra engedélyezi, amikor a hozzájárulás ismét megvan.

## Támogatott események

A Pixel Manager a saját eseményeit az OpenAI szabványos eseményneveire képezi le:

| Pixel Manager esemény | OpenAI esemény |
|---|---|
| Oldalmegtekintés | `page_viewed` |
| Termék megtekintése | `contents_viewed` |
| Kosárba tétel | `items_added` |
| Pénztár indítása | `checkout_started` |
| Vásárlás | `order_created` |
| Fiók létrehozása | `registration_completed` |
| Próbaidős előfizetés létrehozása (WooCommerce Subscriptions) | `trial_started` |
| Az előfizetés első fizetése (WooCommerce Subscriptions) | `subscription_created` |

A rendeléshez tartozó Conversions API események minden rendelési sort egységárral küldenek, a változatos termékeknél a szülőtermék (`group_id`) és a kiválasztott változatattribútumok (`variant_dict`) is benne vannak.

Az általános eseménylista a [Támogatott események](https://hub.hellowp.io/hu/plugins/woocommerce-pixel-manager/funkciok-esemenyek/) fejezetben van.