> 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/sk/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.md). # API pre stránku značky ## Smerovanie URL Keď používateľ prejde na URL adresu značkovej stránky, vaša aplikácia extrahuje `urlSlug` zo cesty a odošle ho do API na zobrazovanie reklám. Štruktúra URL: `` | Segment | Zdroj | Príklad | | ------------- | --------------------------------------------------------- | ------------------ | | `your-domain` | Vaša lokalita | `www.retailer.com` | | `prefix` | Nakonfigurované počas onboardingu (napr. značky, stránky) | `brands` | | `urlSlug` | Extrahované počas behu z cesty URL | `adidas` | **Príklad** Keď používateľ navštívi: `` 1. Vaša aplikácia sa zhoduje s `/brands/*` trasa. 2. Extrahuje `adidas`ako urlSlug. 3. Volá `POST /ads/v3/brand-pages` na vašom pridelenom reklamnom hostiteľovi s `"urlSlug": "adidas"` a vaším `catalogId`. 4. Rendruje vrátené obsahové moduly na stránke. ### Pravidlá validácie slugov Značky vytvárajú slugy podľa týchto obmedzení: * **Znaky:** Malé písmená (a–z), čísla (0–9), spojovníky (-) a podčiarkovníky (\_). * **Dĺžka:** Minimálne 3 znaky, maximálne 100 znakov. * **Unikátnosť:** Musí byť unikátny v rámci katalógu predajcu (`catalogId`). {% hint style="info" %} V súčasnosti unikátnosť slugu neberie do úvahy časové rozsahy kampane. {% endhint %} * **Nemennosť:** Nespravovateľný po spustení kampane značkovej stránky. * **Formát:** Žiadne začiatočné ani koncové spojovníky (napríklad `-adidas`or `adidas-` nie sú povolené). ## Cachovanie * Necachujte odpovede z API na zobrazovanie reklám. Požiadavky vždy posielajte priamo do Epsilon API, aby sa zabezpečilo: * Doručenie správnej kampane značkovej stránky (kampane môžu byť pozastavené, aktualizované alebo vymenené). * Sledovacie URL adresy obsahujú čerstvé identifikátory pre každú požiadavku na presnú atribúciu. * Počty impresií zostávajú presné a nie sú ovplyvnené zastaranými cachovanými odpoveďami. **SEO hľadisko**: Predajcovia sa môžu rozhodnúť povoliť indexovanie značkových stránok vyhľadávačmi. Indexovanie obsahu značkovej stránky môže zlepšiť viditeľnosť v organickom vyhľadávaní, keďže všetok text na stránke je pre vyhľadávače objaviteľný. ## Nastavenie reverzného proxy ### Prečo potrebujete reverzný proxy **Problém**: Blokovače reklám a nástroje na ochranu súkromia často blokujú požiadavky na sledovanie odoslané priamo na reklamné domény. **Riešenie**: Smerujte všetky požiadavky na sledovanie cez vlastnú doménu, aby sa javili ako prevádzka prvej strany. ```apache ❌ Blocked: user-browser → [third-party-tracking-domain] ✅ Works: user-browser → yoursite.com/[custom-path] → [third-party-tracking-domain] ``` * Nahraďte `[third-party-tracking-domain]` skutočným Epsilon koncovým bodom na sledovanie poskytnutým počas onboardingu. * Nahraďte `[custom-path]` neutrálnou, unikátnou cestou (napr., `/media-proxy`, `/assets-endpoint`, alebo akýmkoľvek nereklamným výrazom). Reverzný proxy je potrebný pre sledovanie C2S (prehliadač). Nevzťahuje sa na volania S2S, ktoré sa musia odosielať priamo na Epsilon hostiteľa sledovania [(pozrite Sledovanie – Server-to-Server (S2S](/retail-media-interface/integration/sk/brand-pages/brand-page-retailer-integration-guide/tracking-attribution.md#tracking--servertoserver-s2s))). ### Konfigurácia Vaša lokalita musí hostovať reverzný proxy pod cestou, ako je `https://www.retailer.com/{proxyPath}/`. Požiadavky na sledovanie v prehliadači (C2S) smerované na vašu doménu na danej ceste sa preposielajú na vášho regionálneho hostiteľa sledovania ([pozrite Ad Serving API](#ad-serving-api)). Sledovanie server-to-server nesmie používať tento proxy. **Správanie:** * Prijímať požiadavky pod `/epsilon/` * Preposlať na `https://[region]-tracking.rmn.dotomi.com/` (pozrite [Ad Serving API](#ad-serving-api) pre `[region]`) * Zachovať príponu cesty k súboru * Preposlať požadované hlavičky HTTP * Vynútiť HTTPS (TLS 1.2+) ### Požadované hlavičky | Hlavička | Popis | | -------------------------- | --------------------------------------------------------- | | `RP-Host` | Váš názov hostiteľa prijímajúci požiadavku na sledovanie. | | `X-Forwarded-For` | Skutočná IP adresa klienta. | | `X-Forwarded-Request-Path` | Cesta s prefixom proxy (napr. /epsilon). | | `Referer` | Stránka, kde sa spustil pixel. | ### Príklad pre Apache ```apache LoadModule ssl_module modules/mod_ssl.so LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so SSLProxyEngine on RequestHeader add "X-Forwarded-Request-Path" "/epsilon" RequestHeader add "RP-Host" "%{HTTP_HOST}s" RequestHeader add "Referer" "%{HTTP_REFERER}s" ProxyPass "/epsilon" "https://[region]-tracking.rmn.dotomi.com" ProxyPassReverse "/epsilon" "https://[region]-tracking.rmn.dotomi.com/" ``` ### Príklad pre NGINX ```apache server { server_name www.retailer.com; location /epsilon/ { proxy_ssl_server_name on; rewrite ^/epsilon/(.*) /$1 break; proxy_pass https://[region]-tracking.rmn.dotomi.com; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Server $server_name; proxy_set_header RP-Host $host; proxy_set_header X-Forwarded-Request-Path "/epsilon"; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header Referer $http_referer; } } ``` ## Ad Serving API Epsilon doručuje stránky značky z hostiteľov RMN na `*.rmn.dotomi.com`. Nahraďte `[region]` segmentom Epsilon priraďuje pre vaše nasadenie. Rozhranie API pre reklamy používa `https://[region]-ads.rmn.dotomi.com`; zatiaľ čo koncové body sledovania (pixely zobrazení, presmerovania kliknutí a URL adries O2O oznámení) používajú `https://[region]-tracking.rmn.dotomi.com` s rovnakou `[region]` hodnotou. V niektorých nastaveniach základné názvy hostiteľov `ads.rmn.dotomi.com` a `tracking.rmn.dotomi.com` môžu byť použité. Epsilon potvrdí príslušné názvy hostiteľov pre vaše prostredie. ### Koncový bod ``` POST https://[region]-ads.rmn.dotomi.com/ads/v3/brand-pages Content-Type: application/json Authorization: Basic ``` ### Telo požiadavky ``` { "id": "req-adidas-12345", "catalogId": "test-catalog-adidas", "urlSlug": "adidas", "site": { "domain": "www.retailer.com", "page": "https://www.retailer.com/brand/adidas", "ref": "https://www.retailer.com/search?q=shoes" }, "device": { "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 ...", "ip": "192.168.1.100", "language": "en-US", "devicetype": 2, "os": "macOS", "geo": { "country": "USA", "region": "CA", "city": "San Francisco", "zip": "94105" } }, "user": { "sessionId": "sess-abc123xyz", "customerId": "cust-789012", "dtmId": "dtm-456def" }, "regs": { "gdpr": 1, "consent": "COwJqZAOwJqZAOAAAAENAXCAAAAAAAAAAAAAABpoAIAAAEpgAIAAAg1AAAICAIAAAEA" } } ``` Hodnoty `regs` vyššie ilustrujú návštevnosť podliehajúcu GDPR:\ `gdpr` is `1`a `consent`je **syntetický reťazec súhlasu IAB TCF v2** (iba správny tvar a množina znakov). V produkčných prostrediach: * Nastavte `gdpr`na základe vašich geografických a právnych pravidiel. * Odovzdajte **aktuálny TC reťazec** z vášho CMP (napríklad prostredníctvom `_ _tcfapi` `getTCData`→ `tcString`). Pre požiadavky, ktoré nepodliehajú GDPR, použite `"gdpr": 0` a vynechajte `consent`alebo použite `""` `iabConsentString` na udalostiach sledovania: Každá vyplnená pozícia sledovača (`trackers.impression`, `trackers.click`, `trackers.addToCart`) obsahuje `params.iabConsentString`. Keď poskytnete `regs.consent` v požiadavke, táto hodnota je doslovný TC reťazec. Keď ste vynechali `regs.consent`, táto hodnota je zástupný makro symbol {TCF} - pred odoslaním akejkoľvek požiadavky na sledovanie nahraďte v čase spustenia aktuálny reťazec TCF v2 z vášho CMP (napríklad prostredníctvom `__tcfapi getTCData` → `tcString`). ### Definície polí požiadavky | Pole | Typ | Povinné | Popis | | -------------------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | Áno | Unikátny identifikátor požiadavky (vygenerovaný predajcom) | | `catalogId` | string | Áno | ID katalógu produktov predajcu (poskytnuté Epsilon) | | `urlSlug` | string | Áno | Identifikátor URL adresy stránky značky (napr. adidas) | | site | | | | | `site.domain` | string | Áno | Doména webovej lokality predajcu | | `site.page` | string | No | Úplná URL adresa, kde sa zobrazuje stránka značky | | `site.ref` | string | No | URL adresa odkazujúcej stránky (odkiaľ používateľ prešiel) | | device | | | | | `device.ua` | string | Áno | Reťazec user agenta | | `device.ip` | string | No | IP adresa klienta | | `device.language` | string | No | Jazyk prehliadača (napr. en-US) | | `device.devicetype` | integer | No | 1=mobil, 2=pc, 4=telefón, 5=tablet | | `device.os` | string | No | Operačný systém | | `device.geo.country` | string | No | Kód krajiny ISO 3166-1 alpha-3 (napr. USA, GBR) | | `device.geo.region` | string | No | Štát alebo región | | `device.geo.city` | string | No | Mesto | | `device.geo.zip` | string | No | Poštové smerovacie číslo / ZIP code | | user | | | | | `user.sessionId` | string | No | Identifikátor relácie predajcu (bez PII) | | `user.customerId` | string | No | Identifikátor zákazníka predajcu (bez PII) | | `user.dtmId` | string | No | Identifikátor sledovania | | regs | | | | | `regs.gdpr` | integer | No | `0` = GDPR sa neuplatňuje, `1` = Uplatňuje sa GDPR (podľa signalizácie v štýle OpenRTB) | | `regs.consent` | string | No | Súhlasový reťazec IAB TCF **v2** (`tcString` z CMP). Použite len vtedy, keď `gdpr` is `1` a máte platný reťazec; v opačnom prípade vynechajte alebo`""` | {% hint style="danger" %} **Dôležité** Nižšie uvedený JSON je reprezentatívnym a pomerne úplným príkladom. Živé odpovede sú často redšie pre `contentData` moduly. Generujte štruktúry, ktoré nepredpokladajú, že každý tu zobrazený kľúč je vždy prítomný pre každý `contentType` alebo značkovú stránku.\ Hodnoty `theme` sa líši: pri úspešnej odpovedi je vždy prítomný a používa zoskupenú štruktúru opísanú v sekcii Objekt témy (`colors`a `buttons` plne naplnené - požadované hex6 reťazce pre každú cestu; žiadne `nulls` vo vnútri `theme`). {% endhint %} ### Telo odpovede ``` { "realizedAdId": "brandpage_djogXfHSYGZOZnnkzEKunWvdNYEKABIAGgwIwIPjzAYQ3byasAE=", "brandPageTemplateId": "6e9690ef-81d1-4fad-b2ce-749e22cceb10", "catalogId": "test-catalog-adidas", "urlSlug": "adidas", "theme": { "colors": { "background": "#F5F5F5", "text": { "heading": "#1a1a1a", "subheading": "#333333", "body": "#5f6368", "caption": "#9aa0a6", "link": "#1a73e8", "tagline": "#5f6368", "lines": "#e0e0e0" } }, "buttons": { "primary": { "background": "#ff6600", "text": "#FFFFFF" }, "secondary": { "background": "#FFFFFF", "text": "#ff6600" } } }, "trackers": { "impression": { "type": "impression", "params": { "ts": "{TS}", "iabConsentString": "{TCF}" } } }, "trackingTypes": { "impression": ["client.impressionPixelUrls", "server.impressionEvent"], "productClick": ["client.clickRedirect", "client.clickEvent", "server.clickEvent"], "productAddToCart": ["client.addToCartEvent", "server.addToCartEvent"], "link": ["client.clickRedirect", "client.clickEvent", "server.clickEvent"], "interaction": ["client.clickEvent", "server.clickEvent"] }, "trackingTemplates": { "client": { "clickRedirect": "/tracking/v3/click/redirect/brandpage_djog...?catalogId=test-catalog-adidas&...", "clickEvent": "/tracking/v3/event/click/brandpage_djog...?catalogId=test-catalog-adidas&...", "addToCartEvent": "/tracking/v3/event/add-to-cart/brandpage_djog...?catalogId=test-catalog-adidas&...", "impressionPixelUrls": [ "/tracking/v3/impression/pixel/brandpage_djog...?catalogId=test-catalog-adidas&..." ] }, "server": { "clickEvent": "https://[region]-tracking.rmn.dotomi.com/tracking/v3/event/click/brandpage_djog...?...", "addToCartEvent": "https://[region]-tracking.rmn.dotomi.com/tracking/v3/event/add-to-cart/brandpage_djog...?...", "impressionEvent": "https://[region]-tracking.rmn.dotomi.com/tracking/v3/event/impression/brandpage_djog...?..." } }, "contentData": [ { "id": "hero-1", "brandPageModuleTemplateId": "hero-template-1", "contentType": "HERO", "order": 1, "tags": ["header"], "mediaUrl": "https://example.com/images/adidas-hero.jpg", "headline": "Impossible Is Nothing", "subheadline": "Spring Collection", "ctaText": "Explore", "ctaLink": "https://example.com/adidas/explore", "trackers": { "click": { "type": "link", "params": { "modId": "hero-1", "rurl": "https%3A%2F%2Fexample.com%2Fadidas%2Fexplore", "ts": "{TS}", "iabConsentString": "{TCF}" } } } }, { "id": "text-1", "brandPageModuleTemplateId": "text-template-1", "contentType": "TEXT", "order": 2, "text": "Discover the latest Adidas collection featuring innovative designs and sustainable materials." // (No trackers for TEXT module, as it has no interactive elements) } ] } ``` #### Definície polí odpovede | Pole | Typ | Popis | | ----------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `realizedAdId` | string | Unikátny identifikátor reklamy pre toto zobrazenie značkovej stránky. Používa sa vo všetkých cestách šablón sledovania. | | `brandPageTemplateId` | string | ID šablóny použité pre túto značkovú stránku | | `catalogId` | string | ID katalógu predajcu (prevzaté po požiadavke) | | `urlSlug` | string | URL slug značkovej stránky (prevzaté po požiadavke) | | `theme` | Objekt |

