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

# Požadavky na integraci

## Přehled na vysoké úrovni

V rámci této integraci budete muset provést následující kroky

1. Implementujte dodatečnou žádost o reklamu pro umístění křížového prodeje kategorií.
   1. To zahrnuje práci na umístění a vykreslení reklam na vašem webu, stejně jako hlášení kliknutí a zobrazení
   2. Objednávky musí být poskytnuty společnosti Epsilon Retail Media v rámci vaší standardní integrace
2. Pokud synchronizujete ID kategorií se společností Epsilon Retail Media, budete muset použít rozhraní [filterMapping](/retail-media-interface/integration/cs/citrus-filter-mapping-api/filtermapping.md) API k poskytnutí lidsky čitelných hodnot pro výběr kategorie v uživatelském rozhraní
   1. Tento krok platí pouze v případě, že jste integrováni s ID kategorií namísto názvů. (například když žádáte o reklamy, vaše filtry jsou `category:123j-dsef-er` místo `category:Milk`
3. (Doporučeno) – synchronizujte mapování křížového prodeje kategorií pro automatizaci schvalování a snížení zátěže při správě kampaní.

## Žádost o reklamu a integrace webu

### Žádost o reklamu

Jelikož křížový prodej kategorií vyžaduje samostatné umístění, budete muset integrovat dodatečnou žádost o reklamu pro každý typ reklamy, pro který křížový prodej kategorií integrujete.

Formát vaší žádosti by měl odpovídat žádosti o reklamu pro křížový prodej kategorií, jak je uvedeno níže

* [Produktová reklama – žádost o reklamy pro křížový prodej kategorií](/retail-media-interface/integration/cs/generating-ads/product-ads/requesting-product-ads-1.md#cross-sell-category-placements)
* [Bannerová reklama – žádost o reklamy pro křížový prodej kategorií](/retail-media-interface/integration/cs/generating-ads/banner-ads-static/requesting-banner-ads.md#cross-sell-category-placements)
* Banner X – žádost o reklamy pro křížový prodej kategorií

### Hlášení zobrazení a kliknutí

Jakmile integrujete svou žádost o reklamu, budete muset také zajistit, abyste správně hlásili kliknutí a zobrazení pro každou zobrazenou reklamu. Ujistěte se, že jste si přečetli [Hlášení zobrazení a kliknutí](/retail-media-interface/integration/cs/data-api/api-overview/reporting-impressions-clicks.md).

### Hlášení objednávek

Obecně většina integrací hlásí všechny informace o objednávkách společnosti Epsilon Retail Media podle standardní integrace. Musíte zajistit, abyste správně hlásili všechny objednávky společnosti Epsilon Retail Media podle [Data objednávek](/retail-media-interface/integration/cs/data-api/order-data-1.md).

## Mapování filtrů

Koncový bod mapování filtrů lze použít k mapování vašich ID kategorií na lidsky čitelné hodnoty. Vyžaduje se to v případě, že synchronizujete ID kategorií, protože uživatelské rozhraní zobrazuje tyto hodnoty vašim uživatelům.

{% hint style="info" %}
Pokud ve svém produktovém katalogu synchronizujete lidsky čitelné kategorie se společností Epsilon Retail Media, tento krok nebude vyžadován.
{% endhint %}

Uživatelé nebudou rozumět tomu, co `category:12345-abcde` je. Rozhraní filterMapping API lze použít k mapování hodnoty na příslušný název kategorie na vašem webu, jako je např. `category:Pantry`.

Neexistuje žádná souborová metoda pro synchronizaci těchto informací, musí být provedena prostřednictvím rozhraní [filterMapping](/retail-media-interface/integration/cs/citrus-filter-mapping-api/filtermapping.md) API.

{% hint style="warning" %}
Když na svém webu vytvoříte další kategorie, budete muset zajistit použití rozhraní filterMapping API k aktualizaci kategorií.
{% endhint %}

## Mapování křížového prodeje kategorií (doporučeno)

Při integraci tohoto typu umístění se důrazně doporučuje poskytnout mapování toho, které kategorie na sebe mohou cílil. To může po počáteční integrační práci zefektivnit vaše operace. Uživatelský zážitek inzerenta je zjednodušen tak, aby umožňoval výběr pouze těch kategorií, které jsou již povoleny.

Kromě toho je také možné nakonfigurovat automatické schvalování pro kampaně křížového prodeje kategorií, pokud jsou k dispozici mapování křížového prodeje.

### Metody integrace

* K vytváření a správě mapování podle svých potřeb můžete použít rozhraní [crossSellCategory](/retail-media-interface/integration/cs/crosssellcategory-api/crosssellcategory.md) API.
* Případně můžete poskytnout soubor TSV do úložiště GCS hostovaného společností Epsilon Retail Media ve formátu uvedeném níže.

#### Integrace přes API

Všechny požadované informace naleznete v [crossSellCategory](/retail-media-interface/integration/cs/crosssellcategory-api/crosssellcategory.md) referenční příručce k API.

#### Integrace pomocí souboru

Pokud integrujete pomocí souboru, společnost Epsilon Retail Media vyžaduje jeden soubor na katalog s uvedením kategorií, které na sebe mohou navzájem cílit.

Každý řádek v souboru představuje jedno mapování kategorie a kategorie, na kterou může cílit. Každé mapování je jednosměrné (pokud synchronizujete čokoláda -> mléko, produkty z čokolády se mohou zobrazovat v kategorii mléko. Pokud se mají produkty z mléka zobrazovat v čokoládě, je vyžadován další řádek).

Požadujeme datový kanál ve formátu TSV odpovídající níže uvedeným specifikacím:

| název sloupce       | Požadováno | Datový typ | Popis                                                                                                                     | Příklad            |
| ------------------- | ---------- | ---------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `category`          | Požadováno | Text       | Toto je unikátní ID kategorie identifikující kategorii inzerovaného produktu.                                             | `category:cookies` |
| `cross_category_id` | Požadováno | Text       | Toto je unikátní ID kategorie identifikující způsobilou kategorii, do které lze produkty s category\_id křížově prodávat. | `category:milk`    |

Další specifikace souboru jsou uvedeny níže:

* Podporovány jsou pouze soubory TSV
* TSV by měl používat konce řádků LF, nikoli CRLF
* TSV by měl mít kódování UTF-8, jakékoli jiné typy způsobí selhání kanálu
* Vyžadovaný konvence pojmenování: `^cross_sell_category.*.tsv$`

Příklad ukázky vypadá následovně:

| kategorie        | cross\_category\_id |
| ---------------- | ------------------- |
| category:cookies | kategorie:mleko     |
| category:cookies | kategorie:cokolada  |
| kategorie:mleko  | category:cookies    |

Tento fragment výše umožňuje kategorii **sušenky** křížový prodej do kategorií **mléko** a **čokoláda**. Kategorie **mléko** může provádět křížový prodej do kategorie **sušenky**. Na kategorii **čokoláda** lze cílit, ale nemůže cílit na žádné jiné kategorie.

{% hint style="danger" %}
️ Každý řádek je unikátní kombinační mapování

Musíte synchronizovat unikátní řádky pro každé unikátní mapování kategorií křížového prodeje. Pokud se pokusíte synchronizovat více cross\_category\_id na jediném řádku, zpracování souboru selže.
{% endhint %}

{% hint style="warning" %}
Pořadí sloupců

Ujistěte se, že váš soubor má `category` sloupec jako první sloupec. Pokud synchronizujete `cross_category_id` jako první sloupec, zpracování selže.
{% endhint %}

## Proces aktivace funkce

Jakmile jste připraveni začít synchronizovat svůj feed navrhovaných vyhledávacích dotazů, Epsilon Retail Media vám nakonfiguruje GCS bucket, do kterého budete ukládat své soubory.

Tato funkcionalita je podporována pouze v GCS bucketech. Externí buckety jako AWS/Azure/jiné nejsou podporovány.

Váš Technical Account Manager vás bude moci provést aktivací této funkce. Jelikož Epsilon Retail Mediatým operací platformy musí provést konfiguraci, počítejte prosím s dodatečnou lhůtou pro aktivaci.


---

# 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/cs/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.