> 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/tracking-attribution.md). # Sledovanie a atribúcia ## Ako zostaviť sledovaciu URL Odpoveď poskytuje tri zdroje na skombinovanie: * Na úrovni stránky `trackers.impression`: napríklad zobrazenie stránky používa `type: "impression"` a `params` vrátane `ts` a `iabConsentString`. * Zdieľané `trackingTemplates`: jedna sada `client`(relatívna) a `server` (absolútna) šablón URL, ktoré už obsahujú parametre relácie a umiestnenia. * Na úrovni uzla `trackers.click` a/alebo `trackers.addToCart` na module, riadku alebo položke galérie: `type`+ `params` pre danú špecifickú udalosť (napríklad `modId`, `rurl`, `productCode`). ### Ktorá šablóna? Použite uzol `tracking.type` na vyhľadanie `trackingTypes.`. Toto definuje platné `client.*` a `server.*` kľúče pre danú interakciu (napríklad pre link: `client.clickRedirect`, `client.clickEvent`, `server.clickEvent)`. ### Klient vs. Server * Klient (`trackingTemplates.client.*`): Hodnoty sú relatívne cesty (vrátane reťazcov dotazu). Predraďte svoju základnú URL reverzného proxy (`BASEURL`). * Server (`trackingTemplates.server.`): Hodnoty sú absolútne šablóny URL na Epsilon hostiteľovi sledovania. Zostavte výslednú URL rovnakým spôsobom ako C2S: šablóna + `"&"` + `queryString(trackers.params)`. {% hint style="info" %} Nemeňte hostiteľa ani cestu šablóny a neposielajte S2S volania cez váš reverzný proxy. {% endhint %} ### Spracované príklady (pseudokód) #### C2S kliknutie pre HERO CTA ``` url = BASEURL + trackingTemplates.client.clickRedirect + "&" + queryString(trackers.click.params) ``` #### S2S zobrazenie stránky ``` url = trackingTemplates.server.impressionEvent + "&" + queryString(trackers.impression.params) ``` #### S2S pridanie do košíka pre riadok produktu ``` url = trackingTemplates.server.addToCartEvent + "&" + queryString(trackers.addToCart.params) ``` Substitúcia makier * Nahraďte {TS} aktuálnou časovou pečiatkou v milisekundách, {RURL} cieľom s kódovaním URL a `{TCF}` aktuálnym reťazcom TCF v2 z vášho CMP pred spustením. * Pre pridanie do košíka tiež nahraďte {QTY} absolútnym množstvom daného SKU v košíku v čase spustenia (nie deltou) a {CONVERSION\_VALUE} absolútnou peňažnou hodnotou týchto položiek (množstvo × jednotková cena, mínus prípadné uplatnené zľavy). {% hint style="info" %} * Iba `trackingTemplates.client.impressionPixelUrls` sú skutočné pixely (GIFy 1×1). * `clickRedirect` je koncový bod presmerovania 302. * `clickEvent` a `addToCartEvent` sú signalizátory udalostí (beacony), ktoré vracajú 204 No Content. {% endhint %} {% hint style="danger" %} Nespúšťajte C2S aj S2S pre rovnakú logickú udalosť (napríklad neposielajte C2S udalosť kliknutia aj S2S oznámenie o kliknutí pre to isté kliknutie). {% endhint %} ## Sledovanie – Client‑to‑Server (C2S) C2S sledovanie je implementované v prehliadači pomocou zostavených URL. Predraďte `BASEURL` k cestám v `trackingTemplates.client` a pripojte príslušné `trackers.params` (pozri [Ako zostaviť sledovaciu URL](#how-to-compose-a-tracking-url)). Iba `client.impressionPixelUrls` sú pixely (GIF 1×1). Ostatné klientske šablóny nie sú pixely: * `client.clickRedirect`: koncový bod presmerovania 302. Epsilon zaznamená kliknutie a presmeruje prehliadač na dekódovanú rurl. Použite to ako cieľ navigácie prehliadača. * `client.clickEvent`: **Signalizátor udalosti** vracia 204 No Content). Spusťte pomocou `navigator.sendBeacon` or `fetch({ keepalive: true })`. Nevykresľujte ako ``. * `client.addToCartEvent`: **Signalizátor udalosti** (vracia 204). Používa rovnaký vzor spúšťania ako `clickEvent`. ### Kroky implementácie 1. Vykreslite obsah stránky značky vrátený cez API. 2. Po vykreslení spusťte zobrazenia pixelov v prehliadači (všetky položky v `trackingTemplates.client.impressionPixelUrls`, ako obrázky 1×1). 3. Keď používateľ klikne na sledovateľný uzol, buď:\ (a) presmerujte cez zostavenú `client.clickRedirect` URL, alebo\ (b) spusťte zostavenú `client.clickEvent` URL ako signalizátor udalosti a prejdite na cieľ sami.\ Na jedno kliknutie použite buď jedno, alebo druhé, nie oboje. ### Impression Pixel Po vyrenderovaní stránky značky spustite každú cestu v `trackingTemplates.client.impressionPixelUrls` ako obrázok 1×1 (pozrite[ Ako zostaviť sledovaciu URL](#how-to-compose-a-tracking-url)). ```html ``` Kroky: 1. Pre každý reťazec v `trackingTemplates.client.impressionPixelUrls`, predsadzujte svoj `BASEURL` (napríklad `https://www.retailer.com/epsilon`). 2. Pripojte `&` + `queryString(trackers.impression.params)`, pričom nahraďte `{TS}` aktuálnou časovou pečiatkou v milisekundách a `{TCF}` aktuálnym reťazcom súhlasu z vášho CMP. 3. Spustite ako 1×1 `< img src="...">` v prehliadači (alebo ekvivalent). ### Sledovanie kliknutí #### Možnosť A: Presmerovanie kliknutia (`client.clickRedirect`) Presmerujte používateľa cez zostavenú URL. Epsilon zaznamená kliknutie a odpovie pomocou **HTTP 302** na dekódované `rurl`. Tento koncový bod je **iba GET** a `rurl` je povinné; #### Možnosť B: Signalizačný objekt (beacon) udalosti kliknutia (`client.clickEvent`) Spustite ako beacon a navigujte sami. Prijíma GET alebo POST, vracia 204 No Content. Nie je to obrázok; nevykresľujte ako``. ### Pridanie do košíka (C2S) Spustite `trackingTemplates.client.addToCartEvent` ako beacon udalosti (nie pixel), keď používateľ pridá produkt do košíka. Prijíma GET alebo POST, vracia 204 No Content. {% hint style="info" %} Nekombinujte C2S a S2S pridanie do košíka pre rovnakú akciu košíka. {% endhint %} ## Sledovanie – Server‑to‑Server (S2S) Sledovanie S2S je implementované na vašom backende. Zostavte URL rovnakým spôsobom ako C2S: začnite od príslušného `trackingTemplates.server` reťazca, potom pripojte `trackers.params`. Šablóny servera sú už absolútne — neexistuje žiadne `BASEURL`na predsadenie. (pozrite [Ako zostaviť sledovaciu URL](#how-to-compose-a-tracking-url)). {% hint style="info" %} Nemeniť hostiteľa ani cestu zo šablóny servera a neodosielať požiadavky S2S cez váš reverzný proxy. {% endhint %} ### Kedy použiť sledovanie S2S * Vaša architektúra vyžaduje spúšťanie udalostí na strane servera. * Potrebujete sledovanie v prostrediach, kde sú pixely na strane klienta nespoľahlivé. * Chcete miešať stratégie - napr. zobrazenia C2S + pridanie do košíka S2S. Toto je podporované, ale nikdy nespúšťajte C2S aj S2S pre rovnakú udalosť. ### Oznámenie o zobrazení S2S Po vyrenderovaní stránky značky váš server odosle **GET** alebo **POST** na zostavenú URL zobrazenia: `trackingTemplates.server.impressionEvent` + `trackers.impression.params` (nahraďte `{TS}` a `{TCF}` pred odoslaním). ### Oznámenie o kliknutí S2S Zostavte: `trackingTemplates.server.clickEvent` + `trackers.click.params` (nahraďte `{TS}`, {RURL} a `{TCF}`), potom odoslite GET alebo POST. ### Oznámenie o pridaní do košíka S2S Zostavte: `trackingTemplates.server.addToCartEvent` + `trackers.addToCart.params` (nahraďte `{TS}`, {QTY}, {CONVERSION\_VALUE} a `{TCF}`), potom odoslite GET alebo POST. ### Parametre S2S | Parameter | Zdroj | Poznámky | | ----------------------------------------------------------------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | `catalogId`, `sessionId`, `customerId`, `dtmId`, `placementId`, `lsid`, `utcOffset` | `trackingTemplates` query reťazce | Pri spúšťaní požiadavky zachovajte tieto hodnoty tak, ako sú. Neodstraňujte ich ani neupravujte. | | `modId` | `trackers..params` | Identifikátor modulu obsahu alebo riadka. | | `ts` | `trackers..params` | Nahraďte `{TS}` aktuálnou časovou pečiatkou v milisekundách pred spustením požiadavky. | | `iabConsentString` | `trackers..params` | Nahraďte `{TCF}` aktuálnym reťazcom súhlasu TCF v2 z CMP pred spustením požiadavky. Ak je hodnota už poskytnutá, použite ju tak, ako je. | | `rurl` | `trackers..params` | Cieľ presmerovania kódovaný v URL. Nahraďte `{RURL}` ak je prítomný. | | `productCode`, `sellerId` | `trackers..params` | Hodnoty odvodené z uzlov produktov. | | `qty` | `trackers.addToCart.params` | Nahraďte `{QTY}` absolútnym množstvom SKU v košíku v čase spustenia požiadavky. Nepoužívajte rozdiel množstva (delta). | | `conVal` | `trackers.addToCart.params` | Nahraďte `{CONVERSION_VALUE}` celkovou peňažnou hodnotou položiek (množstvo × jednotková cena, mínus prípadné uplatnené zľavy). | ## Odkaz na makrá | Symbol | Popis | Nachádza sa v | Nahradiť s | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | ------------------------------------------------------------------------------ | | `BASEURL` (vaša predpona) | Základná URL adresa vašej lokality s protokolom a cestou k proxy – pridáva sa na začiatok každej `trackingTemplates.client.*` cesty. | Sledovanie C2S | `https://www.retailer.com/epsilon` | | `{TS}` | Časová pečiatka na zabránenie ukladaniu do vyrovnávacej pamäte (v milisekundách) | `trackers..params` | `1737485823910` | | `{RURL}` | Cieľ presmerovania zakódovaný v URL | `trackers..params.rurl` | `https%3A%2F%2Fwww.retailer.com%2Fprodukt%2F9221200653341` | | `{TCF}` | Zástupný symbol pre reťazec súhlasu IAB TCF v2. Prítomný, keď `regs.consent` bol v požiadavke vynechaný. | `trackers..params.iabConsentString` | Aktuálny TC reťazec z vášho CMP, napr. cez `__tcfapi` `getTCData` → `tcString` | | `{QTY}` | Absolútne množstvo tohto SKU v košíku v čase spustenia (nie delta; napr. ak mal kupujúci 1 a pridá ďalší, pošlite `2`). | `trackers.addToCart.params.qty` | `2` | | `{CONVERSION_VALUE}` | Absolútna peňažná hodnota týchto položiek: množstvo × jednotková cena, mínus všetky uplatnené zľavy. | `trackers.addToCart.params.conVal` | `49.99` | | `{RURL_KID}` | ID podpisového kľúča presmerovania. Prítomné v `trackers.click.redirectParams` keď je zapnuté podpisovanie presmerovaní platformy. | `trackers.click.redirectParams.rurlKid` | ID podpisového kľúča vrátené koncovým bodom na hromadné podpisovanie | | `{RURL_SIG}` | Podpis presmerovania. Prítomný v `trackers.click.redirectParams` keď je zapnuté podpisovanie presmerovaní platformy. | `trackers.click.redirectParams.rurlSig` | Podpis Ed25519 (base64url) vrátený koncovým bodom na hromadné podpisovanie | ### Referencia pre kódovanie URL Pri kódovaní `{RURL}`použite štandardné percentuálne kódovanie: | Znak | Kódovať ako | | ---- | ----------- | | `:` | `%3A` | | `/` | `%2F` | | `?` | `%3F` | | `=` | `%3D` | | `&` | `%26` | ### redirectParams a podpisovanie presmerovaní Keď je zapnuté podpisovanie presmerovaní platformy, `trackers.click` môže obsahovať objekt `redirectParams`vedľa `params`. Kľúče v `7`sa zlučujú iba do `client.clickRedirect` URL adries — nie do `clickEvent`ani do žiadnej URL adresy servera. Dva prípady: **Vložené ciele odkazov** (URL zabudovaná do `params.rurl`): platforma podpíše presmerovanie v čase poskytnutia a vyžiari doslovné `rurlKid`a `rurlSig`hodnoty v `redirectParams`. Pridajte ich v tomto stave k `clickRedirect` URL. **Presmerovania riadené predajcom** (`params.rurl` je {RURL}): `redirectParams` obsahuje makrá {RURL\_KID} a {RURL\_SIG}. Zavolajte koncový bod pre hromadné podpisovanie (`redirectSigning.url` z odpovede), aby ste získali ID kľúča a podpis pre vašu cieľovú URL adresu, a potom ich pred pridaním nahraďte. Objekt najvyššej úrovne `redirectSigning`, ak je prítomný, poskytuje koncový bod pre hromadné `POST /ads/v3/redirect/sign` URL adries a limit `maxUrls`pre hromadné spracovanie. Kontaktujte Epsilon aby ste potvrdili, či je pre vašu integráciu zapnuté podpisovanie presmerovaní. ### Zloženie clickRedirect s redirectParams: ``` BASEURL + trackingTemplates.client.clickRedirect + "&" + queryString(trackers.click.params) + "&" + queryString(trackers.click.redirectParams) ```
## Príručka štýlu Skôr ako na svojej lokalite povolíte Brand Pages, musíme zachytiť vizuálnu identitu vašej lokality. Vyplňte nižšie uvedenú tabuľku svojimi hodnotami dizajnu. Náš tím to použije na konfiguráciu náhľadu značkovej stránky. #### Logo | Pole | Popis | Vaša hodnota | | --------------- | ---------------------------------------------- | ------------ | | URL adresa loga | URL adresa loga vašej lokality (SVG alebo PNG) | | #### Farby | Pole | Popis | Vaša hodnota | | ------------------------ | ------------------------------------------------------ | ------------ | | Primárna farba | Hlavná farba značky (hex) | | | Farba pozadia | Farba pozadia stránky (hex) | | | Farba povrchu | Farba pozadia karty/sekcie (hex) | | | Farba primárneho textu | Farba hlavného textu (hex) | | | Farba sekundárneho textu | Tlmená farba textu (hex) | | | Text na primárnej farbe | Farba textu použitá na pozadí s primárnou farbou (hex) | | | Farba ohraničenia | Predvolená farba ohraničenia (hex) | | #### Typografia | Pole | Popis | Vaša hodnota | | ---------------------- | ----------------------------------------------------------- | ------------ | | Písmo nadpisov | Písmo použité pre nadpisy (napr. "Google Sans, sans-serif") | | | Písmo tela textu | Písmo použité pre telo textu (napr. "Roboto, sans-serif") | | | Základná veľkosť písma | Predvolená veľkosť písma tela textu (napr. 16px) | | #### Tlačidlá | Pole | Popis | Vaša hodnota | | ------------------------------------- | ------------------------------------------------------- | ------------ | | Pozadie primárneho tlačidla | Farba pozadia pre primárne tlačidlá | | | Farba textu primárneho tlačidla | Farba textu pre primárne tlačidlá | | | Polomer zaoblenia primárneho tlačidla | Zaoblenie rohov (napr. 8px) | | | Štýl sekundárneho tlačidla | Opíšte vzhľad sekundárneho tlačidla (obrys, ghost atď.) | | ## Požiadavky na obsah modulov Brand Pages sa skladajú z obsahových modulov. Pre každý typ modulu uveďte obmedzenia obsahu, ktoré vaša stránka vyžaduje. Náš tím ich použije na konfiguráciu pravidiel overovania šablón. ### IMAGE moduly | Požiadavka | Popis | Vaša hodnota | | ----------------------------- | ------------------------------------------------------------------- | ------------ | | Minimálna šírka | Minimálna šírka obrázka v pixeloch (napr. 1920) | | | Minimálna výška | Minimálna výška obrázka v pixeloch (napr. 500) | | | Maximálna veľkosť súboru | Maximálna veľkosť súboru v MB (napr. 10). Musí byť menšia ako 4 MB. | | | Akceptované formáty | Akceptované formáty obrázkov (napr. jpg, png, gif, svg) | | | Maximálny počet znakov popisu | Maximálny počet znakov pre popis obrázka, ak sa uplatňuje | | | `alt`voliteľnosť tagu | Či `alt` sa vyžaduje na obrázkoch. | | ### TEXT moduly | Požiadavka | Popis | Vaša hodnota | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | Variant | “headline”, “tagline”, “body” alebo “lines”. Určuje štýl, v ktorom sa text zobrazuje. | | | Zarovnanie | “left”, “center” alebo “right”. Určuje vodorovné zarovnanie textu. | | | Konfigurácia “Lines” |

