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

# Integrációs követelmények

## Magas szintű áttekintés

Az integráció részeként az alábbiakat kell elvégeznie

1. Hajtson végre egy további hirdetéskérést a keresztértékesítési kategóriaelhelyezéshez.
   1. Ez magában foglalja a hirdetések webhelyén történő elhelyezésével és megjelenítésével kapcsolatos munkát, valamint a kattintások és megtekintések jelentését is
   2. A rendeléseket meg kell adni a következőnek: Epsilon Retail Media a szabványos integráció részeként
2. Ha szinkronizálja a kategóriaazonosítókat a következőkkel: Epsilon Retail Mediaa következőt kell használnia: [filterMapping](/retail-media-interface/integration/hu/citrus-filter-mapping-api/filtermapping.md) API-t, hogy ember által olvasható értékeket biztosítson a felhasználói felület kategóriaválasztásához
   1. Ez csak akkor érvényes, ha kategóriaazonosítókkal van integrálva nevek helyett. (például amikor hirdetéseket kér, a szűrői: `category:123j-dsef-er` a következő helyett: `category:Milk`
3. (Javasolt) - szinkronizálja a kategóriák keresztértékesítési feltérképezéseit a jóváhagyás automatizálása és a kampánykezelési terhelés csökkentése érdekében.

## Hirdetéskérés és webhelyintegráció

### Hirdetéskérés

Mivel a kategóriák keresztértékesítéséhez önálló elhelyezés szükséges, tetszőleges ad-type típusonként egy további hirdetéskérést kell integrálnia, amelyhez kategória-keresztértékesítést integrál.

A kérés formátumának meg kell egyeznie az alább felsorolt keresztértékesítési kategóriájú hirdetéskéréssel

* [Termékhirdetés - keresztértékesítési kategóriájú hirdetések kérése](/retail-media-interface/integration/hu/generating-ads/product-ads/requesting-product-ads-1.md#cross-sell-category-placements)
* [Banner hirdetés - keresztértékesítési kategóriájú hirdetések kérése](/retail-media-interface/integration/hu/generating-ads/banner-ads-static/requesting-banner-ads.md#cross-sell-category-placements)
* Banner X – keresztértékesítési kategóriájú hirdetések kérése

### Megtekintések és kattintások jelentése

Miután integrálta a hirdetéskérést, gondoskodnia kell arról is, hogy minden egyes megjelenített hirdetésnél megfelelően jelentse a kattintásokat és a megtekintéseket. Győződjön meg róla, hogy elolvasta a következőt: [Megtekintések és kattintások jelentése](/retail-media-interface/integration/hu/data-api/api-overview/reporting-impressions-clicks.md).

### Rendelések jelentése

Általában a legtöbb integráció minden rendelési információt jelent a következőnek: Epsilon Retail Media a szabványos integrációnak megfelelően. Biztosítania kell, hogy minden rendelést megfelelően jelentsen a következőnek: Epsilon Retail Media a következők szerint: [Rendelési adatok](/retail-media-interface/integration/hu/data-api/order-data-1.md).

## Szűrőleképezések

A filter mapping végpont segítségével a kategóriaazonosítókat ember által olvasható értékekre képezheti le. Erre akkor van szükség, ha szinkronizálja a kategóriaazonosítókat, mivel a felhasználói felület megjeleníti az értékeket a felhasználóknak.

{% hint style="info" %}
Ha szinkronizálja az ember által olvasható kategóriákat a termékkatalógusában a következőkkel: Epsilon Retail Mediaerre a lépésre nem lesz szükség.
{% endhint %}

A felhasználók nem fogják megérteni, hogy mi az a `category:12345-abcde` A filterMapping API segítségével hozzárendelheti az értéket a webhely releváns kategórianévhez, például: `category:Pantry`.

Nincs fájlalapú módszer az információk szinkronizálására, ezt a következőkön keresztül kell megtenni: [filterMapping](/retail-media-interface/integration/hu/citrus-filter-mapping-api/filtermapping.md) API.

{% hint style="warning" %}
Amikor további kategóriákat hoz létre a webhelyén, gondoskodnia kell arról, hogy a filterMapping API-t használja a kategóriák frissítésére.
{% endhint %}

## Keresztértékesítési kategória-hozzárendelések (javasolt)

Ilyen típusú elhelyezés integrálásakor kifejezetten javasolt megadni annak feltérképezését, hogy mely kategóriák célozhatják meg egymást. Ez leegyszerűsítheti a műveleteket a kezdeti integrációs munka után. A hirdetői élmény úgy van leegyszerűsítve, hogy csak azokat a kategóriákat lehessen kiválasztani, amelyek már engedélyezve vannak.

Ezenkívül lehetőség van az automatikus jóváhagyás konfigurálására is a keresztértékesítési kategóriakampányokhoz, ha meg vannak adva keresztértékesítési feltérképezések.

### Integrációs módszerek

* Használhatja a következőt: [crossSellCategory](/retail-media-interface/integration/hu/crosssellcategory-api/crosssellcategory.md) API-t a leképezések szükség szerinti létrehozásához és kezeléséhez.
* Alternatív megoldásként biztosíthat egy TSV-fájlt egy GCS-gyűjtőhöz, amelyet a következők gazdaoldala biztosít: Epsilon Retail Media az alábbiakban felsorolt formátumban.

#### API-integráció

Minden szükséges információ megtalálható a következőkben: [crossSellCategory](/retail-media-interface/integration/hu/crosssellcategory-api/crosssellcategory.md) API-referencia.

#### Fájlintegráció

Fájlon keresztüli integráció esetén, Epsilon Retail Media katalógusonként egy fájlt igényel arról, hogy mely kategóriák célozhatják meg egymást.

A fájl minden sora egyetlen kategória leképezését jelenti, és azt a kategóriát, amelyet megcélozhat. Minden feltérképezés egyirányú (ha szinkronizálja a csokoládé -> tej útvonalat, a csokoládétermékek megjelenhetnek a tej kategóriában. Ha a tejtermékeknek meg kell tudniuk jelenni a csokoládé kategóriában, akkor egy további sorra van szükség).

Az alábbi specifikációknak megfelelő, TSV formátumú adatcsatornára van szükségünk:

| oszlop neve         | Kötelező | Adattípus | Leírás                                                                                                                               | Példa              |
| ------------------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------ |
| `category`          | Kötelező | Szöveg    | Ez egy egyedi kategóriaazonosító, amely az advertised termék kategóriáját azonosítja.                                                | `category:cookies` |
| `cross_category_id` | Kötelező | Szöveg    | Ez egy egyedi kategóriaazonosító, amely azonosítja azt a jogosult kategóriát, amelybe a category\_id termékei keresztértékesíthetők. | `category:milk`    |

A fájlokra vonatkozó további specifikációk alább találhatók:

* Csak a TSV-fájlok támogatottak
* A TSV-nek LF kiterjesztésűnek kell lennie, nem CRLF-nek
* A TSV-nek UTF-8 kódolásúnak kell lennie, bármilyen más típus a hírfolyam meghiúsulását okozza
* Elvárt elnevezési konvenció: `^cross_sell_category.*.tsv$`

Egy példarészlet az alábbiak szerint néz ki:

| category         | cross\_category\_id |
| ---------------- | ------------------- |
| category:cookies | kategória:tej       |
| category:cookies | kategória:csokoládé |
| kategória:tej    | category:cookies    |

A fenti részlet lehetővé teszi, hogy a **kekszek** kategória keresztértékesítést végezzen a **tej** és a **csokoládé** kategóriákba. A **tej** kategória keresztértékesíthet a **kekszek** kategóriába. A **csokoládé** kategória célozható, de nem célozhat meg semmilyen más kategóriát.

{% hint style="danger" %}
️ Minden sor egy egyedi leképezési kombináció

Egyedi sorokat kell szinkronizálnia minden egyes egyedi keresztértékesítési kategórialeképezéshez. Ha egyetlen sorban több cross\_category\_id-t próbál szinkronizálni, a fájl beolvasása sikertelen lesz.
{% endhint %}

{% hint style="warning" %}
Oszlopok sorrendje

Kérjük, győződjön meg arról, hogy a fájl első oszlopa a(z) `category` column. If you synchronize `cross_category_id` as the first column, the ingest will fail.
{% endhint %}

## Feature Onboarding Flow

Once you are ready to sync your suggested search terms feed, Epsilon Retail Media will configure a GCS bucket for you to drop your files in.

This feature is only supported for GCS buckets. External buckets like AWS/Azure/etc. are not supported.

Your Technical Account Manager will guide you through onboarding this feature. Since the Epsilon Retail Mediaplatform operations team needs to perform a configuration, please note that onboarding takes additional lead time.


---

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