Vždy prítomný pri úspechu. Štýlovanie na úrovni stránky od značky: zoskupené colors (pozadie + text úlohy) a buttons(primary/ secondary, každé s backgrounda text). Pozrite si Objekt témy sekcia.
Telo odpovede sa vracia tak, ako ho serializoval reklamný server (žiadne medzipriestorové úpravy tvaru theme)

| | `trackers` | objekt | Kontejner sledovania na úrovni stránky. `trackers.impression` obsahuje pozíciu zobrazenia stránky: `type: "impression"` a `params` vrátane minimálne `ts: "`{TS}`"` a `iabConsentString`. | | `trackingTypes` | objekt | Mapa typu sledovania na príslušné kľúče šablón. Typy: `impression`, `productClick`, `productAddToCart`, `link`, `interaction`. Každá hodnota je pole `client.*/` `server.*` kľúčov od `trackingTemplates`. (pozrite [Ako zostaviť sledovaciu URL](/retail-media-interface/integration/sk/brand-pages/brand-page-retailer-integration-guide/tracking-attribution.md#how-to-compose-a-tracking-url)). | | `trackingTemplates.client` | objekt | **Relatívne** cesty URL a reťazce dopytu na sledovanie v prehliadači (C2S) – predraďte základnú URL adresu svojho reverzného proxy (`BASEURL`). | | `trackingTemplates.server` | objekt | Šablóny **absolútnych** URL na Epsilon hostiteľovi sledovania pre S2S. | | `contentData[]` | pole | Usporiadané pole obsahových modulov na vykreslenie | | `contentData[].id` | string | ID inštancie modulu | | `contentData[].brandPageModuleTemplateId` | string | ID šablóny modulu | | `contentData[].contentType` | string | Typ modulu: HERO, TEXT, FILTER\_MENU, PRODUCT\_GRID, IMAGE, IMAGE\_GALLERY, SPLIT\_LAYOUT | | `contentData[].order` | integer | Poradie vykresľovania (vzostupne) | | `contentData[].tags` | pole reťazcov | Voliteľné. Značky modulu nastavené predajcom v šablóne. Ak nie sú nastavené žiadne značky, úplne sa vynechá – chýbajúce hodnoty považujte za „žiadne značky“. Prítomné aj v vorených moduloch v rámci SPLIT\_LAYOUT. | | `contentData[].trackers` | objekt | Keď je prítomný, sledovací kontajner pre jednotlivé uzly. `trackers.click` pre udalosti kliknutia na odkaz/interakciu/produkt; `trackers.addToCart` pre pridanie produktu do košíka (obsahuje makrá {QTY} a {CONVERSION\_VALUE}). Môže sa vynechať, ak nie je čo sledovať. | ### Objekt témy Každá úspešná odpoveď Brand Page API obsahuje `theme` objekt: farby na úrovni stránky a štýly tlačidiel nakonfigurované pre značku. Použite tieto hodnoty priykresľovaní (napríklad ich namapujte na vlastné vlastnosti CSS alebo vaše dizajnové tokeny). JSON je vygenerovaný reklamným serverom a doručený v vrátenom stave – neexistuje žiadny samostatný krok, ktorý by prepisoval `theme`. **Formát farieb:** Hodnoty farieb témy sa riadia zmluvou platformy z predchádzajúceho kroku (kampaň/konfigurácia): každá hodnota je `#` nasledovaný šiestimi hexadecimálnymi číslicami (hex6), napríklad `#ff6600`. Neočakávajte iné formáty (skrátené hex3, osomciferné hex, `rgb()`, `hsl()`ani pomenované farby). Reklamný server pri doručovaní opätovne neoveruje formát farieb; predchádzajúci krok dodáva hex6 pre každé pole témy. #### Štruktúra a sémantika * `theme` obsahuje `colors` a `buttons` – obidve sú povinné, kedykoľvek je `theme` prítomné. * `colors.background` – pozadie stránky alebo plátna (požadovaný hex6). * `colors.text` – sedem povinných úloh: `heading`, `subheading`, `body`, `caption`, `link`, `tagline`, `lines` (čiary/oddeľovače). Každá hodnota je hex6 reťazec. * `buttons.primary` a `buttons.secondary` - každé vyžaduje `background` a `text` (farby výplne a textu tlačidla), každá ako hex6 reťazec. * Každá cesta v tabuľke odkazov na polia nižšie je povinná. Neexistujú žiadne voliteľné pozície pre farby ani `null` hodnoty vnútri `theme`. (Riedke alebo vynechané polia sa uplatňujú elsewhere, napríklad v `contentData` moduloch.) * Hodnoty `theme` je na úrovni stránky - všetky moduly na Stránke značky zdieľajú rovnakú tému. #### Odkaz na polia Všetky cesty v tejto tabuľke sú povinné (nenulové hex6 reťazce). | Cesta | Popis | | ------------------------------------ | ---------------------------------- | | `theme.colors.background` | Pozadie stránky/maliarskeho plátna | | `theme.colors.text.heading` | Text nadpisu | | `theme.colors.text.subheading` | Text podnadpisu | | `theme.colors.text.body` | Text tela/odseku | | `theme.colors.text.caption` | Popisok/sekundárny text | | `theme.colors.text.link` | Text odkazu | | `theme.colors.text.tagline` | Text sloganu | | `theme.colors.text.lines` | Čiary a oddeľovače | | `theme.buttons.primary.background` | Výplň hlavného CTA tlačidla | | `theme.buttons.primary.text` | Text hlavného CTA tlačidla | | `theme.buttons.secondary.background` | Výplň sekundárneho tlačidla | | `theme.buttons.secondary.text` | Text sekundárneho tlačidla | Príklad - (`theme`iba objekt): ```json "theme": { "colors": { "background": "#F5F5F5", "text": { "heading": "#1a1a1a", "subheading": "#333333", "body": "#5f6368", "caption": "#9aa0a6", "link": "#1a73e8", "tagline": "#5f6368", "lines": "#e0e0e0" } }, "buttons": { "primary": { "background": "#ff6600", "text": "#FFFFFF" }, "secondary": { "background": "#FFFFFF", "text": "#ff6600" } } } ``` #### Pre jednotlivé uzly `params`(typické kľúče) | Paramter | Keď sa používa | Popis | | ------------------ | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `modId` | Väčšina interaktívnych uzlov | Identifikátor obsahového modulu alebo riadku. | | `rurl` | `link` / `productClick`keď je presmerovanie potrebné | Cieľ s URL kódovaním | | `ts` | Väčšina udalostí | Časová pečiatka na zabránenie kesovaniu; nahraďte `"{TS}"`v čase spustenia. | | `iabConsentString` | Všetky pozície trackerov | Doslovný reťazec TC alebo makro {TCF} na nahradenie v čase spustenia | | `productCode` | `productClick` / `productAddToCart` | Identifikátor produktu. | | `sellerId` | `productClick` / `productAddToCart` (trhovisko) | Identifikátor predajcu. | | `qty` | `productAddToCart` | Absolútne množstvo tejto SKU v košíku v čase spustenia udalosti (nie delta). V čase spustenia nahraďte makro {QTY} | | `conVal` | `productAddToCart` | Absolútna peňažná hodnota týchto položiek: množstvo × jednotková cena, mínus všetky uplatnené zľavy. Nahraďte `{CONVERSION_VALUE}` makro v čase spustenia | #### Polia závislé od šablóny v `contentData` Okrem základných rozlišovacích prvkov na každom module (`id`, `brandPageModuleTemplateId`, `contentType`, `order`), prítomnosť vlastností nie je na Stránkach značky jednotná. Uprednostňujte detekciu funkcií - pred použitím skontrolujte každú vlastnosť - namiesto toho, aby ste každé pole v príkladoch považovali za povinné. API môže reprezentovať "žiadnu hodnotu" niekoľkými spôsobmi: | Vzor | Význam | Odporúčané spracovanie | | ----------------- | ------------------------------------------- | --------------------------------------------------------------------------------- | | Kľúč vynechaný | Vlastnosť v objekte JSON chýba | Považujte za chýbajúce; použite voliteľné reťazenie/predvolené hodnoty | | Explicitný `null` | Vlastnosť je prítomná s `null` hodnotou | Rovnaké ako vynechané, pokiaľ ich váš serializátor nerozlišuje | | Prázdny reťazec | `""` pre textové polia alebo polia typu URL | Obvykle skryte alebo preskočtevykresľovanie danej časti používateľského rozhrania | #### Príklady pre bežné typy modulov **Mriežka produktov:** Každý riadok produktov obsahuje `product` objekt (`catalogId`, `productCode`, `sellerId`), an `order` hodnotu a `trackers` keď je riadok sledovateľný. Riadky produktov poskytujú `click` pozíciu (`type: "productClick"`) a aj `addToCart`pozíciu (`type: "productAddToCart"`) keď je SKU pripísateľné. ``` { "product": { "catalogId": "550e8400-e29b-41d4-a716-446655440001", "productCode": "9221200653341", "sellerId": "2ae0aab9-44ce-40a0-b2b9-ae61681ad224" }, "order": 1, "trackers": { "click": { "type": "productClick", "params": { "modId": "grid-1", "productCode": "9221200653341", "sellerId": "2ae0aab9-44ce-40a0-b2b9-ae61681ad224", "rurl": "{RURL}", "ts": "{TS}", "iabConsentString": "{TCF}" } }, "addToCart": { "type": "productAddToCart", "params": { "modId": "grid-1", "productCode": "9221200653341", "sellerId": "2ae0aab9-44ce-40a0-b2b9-ae61681ad224", "rurl": "{RURL}", "ts": "{TS}", "qty": "{QTY}", "conVal": "{CONVERSION_VALUE}", "iabConsentString": "{TCF}" } } } } ``` **Hero:** Titulok, podtitulok, text a odkaz CTA, obrázok, prekrytie a `trackers.click` pre CTA, ak je k dispozícii. ``` { "contentType": "HERO", "tags": [ "header" ], "mediaUrl": "https://example.com/images/adidas-hero.jpg", "headline": "Impossible Is Nothing", "subheadline": "Spring Collection", "ctaText": "Explore", "ctaLink": "https://example.com/adidas/explore", "trackers": { "click": { "type": "link", "params": { "modId": "hero-1", "rurl": "https%3A%2F%2Fexample.com%2Fadidas%2Fexplore", "ts": "{TS}", "iabConsentString": "{TCF}" } } } } ``` **Galéria obrázkov:** Pole obrázkov, každý s URL, alternatívnym textom a popiskom. `trackers.click` pre obrázok iba vtedy, keď tento obrázok odkazuje von. ``` { "contentType": "IMAGE_GALLERY", "galleryImages": [ { "url": "https://example.com/images/recipe-spaghetti-bolognese.jpg", "alt": "Spaghetti Bolognese", "caption": "Spaghetti Bolognese", "trackers": { "click": { "type": "link", "params": { "modId": "gallery-1", "rurl": "https%3A%2F%2Fexample.com%2Frecipes%2Fspaghetti", "ts": "{TS}", "iabConsentString": "{TCF}" } } } } ] } ``` **Text:** Titulok a hlavný text, bez `trackers`pokiaľ sa na riadku nenachádza odkaz. ``` { "contentType": "TEXT", "text": "Explore our newest arrivals designed for comfort, style, and performance." } ``` **Obrázok:** Obsahuje URL obrázka, popisok, alternatívny text, voliteľný odkaz a `trackers.click` podrobnosti, keď je obrázok klikateľný ``` { "contentType": "IMAGE", "imageUrl": "https://example.com/images/model.jpg", "caption": "New arrivals now available", "alt": "Model wearing summer collection", "trackers": { "click": { "type": "link", "params": { "modId": "image-1", "rurl": "https%3A%2F%2Fexample.com%2Fnew-arrivals", "ts": "{TS}", "iabConsentString": "{TCF}" } } ``` --- # 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/sk/brand-pages/brand-page-retailer-integration-guide/brand-page-apis.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.