Konfigurácia pre viacriadkový text (keď variant = lines). Pre každý riadok textu uveďte nasledujúce:

- názov textového poľa
- “required” alebo “allowed”?
- či má ideť o hyperlinked odkaz na inú URL

| | | Maximálny počet znakov nadpisu | Maximálny počet znakov pre text nadpisu | | | Maximálny počet znakov popisu | Maximálny počet znakov pre text popisu | | | Maximálny počet znakov tela/päty | Maximálny počet znakov pre text tela alebo päty | | | CTA tlačidlo | Vyžadované, voliteľné alebo nie je potrebné? | | | Maximálny počet znakov textu CTA | Maximálny počet znakov pre štítok CTA tlačidla | | ### PRODUCT\_GRID moduly | Požiadavka | Popis | Vaša hodnota | | --------------------------------------- | -------------------------------------------------- | ------------ | | Minimálny počet produktov | Minimálny počet produktov na zobrazenie (napr. 4) | | | Maximálny počet produktov | Maximálny počet produktov na zobrazenie (napr. 12) | | | Názov sekcie | Vyžadované alebo voliteľné? | | | Maximálny počet znakov názvu sekcie | Maximálny počet znakov pre názov sekcie | | | Popis sekcie | Vyžadované alebo voliteľné? | | | Maximálny počet znakov pre popis sekcie | Maximálny počet znakov pre popis sekcie | | | CTA tlačidlo | Vyžadované, voliteľné alebo nie je potrebné? | | ### Moduly IMAGE\_GALLERY Modul Obrázková galéria zdedí rovnaké konfiguračné vlastnosti ako modul IMAGE. Okrem toho prijíma aj nasledujúce vlastnosti špecifické pre galériu: | Požiadavka | Popis | Vaša hodnota | | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | Minimálny počet obrázkov | Minimálny počet obrázkov galérie (napr. 2) | | | Maximálny počet obrázkov | Maximálny počet obrázkov galérie (napr. 4) | | | Názov sekcie | Či je text názvu sekcie povinný alebo voliteľný. | | | Popis sekcie | Či je text popisu sekcie povinný alebo voliteľný. | | | `alt` voliteľnosť tagu | Či `alt` sa vyžaduje na obrázkoch. | | | Voliteľnosť výzvy na akciu (Call-to-action) | Či je tlačidlo alebo odkaz výzvy na akciu povinné, povolené alebo zakázané. | | | Dodatočné riadky textu |

