> 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/data-api/api-overview/integration-workflow-options-1.md).

# Možnosti postupu integrace reklam pro prodejce

Epsilon's Retail Media Standardní integrace zajišťuje, že vaše webová stránka poskytuje bezproblémový uživatelský zážitek rychlým zobrazováním relevantních reklam zákazníkům. Jako prodejce jednoduše musíte synchronizovat svůj katalog produktů a zákaznická data s Epsilon's Retail Media. Je důležité poznamenat, že Epsilon Retail Media je integrován přes backend prodejce. Integrace zajišťuje, že se na vaší webové stránce zobrazují relevantní reklamy, což zlepšuje nákupní zážitek uživatele propojením reklamních nabídek s organickým obsahem. Zde jsou některé z hlavních výhod:

1. **Vylepšený uživatelský zážitek**: Reklamy jsou bezproblémově integrovány s organickým obsahem, což zajišťuje plynulé procházení.
2. **Relevantnost**: Reklamy jsou kontextově relevantní, což zvyšuje zapojení uživatelů.
3. **Efektivita**: Rychlé doručování reklamního obsahu zlepšuje dobu načítání stránky.
4. **Reportování**: Získejte podrobné přehledy o zobrazeních reklam, kliknutích a objednávkách.

## Standardní integrace

Pracovní postup standardní integrace zahrnuje následující kroky:

1. Synchronizovat data
2. Služba Ads
3. Hlášení akcí

{% hint style="info" %}
Zákazníci nevidí nabídky, dokud nejsou sloučeny do konečného seznamu. To zajišťuje, že získají úplné a přesné informace.
{% endhint %}

<figure><img src="/files/HyHr1JbfE3SmjNvJTbF7" alt="" width="100%"><figcaption></figcaption></figure>

### Pracovní postup

Zde je posloupnost událostí:

#### Před zobrazováním reklam

