> 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/overview-1.md). # Áttekintés ## Melyek a márkastratégiai oldalak (Brand Pages)? Márkastratégiai oldalak olyan testreszabott érkezési oldalak, amelyek az Ön webhelyén találhatók, és specifikus márkatartalmakat mutatnak be. Az Ön domainjén vannak hosztolva, és az Ön UI-komponenseivel jelennek meg. A Brand Page-ek kezelése a standard hirdetési kampányoktól külön történik a Epsilon platformon.\ Bár hasonló létrehozási és felülvizsgálati munkafolyamatot használnak, a kereskedő oldalán megjelenő márkás érkezési oldali élményeket képviselik, nem pedig hagyományos hirdetéseket. **Példa:** Egy felhasználó ellátogat a `yoursite.com/brands/nike` oldalra, és egy Nike márkájú oldalt lát Nike termékekkel, de az kinézetre és érzetre a webhely részének tűnik. ## Mit fog megépíteni Kereskedelmi mérnökként a következőket fogja tenni: * Útvonal hozzáadása a brand page URL-ekhez (például, `/brands/{slug}`). {% hint style="info" %} A kereskedőknek nem kötelező minden egyes Brand Page-hez külön URL-t biztosítaniuk. Az URL-eket a platform automatikusan kezeli. A Brand Page alap URL-jét (beleértve az előtagot is) azonban be kell állítani az onboarding során (például a Retailer Style Guide-ban). Ha a teljes URL vagy az előtag nincs megadva, a Brand Page URL-je nem fog megjelenni a beállítási oldalon. {% endhint %} * Hívja meg a Brand Pages API-t a kinyert slug használatával. * Jelenítse meg a visszaküldött tartalommodulokat. * Valósítsa meg a megtekintés-, kattintás- és kosárba helyezés (add-to-cart) követést. * Konfiguráljon egy reverse proxyt a belső (first-party) követéshez. {% hint style="info" %} Ez a lépés csak a kliensoldali követéshez szükséges. {% endhint %} ### Az Ön felelősségei vs. Epsilon's | Ön kezeli | Epsilon Biztosítja | | ----------------------------------------------------- | --------------------------------- | | ✅ API-integráció a tartalom lekéréséhez | ✅ Brand page tartalom és sablonok | | ✅ Tartalom megjelenítése az Ön oldalán | ✅ Követési infrastruktúra | | ✅ Reverse proxy beállítása | ✅ Analitika és jelentéskészítés | | ✅ Az Ön stílusútmutatójának (style guide) biztosítása | ✅ Kampánykezelő eszközök | | ✅ Tesztelés és validálás | ✅ Technikai támogatás | ## Hogyan működnek a Brand Page-ek ### Folyamat az elejétől a végéig {% hint style="info" %} A brand page tartalma a Epsilon felületén állítható be és tekinthető meg előnézetben. A kereskedők kizárólag API-kon keresztül integrálják a Brand Page-eket, és ők felelősek a végleges élmény megjelenítéséért a webhelyeiken. {% endhint %} A felülvizsgálati folyamat során a kereskedők a jóváhagyás előtt előnézetben megtekinthetik a beállított brand page tartalmat. ### Sablonok és modulok Az onboarding során a Epsilon együttműködik az Ön csapatával olyan sablonok létrehozásában, amelyek meghatározzák: * A elérhető tartalommodulokat (például hero, termékrács, szöveg és képek), a felületen konfigurálható modulnevekkel, hogy illeszkedjenek az Ön kereskedelmi taxonómiájához. * Az egyes modulokra vonatkozó korlátozásokat (karakterkorlátok, képméretek stb.). * A márkájára vonatkozó irányelvekhez illeszkedő stílust. A márkák kiválasztanak egy sablont a kampányuk létrehozásakor, majd feltöltik a tartalmat ezen korlátozásokon belül. {% hint style="info" %} A Brand Pages API tartalommodulokat és követési URL-eket ad vissza. A kereskedők felelősek a stílusok alkalmazásáért a saját UI-komponenseik és tervezési rendszerük használatával. {% endhint %} **Példák** A következő példák azt szemléltetik, hogyan tölthetik fel a márkák a gyakori tartalommodulokat egy Brand Page létrehozásakor. Ezek csak mintabemenetek, és a kiválasztott sablon, valamint a kampány céljai alapján módosíthatók. **HERO modul** * **Címsor:** Fedezze fel a legújabb nyári kollekciót * **Alcím:** Friss stílusok minden alkalomra * **CTA:** Vásárlás most **SZÖVEG modul** Fedezze fel a kényelemre, stílusra és teljesítményre tervezett legújabb érkezőinket – tökéletes a mindennapi viselethez. **KÉP modul** * Képaláírás:\*\* Az új érkezők már elérhetők * **Alt szöveg:** Modell a nyári kollekciót viselve * URL: **PRODUCT\_GRID modul** Használjon termékrácsot a legkelendőbb vagy szezonális termékek bemutatására, valamint az elkötelezettség és a konverziók növelésére. #### Modulkonfiguráció: | Modul | Leírás | Konfigurálható elemek (Összegzés) | | -------------- | ----------------------------------------------------- | --------------------------------------------------- | | HERO | Teljes szélességű banner képpel, címsorral és CTA-val | Címsor, alcím, CTA, kép, átfedés (overlay) | | PRODUCT\_GRID | Termékek rácsa vagy körhintája (carousel) | Termékek, szekció címe, leírás, CTA | | TEXT | Szöveges tartalomblokk (címsor, törzsszöveg) | Szövegmezők, CTA | | IMAGE | Egyetlen kép tetszőleges hivatkozással | Kép, képaláírás, alt szöveg, opcionális hivatkozás | | IMAGE\_GALLERY | Több kép rácsos elrendezésben | Képek, képaláírások, alt szöveg, szakaszcím, leírás | | FILTER\_MENU | Vízszintes szűrőfülek a termékrácsokhoz | Szűrőcímkék és rendezés | | SPLIT\_LAYOUT | Többoszlopos elrendezés beágyazott modulokkal | Elrendezési struktúra és beágyazott modulok | {% hint style="info" %} Minden konfigurálható elem beállítható kötelezőként, opcionálisként (engedélyezett) vagy letiltottként, a modultól és a kiskereskedői követelményektől függően. Egyes mezők kényszeríthetnek maximális karakterszám-korlátot is, ha kötelezőként vagy engedélyezettként vannak megjelölve. {% endhint %} ### Modulcímkék A sablonok tartalmazhatnak egy opcionális `tags` mezőt mindegyik modulon — rövid szöveges címkék listáját (pl. `["header"]`), amelyeket az integrációja felhasználhat elrendezési döntésekhez, analitikához vagy a modulok saját komponenseihez történő leképezéséhez. #### Hogyan működnek a címkék az API-válaszban * Ha egy modul rendelkezik címkékkel, azok egy `tags` tömbként jelennek meg a megfelelő elemen itt: `contentData`. * Ha egy modul nem rendelkezik címkékkel, a `tags` tulajdonság teljesen hiányzik a válaszból - nem fog megjelenni mint `"tags": []`. * Kezelje a hiányzó `tags` mezőt ugyanúgy, mint a "nincs címke" esetet - ne dobjon hibát, ha hiányzik. * A címkék a beágyazott modulokon is támogatottak itt: `SPLIT_LAYOUT` - nem csak a gyökér split modulon. {% hint style="info" %} Fontos A címkék a kiskereskedő és az integrációs csapatuk által elfogadott nem átlátszó címkék. Nem kapcsolódnak hirdetéskövetési címkékhez vagy bármilyen más rendszerhez — a félreértések elkerülése érdekében mindig referencia-értékként hivatkozzon ezekre úgy, mint *"modulcímkék"* vagy *"márkaoldal-modulcímkék"*. {% endhint %} Példa válaszmodul címkével ```json { "id": "image-1", "contentType": "IMAGE", "order": 1, "tags": ["header"], "imageUrl": "https://example.com/images/banner.jpg" } ``` **Példa válaszmodul címke nélkül (a tags tulajdonság elhagyva):** ```json { "id": "image-2", "contentType": "IMAGE", "order": 2, "imageUrl": "https://example.com/images/promo.jpg" } ``` #### Mit jelent ez az API-válasz szempontjából A `POST /ads/v3/brand-pages` válasz ugyanezeket a szabályokat tükrözi: egy modultípus csak akkor jelenik meg itt: `contentData` amikor az az élő sablon része, és a márkaoldal konfigurált tartalmat ahhoz a modulhoz. A modulon belüli mezők hiányozhatnak a JSON-ból, `null`, vagy üresek lehetnek, ha a sablon opcionálisnak vagy letiltottnak jelöli azokat, vagy ha a márka beállítatlanul hagyja őket - ez várható, és nem jelent hibás adatterhelést. A megjelenítést opcionális típusokkal és biztonságos hozzáférőkkel valósítsa meg - például csak akkor jelenítsen meg egy CTA-blokkot, ha a `ctaText` és egy navigációs cél is jelen van; rejtse el a hero médiát, ha a `mediaUrl`hiányzik. `trackers`az oldalszinten vagy egy csomóponton elhagyható, ha nincs nyomon követhető interakció. Csak akkor állítson össze URL-eket, ha rendelkezik a megfelelő sablonkulccsal innen: `trackingTypes` és a megfelelő `trackers.`\`.params`, ha az API biztosítja. --- # 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/overview-1.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.