> 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/feature-integrations/category-cross-sell/integration-requirements.md).

# Požiadavky na integráciu

## Prehľad na vysokej úrovni

V rámci tejto integrácie budete musieť vykonať nasledujúce kroky

1. Implementujte dodatočnú žiadosť o reklamu pre umiestnenie v kategórii kros-selu.
   1. To zahŕňa prácu na umiestnení a zobrazení reklám na vašom webe, ako aj na vykazovaní kliknutí a zobrazení
   2. Objednávky je potrebné poskytnúť do Epsilon Retail Media v rámci vašej štandardnej integrácie
2. Ak synchronizujete ID kategórií s Epsilon Retail Media, budete musieť použiť [filterMapping](/retail-media-interface/integration/sk/citrus-filter-mapping-api/filtermapping.md) API na poskytnutie hodnot čitateľných pre človeka pre výber kategórie v používateľskom rozhraní
   1. Toto sa vzťahuje len na prípad, ak ste integrovaní s ID kategórií namiesto názvov. (napríklad keď žiadate o reklamy, vaše filtre sú `category:123j-dsef-er` namiesto `category:Milk`
3. (Odporúčané) – synchronizujte mapovania kros-selu kategórií, aby ste automatizovali schvaľovanie a znížili záťaž pri správe kampaní.

## Žiadosť o reklamu a integrácia webu

### Žiadosť o reklamu

Keďže kros-sel kategórie vyžaduje samostatné umiestnenie, budete musieť integrovať dodatočnú žiadosť o reklamu pre každý typ reklamy, pre ktorý kros-sel kategórie integrujete.

Formát vašej žiadosti by mal zodpovedať žiadosti o reklamu na kros-sel kategórie, ako je uvedené nižšie

* [Produktová reklama – žiadosť o reklamy na kros-sel kategórie](/retail-media-interface/integration/sk/generating-ads/product-ads/requesting-product-ads-1.md#cross-sell-category-placements)
* [Bannerová reklama – žiadosť o reklamy na kros-sel kategórie](/retail-media-interface/integration/sk/generating-ads/banner-ads-static/requesting-banner-ads.md#cross-sell-category-placements)
* Banner X – žiadosť o reklamy na kros-sel kategórie

### Vykazovanie zobrazení a kliknutí

Po integrovaní žiadosti o reklamu musíte tiež zabezpečiť správne vykazovanie kliknutí a zobrazení pre každú zobrazenú reklamu. Uistite sa, že ste si prečítali [Vykazovanie zobrazení a kliknutí](/retail-media-interface/integration/sk/data-api/api-overview/reporting-impressions-clicks.md).

### Vykazovanie objednávok

Všeobecne väčšina integrácií vykazuje všetky informácie o objednávkach do Epsilon Retail Media podľa štandardnej integrácie. Musíte sa uistiť, že správne vykazujete všetky objednávky do Epsilon Retail Media podľa [Údaje o objednávke](/retail-media-interface/integration/sk/data-api/order-data-1.md).

## Mapovania filtrov

Koncový bod na mapovanie filtrov možno použiť na mapovanie vašich ID kategórií na hodnoty čitateľné pre človeka. Je to potrebné, ak synchronizujete ID kategórií, keďže používateľské rozhranie zobrazuje tieto hodnoty vašim používateľom.

{% hint style="info" %}
Ak synchronizujete kategórie čitateľné pre človeka vo vašom produktovom katalógu s Epsilon Retail Media, tento krok nebude potrebný.
{% endhint %}

Používatelia nepochopia, čo `category:12345-abcde` je. API filterMapping sa dá použiť na namapovanie hodnoty na príslušný názov kategórie na vašom webe, ako napríklad `category:Pantry`.

Neexistuje žiadna metóda založená na súboroch na synchronizáciu týchto informácií, musí sa to vykonať prostredníctvom [filterMapping](/retail-media-interface/integration/sk/citrus-filter-mapping-api/filtermapping.md) API.

{% hint style="warning" %}
Keď na svojom webe vytvoríte ďalšie kategórie, budete musieť zabezpečiť, aby sa API filterMapping použilo na aktualizáciu kategórií.
{% endhint %}

## Mapovania kros-selu kategórií (odporúčané)

Pri integrácii tohto typu umiestnenia sa dôrazne odporúča poskytnúť mapovanie kategórií, ktoré na seba môžu cieliť. To môže zefektívniť vaše operácie po úvodnej integrácii. Skúsenosť inzerenta je zjednodušená tak, aby umožňovala výber len tých kategórií, ktoré sú už povolené.

Okrem toho je tiež možné nakonfigurovať automatické schvaľovanie pre kampane s kros-selom kategórií, ak sú poskytnuté mapovania kros-selu.

### Metódy integrácie

* Môžete použiť [crossSellCategory](/retail-media-interface/integration/sk/crosssellcategory-api/crosssellcategory.md) API na vytváranie a správu mapovaní podľa vašich potrieb.
* Alternatívne môžete poskytnúť súbor TSV do bucketu GCS hostovaného v Epsilon Retail Media s formátom uvedeným nižšie.

#### Integrácia cez API

Všetky požadované informácie nájdete v [crossSellCategory](/retail-media-interface/integration/sk/crosssellcategory-api/crosssellcategory.md) API referencii.

#### Integrácia cez súbor

Ak integrujete pomocou súboru, Epsilon Retail Media vyžaduje jeden súbor na katalóg kategórií, ktoré na seba môžu navzájom cieliť.

Každý riadok v súbore predstavuje jedno mapovanie kategórie a kategórie, na ktorú môže cieliť. Každé mapovanie je jednosmerné (ak synchronizujete čokoláda -> mlieko, čokoládové produkty sa môžu zobraziť v kategórii mlieko. Ak sa produkty mlieka majú zobrazovať v čokoláde, vyžaduje sa dodatočný riadok).

Potrebujeme dátový kanál vo formáte TSV, ktorý je v súlade s nižšie uvedenými špecifikáciami:

| názov stĺpca        | Požadované | Dátový typ | Popis                                                                                                                         | Príklad            |
| ------------------- | ---------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `category`          | Požadované | Text       | Toto je unikátne ID kategórie identifikujúce kategóriu inzerovaného produktu.                                                 | `category:cookies` |
| `cross_category_id` | Požadované | Text       | Toto je unikátne ID kategórie identifikujúce oprávnenú kategóriu, do ktorej sa môžu produkty z category\_id krížovo predávať. | `category:milk`    |

Ďalšie špecifikácie súboru sú uvedené nižšie:

* Podporované sú len súbory TSV
* TSV by mal mať ukončenie riadkov LF, nie CRLF
* TSV by mal mať kódovanie UTF-8, akékoľvek iné typy spôsobia zlyhanie kanála
* Vyžaduje sa konvencia pomenovania: `^cross_sell_category.*.tsv$`

Príklad ukážky vypadá takto:

| category         | cross\_category\_id |
| ---------------- | ------------------- |
| category:cookies | kategória:mlieko    |
| category:cookies | kategória:čokoláda  |
| kategória:mlieko | category:cookies    |

Tento fragment vyššie umožňuje kategórii **sušienky** krížový predaj do kategórií **mlieko** a **čokoláda**. Kategória **mlieko** môže vykonávať krížový predaj do kategórie **sušienky**. Kategória **čokoláda** môže byť cieľová, ale nemôže cieľovo orientovať žiadne ine kategórie.

{% hint style="danger" %}
️ Každý riadok je unikátna kombinácia mapovania

Musíte synchronizovať unikátne riadky pre každé unikátne mapovanie kategórií krížového predaja. Ak sa pokúsite synchronizovať viaceré cross\_category\_id v jednom riadku, spracovanie súboru zlyhá.
{% endhint %}

{% hint style="warning" %}
Poradie stĺpcov

Uistite sa, že váš súbor má `category` stĺpec ako prvý stĺpec. Ak synchronizujete `cross_category_id` ako prvý stĺpec, spracovanie zlyhá.
{% endhint %}

## Proces aktivácie funkcie

Hneď ako budete pripravení začať synchronizovať svoj kanál navrhovaných vyhľadávacích výrazov, Epsilon Retail Media vám nakonfiguruje úložisko GCS bucket, do ktorého budete môcť vkladať svoje súbory.

Táto funkcionalita je podporovaná iba v úložiskách GCS buckets. Externé úložiská ako AWS/Azure/iné nie sú podporované.

Váš Technical Account Manager vás bude môcť sprevádzať aktiváciou tejto funkcie. Keďže Epsilon Retail Mediatím platformových operácií musí vykonať konfiguráciu, berte prosím na vedomie, že na aktiváciu je potrebný dodatočný čas spracovania.


---

# 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/feature-integrations/category-cross-sell/integration-requirements.md?ask=<question>&goal=<endgoal>
```

`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.