**Synchronizovat data o produktech**: Synchronizujte svůj katalog produktů s Epsilon Retail Media pomocí [API](https://developers.citrusad.com/integration/docs/use-apis) nebo denní [synchronizace souborů](https://developers.citrusad.com/integration/docs/use-apis). Volitelně synchronizujte své zákaznické údaje s Epsilon Retail Media pomocí API nebo denní synchronizace souborů.

#### Při zobrazování reklam

1. **Zákazník navštíví vaši webovou stránku**: Zákazník otevře vaši webovou stránku a přejde na konkrétní stránku, kde Epsilon’s Retail Media je integrován.
2. **Webová stránka požaduje data**: Vaše webová stránka požaduje data z vašeho backendového serveru na základě kontextu stránky (například `customerId`, `sessionId`, `dtmCookieID`, `productFilters`).
3. Backend požaduje reklamy od Epsilon Retail Media: Váš backendový server volá Epsilon Retail Media API s požadavkem na reklamy relevantní pro kontext stránky zákazníka.
4. **Epsilon Retail Media Vrací relevantní reklamy**: Epsilon Retail Media vrací nejrelevantnější reklamy pro požadavek, včetně kódů produktů a URL pro bannerové reklamy.
5. **Sloučit reklamy s organickým obsahem**: Váš backendový server sloučí odpověď s reklamou od Epsilon Retail Media s organickým obsahem vaší webové stránky.
6. **Doručit veškerý obsah zákazníkovi**: Váš server odešle kombinované reklamy a organický obsah do prohlížeče zákazníka v jedné odpovědi.

#### Po zobrazení reklam

1. **Hlášení zobrazení**: Když si zákazník prohlédne reklamu, zobrazení se nahlásí Epsilon Retail Media pro jednotlivé adId.
2. **Hlášení kliknutí**: Když zákazník klikne na reklamu, kliknutí se nahlásí Epsilon Retail Media pro jednotlivé `adId`.
3. **Hlášení objednávek**: Když zákazník dokončí nákup, podrobnosti o objednávce (položky, ceny, množství) spolu s `customerId`, `sessionId`, `dtmCookieId` jsou nahlášeny Epsilon Retail Media.

## Flexibilní možnosti integrace

Epsilon Retail Media také nabízí dvě další integrační metody přizpůsobené různým potřebám a preferencím prodejců. Každá metoda má své jedinečné výhody a kompromisy, což prodejcům umožňuje vybrat si nejvhodnější přístup na základě jejich specifických požadavků a technických možností.

### Přístup 1: Jednotlivé požadavky z prohlížeče

Tento přístup zahrnuje samostatná volání backendu pro organické produkty a reklamy, což snižuje úpravy backendu a zajišťuje, že uživatelé vždy uvidí nejaktuálnější nabídky. Zde jsou některé z výhod tohoto přístupu pro prodejce:

* **Zkrácená doba vývoje**: Snazší implementace s minimálními změnami backendu, což šetří čas a zdroje na vývoj.
* **Aktuální nabídky**: Zajišťuje zobrazení nejaktuálnějšího reklamního obsahu, což potenciálně zvyšuje relevantnost reklamy a zapojení uživatelů.

#### Pracovní postup

Zde je posloupnost událostí:

<figure><img src="/files/a8jDN7aLd8xJzl5AFdaY" alt="" width="100%"><figcaption></figcaption></figure>

#### Při zobrazování reklam

V případě požadavků z prohlížeče se zobrazování reklam liší od standardní integrace následujícím způsobem:

**Zpracování požadavků**

* Seznamy produktů jsou před uživatelem skryty, dokud se organické nabídky nesloučí s Epsilon Retail Media nabídkami.
* Namísto toho, aby vaše stávající backendová služba přímým způsobem požadovala data z Epsilon Retail Media, nyní používáte novou službu prodejce.
* Služba prodejce provede volání na backend do Epsilon Retail Media s příslušnými informacemi o umístění.
* I když kontaktujete svůj backendový server a Epsilon Retail Media samostatně před sloučením, stále musíte shromáždit všechny potřebné podrobnosti o produktu pro kódy produktů poskytnuté v Epsilon Retail Media odpovědi.

**Sloučení a doručování obsahu**

* Prohlížeč sloučí organické nabídky a Epsilon Retail Media nabídkami.
* Po sloučení prohlížeč doručí kombinovaný obsah zákazníkovi.

### Přístup 2: Sloučení po zobrazení zákazníkovi

Tento přístup nejprve zobrazí organický obsah a teprve poté sloučí reklamy, což vyžaduje minimální změny backendu a zajišťuje uživatelům nepřerušovaný přístup k organickým nabídkám.

#### Pracovní postup

V tomto přístupu postupujete podle podobného pracovního postupu jako dříve; výsledky organických produktů však zákazníkovi doručíte, jakmile jsou k dispozici. Po zobrazení organických výsledků sloučíte a přeuspořádáte výsledky po obdržení obsahu z Epsilon Retail Media Tato metoda integrace pravděpodobně zabere nejméně času na implementaci, protože vyžaduje minimální vývojové zdroje.

<figure><img src="/files/EgPg5hpNa3g6ImTuPemt" alt="" width="100%"><figcaption></figcaption></figure>

#### Když se zobrazují reklamy

Nejprve se zobrazí organické nabídky a Epsilon Retail Media odpověď se sloučí, jakmile ji prohlížeč obdrží. Příležitostně se uživateli před sloučením a přeuspořádáním produktových reklam zobrazí organické nabídky. Když Epsilon Retail Media vám poskytne seznam kódů produktů, stále musíte načíst všechny příslušné podrobné informace pro každý z těchto produktů.

## Srovnání metod integrace

Zde je rychlé srovnání všech různých metod integrace, které můžete použít:

|                   | Standardní integrace                                                  | Jednotlivé požadavky prohlížeče                           | Sloučení po zobrazení zákazníkovi                                                   |
| ----------------- | --------------------------------------------------------------------- | --------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Pracovní postup   | Jediný požadavek na backend, sloučení před zobrazením                 | Samostatné požadavky na organické produkty a reklamy      | Nejprve se zobrazí organický obsah, poté se sloučí reklamy                          |
| Úpravy backendu   | Stávající backendová služba zpracovává Epsilon Retail Media požadavky | Nová backendová služba pro Epsilon Retail Media požadavky | Minimální změny stávajících backendových služeb                                     |
| Úsilí na vývoj    | Střední                                                               | Nižší                                                     | Nejnižší                                                                            |
| Slučování reklam  | Backend slučuje reklamy s organickým obsahem                          | Prohlížeč slučuje reklamy s organickým obsahem            | Prohlížeč slučuje reklamy s organickým obsahem                                      |
| Zobrazení reklamy | Reklamy se zobrazují s organickým obsahem                             | Reklamy se zobrazují s organickým obsahem                 | Reklamy se zobrazují s organickým obsahem                                           |
| Výhody            | - Bezproblémová integrace – Sjednocené zpracování na backendu         | - Méně úprav backendu – Samostatná logika reklam          | - Rychlá integrace – Minimální změny backendu                                       |
| Nevýhody          | - Střední úsilí na vývoj – Sjednocená logika reklam                   | - Dodatečná backendová služba – Samostatná logika reklam  | - Možné zpoždění při zobrazení reklamy – Reklamy se slučují až po organickém obsahu |


---

# 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/data-api/api-overview/integration-workflow-options-1.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.