> 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/brand-pages/brand-page-retailer-integration-guide/validation-troubleshooting.md).
# Validálás és hibaelhárítás
## Tesztelés és érvényesítés
### Indítás előtti érvényesítési ellenőrzőlista
**Technikai integráció**
* [ ] API :`POST /ads/v3/brand-pages` 200-as kódot ad vissza a következőkkel: `contentData`.
* [ ] Megjelenítés : A tartalommodulok megfelelően, a helyes sorrendben jelennek meg az oldalán.
* [ ] Téma: `theme` mezők alkalmazása helyes; `null` értékek visszatérnek a kiskereskedői stílusterv alapértelmezett értékeire.
* [ ] Opcionális mezők: A megjelenítési és követési logikának el kell viselnie a kihagyott, null értékű vagy üres opcionális modulmezőket, valamint a kihagyott követési csomópontokat is hiba nélkül (az érvényesítést több élő sablonnal végezze, ne csak egyetlen demó márkoldallal).
* [ ] Stílus : A márkoldal illeszkedik az Ön oldalának tervezési rendszeréhez (design system).
* [ ] Mobil : A márkoldal megfelelően jelenik meg a mobilkészülékeken.
* [ ] Cache-busting : `{TS}` értéke minden kérésnél változik.
**Követés érvényesítése**
* [ ] Megjelenési pixel (C2S) : Minden bejegyzés ebben: `trackingTemplates.client.impressionPixelUrls` lefut és 200-as kódot ad vissza `image/gif`
* [ ] Megjelenési értesítés (S2S) : Az összeállított szerver-megjelenési URL; **GET** vagy **POST** kérés közvetlenül a(z) Epsilon követési gazdagépre 204 No Content választ ad vissza.
* [ ] Kattintáskövetés (C2S) : Az összeállított `client.clickRedirect` URL 302-es átirányítást ad a megfelelő célra, vagy az összeállított `client.clickEvent` 204 No Content választ ad vissza (amelyik opciót a folyamata használja - nem mindkettőt)
* [ ] Kattintási értesítés (S2S) : A **GET** vagy **POST** kérés közvetlenül az összeállított szerver URL-re 204 No Content választ ad vissza
* [ ] Kosárba helyezés (C2S) : Az összeállított `client.addToCartEvent` esemény-beaconként lefutva 204 No Content választ ad vissza
* [ ] Kosárba helyezés (S2S) : Az összeállított `server.addToCartEvent` közvetlenül a követési gazdagépre meghívva 204 No Content választ ad vissza
**Infrastruktúra és adatvédelem**
* [ ] Reverse proxy : A C2S követési kérések át vannak irányítva az Ön domainjén keresztül; az S2S nem a proxyn keresztül van elküldve
* [ ] Fejlécek : `RP-Host`, `X-Forwarded-For`, `X-Forwarded-Request-Path`, `Referer` jelen vannak a proxizott kérésekben
* [ ] Adatvédelem : Egyetlen paraméterben vagy URL-ben sem szerepel semmilyen PII (személyes azonosításra alkalmas adat)
* [ ] HTTPS : Minden kérés biztonságos kapcsolatot használ
* [ ] Termékoldalak : Az oldalak megfelelően jelennek meg a kattintási átirányítás után
### Ajánlott eszközök
* Böngésző fejlesztői eszközök: Network (Hálózat) fül a pixelletéscsék és átirányítások vizsgálatához.
* Fiddler vagy Charles Proxy: A reverse proxy viselkedésének és a fejlécek továbbításának vizsgálatához.
### Hibaelhárítás
| Probléma | Ellenőrzés |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A pixelek betöltése sikertelen | Ellenőrizze a DNS/SSL beállításokat, erősítse meg a proxy útvonal-átírást (path rewrite), és ellenőrizze a(z) Epsilon követési gazdagép elérhetőségét. |
| Az átirányítások nem továbbítódnak | Gondoskodjon róla, hogy a(z) `{RURL}` URL-kódolt legyen, és ellenőrizze, hogy a proxy megőrzi-e a lekérdezési karakterláncot (query string). |
| Az API nem ad vissza tartalmat | Ellenőrizze, hogy a(z) `catalogId` és a(z) `urlSlug` egyezzen egy aktív márkoldal-kampánnyal. |
| A követést blokkolja egy hirdetésblokkoló | Erősítse meg, hogy a reverse proxy be van állítva – a követésnek az Ön domainjén keresztül kell átirányítódnia. |
| A kosárba helyezés nincs követve | Gondoskodjon róla, hogy a kosárba helyezési művelet után lefutassa az összeállított kliens- vagy szerveroldali kosárba helyezési URL-t. |
| Az oldal hibát dob egyes márkoldalak betöltésekor | Valószínűleg a doc/example mezőket mindig kötelezőként kezeli. Naplózza a nyers modul JSON-t, adjon hozzá védelmet az opcionális kulcsokhoz és a hiányzó követésekhez, és erősítse meg, hogy a sablon engedélyezi vagy letiltja azokat a mezőket. |
| A téma színei nem alkalmazkodnak megfelelően | Ellenőrizze, hogy a(z) `null` témamezők visszatérnek-e a stílusterv alapértelmezett értékeire, ahelyett, hogy szó szerinti null értékként vagy üres karakterláncként jelennének meg. |
## Szójjegyzék
**Alapvető kifejezések a márkoldalak integrációjához**
| Kifejezés | Meghatározás | Példa |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| API-kulcs | Az Ön hitelesítési adata a következőhöz: Epsilon szolgáltatások | `Basic abc123xyz...` |
| Márkaoldal | Egy márkázott érkezési oldal élmény az Ön webhelyén | yoursite.com/brands/nike |
| C2S nyomon követés | Ügyfél-szerver közötti: böngészőalapú nyomon követés. A megtekintések 1x1-es pixeleket használanak; a kattintások 302-es átirányítást vagy eseményjelzőt (beacont) használnak; a kosárhoz adás eseményjelzőt (beacont) használ. | `
, navigator.sendBeacon(clickEvent)` |
| S2S nyomon követés | Szerverek közötti: háttérrendszerbeli nyomon követés (GET vagy POST az összeállított nyomon követési URL-ekre) | Az Ön szervere → Epsilon szerver |
| Tartalommodul | Egyedi tartalomblokkok (főbanner, szöveg, termékek stb.) | Főbanner, termékháló |
| Modulcímkék | Opcionális karakterlánc-címkék egy modulon (pl. `["header"]`), amelyeket a sablonban állítanak be. A kereskedők az elrendezés átirányítására, elemzésre vagy a saját komponenseikhez való hozzárendelésre használják. Üres állapotban kimarad a válaszból. | `"tags": ["header"]` |
| Téma | Sikeres API-válasz esetén mindig jelen van: beágyazott `colors` (háttér + hét szövegfunkció) és `buttons` (`primary` / `secondary` ezzel: `background` és a(z) `text`). Minden témaszínmező megadása kötelező (hex6). Lásd: [Téma objektum](/retail-media-interface/integration/hu/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md#theme-object). | "theme": { "colors": { ... }, "buttons": { ... } } |
| Megtekintés (Impression) | Amikor egy felhasználó megtekint egy márkaoldalt | Oldallekérés = 1 megtekintés |
| Kattintás | Amikor a felhasználó a márkaoldal tartalmára kattint | CTA gombra való kattintás |
| Konverzió | Amikor a felhasználó egy terméket a kosárba helyez a márkaoldalról | Kosárba helyezési művelet |
| Reverse proxy | A nyomon követést az Ön tartományán (domainjén) keresztül irányítja a hirdetésblokkolók elkerülése érdekében | `yoursite.com/epsilon/` → Epsilon |
| URL-azonosító (Slug) | A márka azonosítója az URL-útvonalban | `nike` in `/brands/nike` |
| Katalógus-azonosító | Az Ön egyedi termékkatalógus-azonosítója | Biztosította: Epsilon |
| Makró | Válaszbéli helyőrzők (`{TS}`, `{RURL}`) in `tracking.params` amelyeket Ön futásidőben helyettesít; | `{TS} → 1737485823910` |
| IAB TCF | Interactive Advertising Bureau Transparency & Consent Framework | GDPR-megfelelőségi szabvány |
| PII | Személyes azonosításra alkalmas adatok (ezt soha ne küldje el!) | E-mail, telefonszám, valódi név |
| Gyorsítótár-kiürítés (Cache-busting) | Időbélyegek hozzáadása a gyorsítótárazott válaszok megelőzésére | `?ts=1737485823910` |
### Műszaki betűszavak
| Betűszó | Teljes kifejezés | Mit jelent |
| --------------------------- | ------------------------------------------------------------------- | ------------------------------------------ |
| RMN | Retail Media Hálózat | Epsilonhirdetési platformja |
| CTA (Cselekvésre ösztönzés) | Call-to-Action (Cselekvésre ösztönzés) | Kattintható gombok/hivatkozások |
| JSON | JavaScript Object Notation | Adatformátum az API-kérésekhez/válaszokhoz |
| HTTPS | HTTP Secure | Titkosított webes protokoll |
| GDPR | General Data Protection Regulation (Általános adatvédelmi rendelet) | EU adatvédelmi jogszabály |
| TLS | Transport Layer Security | Titkosítási protokoll |
| DNS | Domain Name System (Tartománynév-rendszer) | Internetes címrendszer |
| SSL | Secure Sockets Layer | Titkosítási protokoll |
| RFC | Request for Comments | Műszaki szabványdokumentumok |
---
# 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/brand-pages/brand-page-retailer-integration-guide/validation-troubleshooting.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.