Pre každý ďalší text, ktorý má byť spojený s každým obrázkom v obrázkovej galérii, uveďte nasledujúce:

- názov textového poľa
- “required” alebo “allowed”?
- či má text fungovať ako hypertextový odkaz na inú URL adresu

| | ### Moduly SPLIT\_LAYOUT Modul Split Layout umožňuje zobraziť dva moduly vedľa seba. V súčasnosti sú podporované iba moduly Text a Image. Okrem jednotlivých nastavení konfigurácie pre moduly Text a Image (popísaných v sekciách vyššie) sa vyžadujú nasledujúce dodatočné vlastnosti: | Požiadavka | Popis | Vaša hodnota | | ----------------- | ---------------------------------------- | ------------ | | Pomer rozvrhnutia | Pomer stĺpcov (50:50, 33:67 alebo 67:33) | | ## Identita a súkromie ### Akceptovateľné identifikátory * Session ID – anonymný identifikátor relácie (nie PII) * Customer ID – identifikátor zákazníka u predajcu (nie PII, napr. hash vernostného ID) {% hint style="danger" %} Neodovzdávajte hašované e-mailové adresy, telefónne čísla ani žiadne PII v žiadnom parametri ani URL. {% endhint %} ### Požiadavky na ochranu súkromia Predajcovia musia: * Zverejniť sledovanie meraní vo svojich zásadách ochrany osobných údajov * Poskytnúť odkazy na odhlásenie (opt-out): * NAI: * DAA: ### GDPR / Súhlas Odovzdajte `regs`objekt na `POST /ads/v3/brand-pages`: * `regs.gdpr`: `1` keď sa na požiadavku vzťahuje GDPR (spracovanie pre EÚ/EHP/Spojené kráľovstvo podľa vašich zásad); `0`v opačnom prípade. * `regs.consent`: Keď `gdpr` is `1`, odovzdajte aktuálny reťazec súhlasu TCF v2 z vašej CMP (rovnakú hodnotu, akú by ste zobrazili iným reklamným partnerom). Nevymýšľajte ani nevkladajte reťazec napevno do kódu – použite to, s čím používateľ v prehliadači / aplikácii súhlasil. * `iabConsentString`: Toto sa zobrazuje v parametroch každej pozície trackera, nie v `trackingTemplates`. Keď `regs.consent` bolo poskytnuté, hodnotou je doslovný reťazec TC a nie je potrebná žiadna ďalšia akcia. * Keď `regs.consent` bolo vynechané, hodnotou je `{TCF}`makro — pred odoslaním akejkoľvek požiadavky na sledovanie nahraďte v čase spustenia aktuálny reťazec TCF v2 z vašej CMP. --- # 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/tracking-attribution.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.