A leírás tárgya: pixel és foglalási (Purchase) konverzió létrehozása az OpenAI Ads hirdetéskezelőben, majd az OpenAI pixel két tagjének (PageView és Purchase) felépítése a Google Tag Manager (GTM) tárolóban, a Stape közösségi sablonjával. A végén a működés Preview módban ellenőrizhető, és a változtatások publikálhatók.
0. Előfeltételek
Előfeltétel: a leírás feltétele, hogy a RESnWEB „GA4 mérési beállítások a foglalási rendszerhez (iframes beépítés esetén)” leírása már végig legyen vive: https://help.resnweb.net/hu/articles/9496440-ga4-meresi-beallitasok-a-foglalasi-rendszerhez-iframes-beepites-eseten – Az OpenAI tagek az ott létrejött dataLayer változókra (dL - …) és az Event - rnwEcommerce, purchase triggerre épülnek, ezeket itt nem kell újra létrehozni.
Hatókör: a leírás kizárólag a kliens oldali (böngészős) pixelt tárgyalja. A szerver oldali követés (Conversions API / CAPI, sGTM) nem része.
Szükséges hozzá:
Hozzáférés a szálláshely OpenAI Ads hirdetéskezelőjéhez (ads.openai.com).
Szerkesztési és publikálási jogosultság a weboldal GTM tárolójához.
A RESnWEB által ajánlott CookieYes beállítás: a CookieYes CMP tag a Consent Initialization – All Pages triggeren fut, és be van kapcsolva a Google Consent Mode támogatás.
A GTM-ben létrehozandó elemek:
Elem | Típus | Feladata |
OpenAI Ads Pixel by Stape | Tag template (közösségi sablon) | A két tag motorja, a GTM sablongalériából telepíthető (2. fejezet). |
Event - cookie_consent_update | Trigger (Custom Event) | A CookieYes által minden oldalbetöltéskor és hozzájárulás-módosításkor küldött eseményre fut (3. fejezet). |
OpenAI Pixel – PageView | Tag | page_viewed eseményt küld oldalbetöltéskor, ha a látogató elfogadta a marketing sütiket (4. fejezet). |
OpenAI Pixel – Purchase | Tag | order_created eseményt küld sikeres foglaláskor, a foglalás értékével, pénznemével és a vendég adataival (5. fejezet). |
A RESnWEB leírásból átvett, már meglévő elemek: az Event - rnwEcommerce, purchase trigger, valamint a dL - email, dL - phone_number, dL - address.first_name, dL - last_name, dL - address.city, dL - address.postal_code, dL - address.country, dL - ecommerce.currency és dL - ecommerce.value változók.
1. Purchase konverzió létrehozása az OpenAI Ads-ben
1.1 Pixel (adatforrás) létrehozása
Bejelentkezés után (ads.openai.com) a bal oldali menüben a Konverziók menüpontot kell megnyitni. A konverziós esemény mindig egy pixelhez (adatforráshoz) tartozik, ezért ha a hirdetési fiókban még nincs webes pixel, elsőként azt kell létrehozni: + Létrehozás → Adatforrás. Meglévő pixel esetén ez a lépés kihagyható, és az 1.2 lépés következik.
Az adatforrás neve tetszőleges (pl. My hotel pixel), utána Létrehozás. A Létrehozás gombbal egyben elfogadásra kerülnek az OpenAI Konverziós feltételei. Az automatikus speciális egyeztetés (advanced matching) alapértelmezetten be van kapcsolva, ezen nem szükséges változtatni.
A Létrehozás után megnyílik az „Állítsd be az adatforrásodat” ablak. Itt látható a Pixelazonosító, amely a másolás ikonnal kimásolható – erre a 4. és 5. fejezetben lesz szükség. A Beállítási kódot nem kell beilleszteni a weboldalba, mert a pixel telepítése a GTM-ből történik. A Következő: konverziós esemény létrehozása gombbal a folyamat az 1.3 lépésnél folytatódik.
1.2 Új konverziós esemény
Ha már van pixel (vagy az 1.1 lépésben elkészült), a konverziós esemény űrlapja a Konverziók oldal jobb felső sarkában, a + Létrehozás → Konverziós esemény menüponttal nyitható meg. A lista ekkor még üres.
1.3 Az űrlap kitöltése
Adatforrás: a weboldal pixele.
Alapesemény: Rendelés létrehozva – ez a pixel order_created eseménye, ezt küldi a GTM-ben a Purchase tag.
Konverzió neve: pl. Foglalás (Purchase). Ez a név jelenik meg a riportokban és a kampánybeállításoknál (a mező az alapesemény alapján automatikusan kitöltődik, felülírható).
Attribúciós időablakok: maradhat az alapértelmezés (30 nap átkattintás, 1 nap megtekintés), hacsak nincs ettől eltérő üzleti igény.
Ezután: Létrehozás. A megjelenő „Konverziós esemény kódja” ablak bezárható, a kódot nem kell beépíteni – az eseményt a GTM-ben létrehozott tag küldi.
1.4 A lista ellenőrzése
A Konverziós események fülön megjelenik az új konverzió, az alapeseménye order_created.
1.5 A pixel azonosító (Pixel ID)
Az Adatforrás fülön a pixel neve alatt is látható az azonosító (Pixel ID); erre a 4. és 5. fejezetben lesz szükség.
1.6 Hozzárendelés a kampányhoz
A kampány csak akkor optimalizál a konverzióra, ha a kampány beállításainál konverziós célként ki van választva (kampány létrehozásakor vagy szerkesztésekor).
2. Az „OpenAI Ads Pixel by Stape” sablon telepítése
A két tag a Stape által fejlesztett, a GTM közösségi sablongalériájában (Community Template Gallery) elérhető OpenAI Ads Pixel by Stape sablonra épül. A sablont tárolónként egyszer kell hozzáadni.
2.1 Templates → Search Gallery
A GTM bal oldali menüjében: Templates, majd a Tag Templates blokkban a Search Gallery gomb.
2.2 A sablon kiválasztása
A nagyító ikonra kattintva a keresőbe az OpenAI Ads Pixel kifejezést kell beírni, majd az OpenAI Ads Pixel by Stape (stape-io) találatot kiválasztani.
2.3 Add to workspace
Add to workspace, majd a felugró ablakban az Add gombbal a sablon jogosultságainak elfogadása. A sablon ezután megjelenik a Tag Templates listában.
3. Az „Event - cookie_consent_update” trigger létrehozása
A CookieYes minden oldalbetöltéskor (a látogató hozzájárulásának betöltésekor) és minden hozzájárulás-módosításkor cookie_consent_update eseményt küld a dataLayer-be. A PageView tag erre az eseményre fut, így akkor indul, amikor a hozzájárulási állapot már ismert – az első oldalon, a banner elfogadásakor sem vész el a PageView.
Triggers → New.
A trigger neve: Event - cookie_consent_update.
Trigger Configuration → Custom Event.
Event name: cookie_consent_update
This trigger fires on: All Custom Events.
Save.
4. Az „OpenAI Pixel – PageView” tag létrehozása
4.1 Új tag a Stape sablonnal
Tags → New. A tag neve: OpenAI Pixel – PageView. A Tag Configuration blokkban a Gallery részből az OpenAI Ads Pixel by Stape tagtípust kell kiválasztani.
4.2 A tag beállításai
OpenAI Pixel ID(s): az 1. fejezetben kimásolt pixel azonosító.
Event Name Setup Method: Override → Event Type: Standard → Event Name: page_viewed
Az Enable automatic User Data and Event Parameters mapping from the Data Layer és az Enable Advanced Matching maradjon bekapcsolva.
Consent Settings → Enable Google Consent Mode support: bekapcsolva.
4.3 Hozzájárulás és trigger
Advanced Settings → Consent Settings → Require additional consent for tag to fire → ad_storage.
Triggering → Event - cookie_consent_update.
Save.
5. Az „OpenAI Pixel – Purchase” tag létrehozása
5.1 A tag alapbeállításai
Tags → New, név: OpenAI Pixel – Purchase, tagtípus: OpenAI Ads Pixel by Stape.
OpenAI Pixel ID(s): ugyanaz a pixel azonosító.
Event Name Setup Method: Override → Event Type: Standard → Event Name: order_created (az OpenAI-ban ez a „Rendelés létrehozva” alapesemény, amelyre az 1. fejezetben a konverzió készült).
Az automatikus mapping és az Advanced Matching maradjon bekapcsolva, az Enable Google Consent Mode support legyen bekapcsolva.
5.2 Vendégadatok és foglalási érték
A User Data részben az Add Parameter gombbal felvett sorokban a következő párosításokat kell megadni (a változók a RESnWEB leírásból már léteznek):
Parameter Name | Parameter Value |
Email Address | {{dL - email}} |
Phone Number | {{dL - phone_number}} |
First Name | {{dL - address.first_name}} |
Last Name | {{dL - last_name}} |
City | {{dL - address.city}} |
ZIP Code | {{dL - address.postal_code}} |
Country | {{dL - address.country}} |
Az Event Parameters részben:
Parameter Name | Parameter Value |
Currency (Required if Amount is used) | {{dL - ecommerce.currency}} |
Amount (in the currency's regular unit) | {{dL - ecommerce.value}} |
5.3 Hozzájárulás és trigger
Advanced Settings → Consent Settings → Require additional consent for tag to fire → ad_storage.
Triggering → Event - rnwEcommerce, purchase (a RESnWEB leírásból).
Save.
6. Ellenőrzés Preview módban
6.1 Preview indítása
A GTM jobb felső sarkában: Preview. A Tag Assistant ablakban a weboldal címének megadása után Connect; a weboldal új lapon nyílik meg. A teszthez inkognitó ablak vagy törölt sütik javasoltak, hogy a CookieYes banner biztosan megjelenjen.
6.2 Sütik elfogadása, PageView ellenőrzése
A weboldalon a CookieYes bannerben a sütik elfogadása után a Tag Assistant lapon a bal oldali listában a cookie_consent_update eseményt kell kiválasztani: a Tags Fired részben meg kell jelennie az OpenAI Pixel – PageView tagnek. Ellenpróba: a marketing sütik elutasítása esetén a tag a Tags Not Fired részben marad – ez a helyes működés.
6.3 Purchase ellenőrzése
Ugyanebben a preview munkamenetben egy tesztfoglalás szükséges. A foglalás visszaigazolásakor a Tag Assistant listájában megjelenik egy rnwEcommerce esemény; ennek Tags Fired részében kell megjelennie az OpenAI Pixel – Purchase tagnek. A Variables fülön ellenőrizhető, hogy a dL - ecommerce.value és a dL - ecommerce.currency kapott-e értéket.
6.4 Ellenőrzés az OpenAI Ads-ben
Az OpenAI Ads hirdetéskezelőben a Konverziók → Eseményfolyam fülön néhány percen belül megjelennek a beérkező page_viewed (és a tesztfoglalás után az order_created) események.
7. Publikálás
Publikálás nélkül a tagek csak Preview módban futnak.
A GTM jobb felső sarkában: Submit.
Publish and Create Version kiválasztva marad.
Version Name: pl. OpenAI pixel – PageView + Purchase.
A Workspace Changes listában a sablonnak, a triggernek és a két tagnek kell szerepelnie; ezután Publish.
8. Gyakori hibák
A PageView soha nem fut le: ellenőrizendő, hogy a CookieYes a RESnWEB ajánlása szerint fut-e (CookieYes CMP tag, Consent Initialization – All Pages, bekapcsolt Google Consent Mode), és hogy a trigger eseményneve pontosan cookie_consent_update.
A tag lefut, de az OpenAI-ban nincs adat: ellenőrizendő, hogy mindkét tagben a helyes pixel azonosító szerepel.
A Purchase nem fut le: a Tag Assistantben az rnwEcommerce eseménynél a Variables fülön a dL - name értékének purchase-nak kell lennie. Ha a trigger vagy a dL változók hiányoznak, a RESnWEB GA4 leírás nincs végigvive.
Dupla PageView vagy dupla konverzió: ellenőrizendő, hogy nincs-e az oldalon más módon (kézzel beillesztett kód, másik GTM tároló, bővítmény) is OpenAI pixel.