> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/hu/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-shoppable-banner-interaction-reporting.md). # Banner X megvásárolható banner interakciós jelentések integrálása A vásárolható banner egy olyan Banner X hirdetés, amely egyetlen elhelyezésen belül több kísérőtermék-hotspottal rendelkezik. Amint ezek az események beáramlanak, a kampányjelentés lebontja a banner teljesítményét az egyes kísérőtermékekre — megjelenések, kattintások és CTR (valamint kosárműveletek, ahol integrálva van) — egyetlen bannerszintű összesítés helyett. Ez az útmutató csak a vásárolható banner kölcsönhatási típusaira terjed ki. A végpontot, az hitelesítést, a fő mezőket (`adId`, `timestamp`, nyomon követési azonosító), a beacon-mechanizmust, a deduplikációt és a tesztelést illetően lásd a [Hirdetéskölcsönhatási események jelentésének technikai referenciaútmutatója](https://help.citrusad.com/retail-media-interface/integration/hu/data-api/api-overview/ad-interaction-events-reporting). ## Előfeltételek | Előfeltétel | Cél | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | | Olvassa el a [Technikai referenciaútmutató](https://help.citrusad.com/retail-media-interface/integration/hu/data-api/api-overview/ad-interaction-events-reporting) | Megerősíti a végpontra, a hitelesítésre, a fő mezőkre és a deduplikációra vonatkozó követelményeket. | | A kísérőtermékek beállítva a Banner X kreatív anyag | Biztosítja, hogy a termékszintű kölcsönhatások hozzárendelhetők legyenek a kreatív anyaghoz. | | A kiszolgált hirdetések egy megvalósult `adId` | Minden egyes eseményt a kézbesített hirdetéspéldányhoz kapcsol. | | `productCode` és `catalogId` elérhető kísérőtermékenként | Azonosítja a jelentésben használt terméket és katalógust. | | A termékkártyákra vonatkozóan elfogadott láthatósági szabály | Meghatározza, hogy egy termékkártya mikor számít látottnak a következők szerint: `productImpression`. | | Konzisztens nyomon követési azonosító hirdetési munkamenetenként | Támogatja a hozzárendelést és a deduplikációt a következő használatával: `sessionId`, `customerId`, or `dtmToken`. | ## Kölcsönhatási típusok vásárolható banner jelentésekhez Ezek a következők: `adInteraction` események (nincs `moduleId`). Küldje el a fő mezőket, valamint az alábbi kulcsfontosságú mezőket. `productImpression` és `productClick` az a két esemény, amely feloldja a Termékek lapot — mindkettőt süsse el. | `interactionType` | Kulcsfontosságú mezők | Mikor kell elsütni | Jelentési cél | | ------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | `productImpression` | `productCode`, `catalogId` | Egy termékkártya/SKU láthatóvá válik a láthatósági szabályai szerint | Termékenkénti megjelenések — kitölti a megjelenés oszlopot (és a nulla kattintásos sorokat) | | `productClick` | `productCode`, `catalogId` | A vásárló egy termékkártyára/SKU-ra kattint | Termékenkénti kattintások — a kattintásokat és a CTR-t hajtja meg | | `creativeClick` | `creativeId` | Kattintás egy nem termék jellegű kreatív elemre | Elköteleződés nem termék jellegű kreatív anyaggal | | `cart` | `productCode`, `catalogId`, `units`, opcionális `conversionValue` | Kosárváltozás a hirdetés kontextusából | Kosárba helyezési szándék / termékérték | ## Láthatósági szabályok ehhez: `productImpression` | Szabály | Útmutatás | | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Határozza meg, mikor számít egy kártya látottnak | Állapodjon meg egy láthatósági szabályban, például a látható százalék plusz a képernyőn töltött idő tekintetében, és alkalmazza azt következetesen a webes és az alkalmazási felületeken. | | Süsse el a megjelenéseket láthatósági eseményenként egyszer | Szűrje ki a görgetési ingadozásokat és az újrarendereléseket, hogy egyetlen megtekintést ne számoljon el többször. | ## Kosár: Abszolút jelenlegi egységszámot küldjön Süsse el a következőt: `cart` minden kosárműveletnél — kezdeti hozzáadás, minden egyes `+`, minden egyes `−`, és eltávolítás (vissza a következőre: `0`) — a következőkkel: `units` az abszolút jelenlegi egységszámra állítva, nem pedig változásra. A jelenlegi összesen érték újraküldése pontosan tartja a számításokat deduplikáció mellett is. Adja hozzá a következőt: `conversionValue` amikor rendelkezésre áll. {% hint style="info" %} **Példa** — egy vásárló hozzáad egy terméket, kétszer növeli a mennyiséget, majd eltávolítja:\*\* `cart {units: 1}` → `cart {units: 2}` → `cart {units: 3}` → `cart {units: 0}` {% endhint %} ## Lépésről lépésre történő megvalósítás ### 1. lépés — A hirdetési kontextus rögzítése Olvassa ki a megvalósult `adId` értéket a kiszolgált hirdetésből, és a következőt: `productCode`/`catalogId` minden egyes kísérőkártyához. Hozzon létre egyetlen nyomon követési azonosítót a munkamenethez, és használja fel újra a megjelenéseknél és a kattintásoknál. ### 2. lépés — Termékmegjelenések elsütése Amikor egy kártya megfelel a láthatósági szabálynak, süsse el a következőt: `productImpression` egyszer arra a termékre. ```javascript navigator.sendBeacon( "https://integration.{retailer}.citrusad.com/v1/events/ad/interaction?" + new URLSearchParams({ adId, interactionType: "productImpression", sessionId, timestamp: new Date().toISOString(), productCode, catalogId }) ); ``` ### 3. lépés — Termékkattintási esemény beküldése ```javascript navigator.sendBeacon( "https://integration.{retailer}.citrusad.com/v1/events/ad/interaction?" + new URLSearchParams({ adId, interactionType: "productClick", sessionId, timestamp: new Date().toISOString(), productCode, catalogId }) ); ``` ### 4. lépés — Kosárváltozások beküldése Hozzáadáskor/frissítéskor küldje be a következőt: `cart` a pontosan aktuális `units` értékkel ahhoz a termékhez (és `conversionValue` ha rendelkezésre áll) — lásd a fenti kosárszabályt. ## Minta kérések Teljes GET URL-ek (az olvashatóság érdekében soremeléssel — egyetlen kódolt lekérdezési karakterláncként küldje el). ### Termékmegjelenítés ```http GET https://integration.retailer.citrusad.com/v1/events/ad/interaction ?adId=shotgun_0001 ×tamp=2026-05-20T10:15:00Z &sessionId=12345gsyuhf-6678ghsj &productCode=prod-00001-01 &catalogId=catlg-custom-DAA001 &interactionType=productImpression ``` ### Termékkattintás ```http GET https://integration.retailer.citrusad.com/v1/events/ad/interaction ?adId=shotgun_0001 ×tamp=2026-05-20T10:15:30Z &sessionId=12345gsyuhf-6678ghsj &productCode=prod-00001-01 &catalogId=catlg-custom-DAA001 &interactionType=productClick ``` ### Kosárba helyezés hirdetésből ```http GET https://integration.retailer.citrusad.com/v1/events/ad/interaction ?adId=shotgun_0001 ×tamp=2026-05-20T10:16:00Z &customerId=cust-abc-123 &productCode=prod-00001-01 &catalogId=catlg-custom-DAA001 &interactionType=cart &units=2 &conversionValue=29.99 ``` ## Hogyan néz ki a helyes működés | Ellenőrzés | Részletek | | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | Az események HTTP 200 választ adnak vissza | `productImpression` és `productClick` HTTP 200 választ ad vissza a PRE/QA környezetben. | | A Termékek lap teljesen fel van töltve | Minden beállított kísérőtermék megjelenik, beleértve az interakció nélküli sorokat is (a megjelenítések feltöltik a kattintás nélküli sorokat). | | A deduplikáció működik | A darabszámok stabilak maradnak, amikor újra beküldi ugyanazt a megjelenítést/kattintást. | ## Hibaelhárítás (Vásárolható bannerre vonatkozó részletek) | Tünet | Megoldás | | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | A szükséges termékesemények nem érkeznek meg | Győződjön meg róla, hogy a banner Banner X kísérőtermékekkel van ellátva a kreatív anyag szakaszában, és hogy a(z) `productImpression` és `productClick` események beküldése ezzel történik: `productCode`/`catalogId`. | | A megjelenítések minden görgetéskor/újrarajzoláskor beküldésre kerülnek | Küldjön be egy `productImpression` eseményt termékenként és láthatósági alkalmanként; használjon debounce-olást. | | A Termékek lap rossz vagy hiányzó termékeket jelenít meg | Valószínűleg egy `productCode`/`catalogId` eltérés van a katalógussal — egyeztesse a beküldött ID-kat a katalóguscsatornával. | | A kosárban lévő mennyiségek hibásnak tűnnek | Ön eltéréseket (delta) küld — küldje a pontosan aktuális `units`. | Az általános végpont-hibaelhárításhoz lásd a(z) [Hirdetéskölcsönhatási események jelentésének technikai referenciaútmutatója](https://help.citrusad.com/retail-media-interface/integration/hu/data-api/api-overview/ad-interaction-events-reporting) hibaelhárítási szakaszt. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/integration/hu/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-shoppable-banner-interaction-reporting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.