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

# Hirdetésintegrációs munkafolyamat-opciók kiskereskedők számára

Epsilon's Retail Media a standard integráció biztosítja, hogy webhelye zökkenőmentes felhasználói élményt nyújtson azáltal, hogy gyorsan releváns hirdetéseket jelenít meg a vásárlóknak. Kereskedőként csupán szinkronizálnia kell termékkatalógusát és ügyféladatait a következőkkel: Epsilon's Retail Media. Fontos megjegyezni, hogy a(z) Epsilon Retail Media integrációja a kereskedő háttérrendszerén (backend) keresztül történik. Az integráció biztosítja, hogy a releváns hirdetések megjelenjenek a webhelyén, javítva a felhasználó vásárlási élményét a hirdetési találatok és az organikus tartalom egyesítésével. Íme néhány a főbb előnyök közül:

1. **Továbbfejlesztett felhasználói élmény**: A hirdetések zökkenőmentesen integrálódnak az organikus tartalomba, sima böngészési élményt nyújtva.
2. **Relevancia**: A hirdetések kontextusilag relevánsak, ami növeli a felhasználói elköteleződést.
3. **Hatékonyság**: A hirdetési tartalom gyors kézbesítése javítja az oldalbetöltési időket.
4. **Jelentéskészítés**: Részletes betekintést nyerhet a hirdetésmegjelenésekbe, a kattintásokba és a rendelésekbe.

## Standard integráció

A standard integrációs munkafolyamat a következő lépésekből áll:

1. Adatok szinkronizálása
2. Hirdetések kiszolgálása
3. Műveletek jelentése

{% hint style="info" %}
A vásárlók mindaddig nem látják a találatokat, amíg azokat nem egyesítik egy végleges listába. Ez biztosítja, hogy hiánytalan és pontos információkhoz jussanak.
{% endhint %}

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

### Munkafolyamat

Íme az események sorozata:

#### A hirdetések kiszolgálása előtt

**Termékadatok szinkronizálása**: Szinkronizálja termékkatalógusát a következőkkel: Epsilon Retail Media a(z) [API](https://developers.citrusad.com/integration/docs/use-apis) vagy egy napi [fájlszinkronizálás](https://developers.citrusad.com/integration/docs/use-apis)használatával. Opcionálisan szinkronizálhatja ügyféladatait a következőkkel: Epsilon Retail Media az API vagy egy napi fájlszinkronizálás használatával.

#### Amikor a hirdetések kiszolgálásra kerülnek

1. **Az ügyfél meglátogatja a webhelyét**: Az ügyfél megnyitja a webhelyét, és egy olyan konkrét oldalra navigál, ahol a(z) Epsilon’s Retail Media integrálva van.
2. **A webhely adatokat kér**: A webhely adatokat kér a háttérszervertől az oldal kontextusa alapján (például: `customerId`, `sessionId`, `dtmCookieID`, `productFilters`).
3. A háttérrendszer hirdetéseket kér a következőtől: Epsilon Retail Media: A háttérszerver meghívja a(z) Epsilon Retail Media API-t, kérve az ügyfél oldalának kontextusához releváns hirdetéseket.
4. **Epsilon Retail Media Releváns hirdetéseket ad vissza**: Epsilon Retail Media visszaadja a kéréshez leginkább releváns hirdetéseket, beleértve a termékkódokat és a bannerhirdetések URL-címeit.
5. **Hirdetések egyesítése az organikus tartalommal**: A háttérszerver egyesíti a hirdetési választ a következőtől: Epsilon Retail Media a webhely organikus tartalmával.
6. **Minden tartalom kiszolgálása a vásárlónak**: A szerver a kombinált hirdetéseket és az organikus tartalmat egyetlen válaszban küldi el a vásárló böngészőjének.

#### A hirdetések kiszolgálása után

1. **Megjelenések jelentése**: Amikor a vásárló megtekint egy hirdetést, egy megjelenés kerül jelentésre a következőknek: Epsilon Retail Media az egyedi adId.
2. **Kattintások jelentése**: Amikor a vásárló rákattint egy hirdetésre, egy kattintás kerül jelentésre a következőknek: Epsilon Retail Media az egyedi `adId`.
3. **Rendelések jelentése**: Amikor a vásárló befejezi a vásárlást, a rendelési részletek (tételek, árak, mennyiségek) a következőkkel együtt: `customerId`, `sessionId`, `dtmCookieId` jelentésre kerülnek a következőknek: Epsilon Retail Media.

## Rugalmas integrációs lehetőségek

Epsilon Retail Media két további integrációs módszert is kínál, amelyeket a különböző kereskedői igényekhez és preferenciákhoz igazítottak. Mindegyik módszernek megvannak a maga egyedi előnyei és kompromisszumai, lehetővé téve a kereskedők számára, hogy a legmegfelelőbb megközelítést válasszák ki egyedi követelményeik és technikai képességeik alapján.

### 1. megközelítés: Egyedi böngészőkérések

Ez a megközelítés különálló backend hívásokat foglal magában az organikus termékekhez és a hirdetésekhez, csökkentve a backend módosításokat, és biztosítva, hogy a felhasználók mindig a legfrissebb találatokat lássák. Íme néhány előny a kereskedők számára ezen megközelítés használatából:

* **Csökkentett fejlesztési idő**: Könnyebben megvalósítható minimális backend változtatásokkal, fejlesztési időt és erőforrásokat megtakarítva.
* **Naprakész találatok**: Biztosítja a legfrissebb hirdetési tartalom megjelenítését, potenciálisan növelve a hirdetés relevanciáját és a felhasználói elköteleződést.

#### Munkafolyamat

Íme az események sorozata:

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

#### Amikor a hirdetések kiszolgálásra kerülnek

Böngészőkérések esetén a hirdetéskiszolgálás a következőképpen tér el a standard integrációtól:

**Kéréskezelés**

* A terméktalálatok rejtve maradnak a felhasználó elől, amíg az organikus találatok egyesítésre nem kerülnek a következőkkel: Epsilon Retail Media találatok.
* Ahelyett, hogy a meglévő backend szolgáltatása közvetlenül kérne adatokat a következőtől: Epsilon Retail Media, most egy új kereskedői szolgáltatást használ.
* A kereskedői szolgáltatás kezdeményezi a backend hívást a következők felé: Epsilon Retail Media a releváns elhelyezési információkkal.
* Annak ellenére, hogy külön lép kapcsolatba a háttérszerverrel és a következőkkel: Epsilon Retail Media az egyesítés előtt, továbbra is össze kell gyűjtenie az összes szükséges termékrészletet a megadott termékkódokhoz a következőkben: Epsilon Retail Media válasz.

**Tartalom egyesítése és kiszolgálása**

* A böngésző egyesíti az organikus találatokat és a következőt: Epsilon Retail Media találatok.
* Az egyesítés után a böngésző kiszolgálja a kombinált tartalmat a vásárlónak.

### 2. megközelítés: Egyesítés a vásárlónak történő megjelenítés után

Ez a megközelítés először az organikus tartalmat jeleníti meg, és utána egyesíti a hirdetéseket, ami minimális backend módosítást igényel, és biztosítja, hogy a felhasználók megszakítás nélkül hozzáférjenek az organikus találatokhoz.

#### Munkafolyamat

Ennél a megközelítésnél a korábbiakhoz hasonló munkafolyamatot követ; azonban az organikus termékeredményeket azonnal kiszolgálja a vásárlónak, amint azok elérhetővé válnak. Miután az organikus eredmények megjelentek, egyesíti és újrarendezi az eredményeket, amint megkapja a tartalmat a következőtől: Epsilon Retail Media. Valószínűleg ennek az integrációs módszernek az megvalósítása veszi igénybe a legkevesebb időt, mivel minimális fejlesztési erőforrást igényel.

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

#### Amikor a hirdetések megjelenítésre kerülnek

A szerves találatok először jelennek meg, és a Epsilon Retail Media válasz összefűzésre kerül, amint a böngésző megkapja. Esetenként a szerves találatok még a termékhirdetések összefűzése és újrarendezése előtt megjelennek a felhasználónak. Amikor a Epsilon Retail Media egy termékkód-listát ad meg Önnek, továbbra is le kell kérnie az összes vonatkozó részletes információt mindegyik termékhez.

## Integrációs módszerek összehasonlítása

Itt található az összes használható integrációs módszer gyors összehasonlítása:

|                                 | Standard integráció                                                  | Egyedi böngészőkérések                                                | Összefűzés a vásárlónak történő megjelenítés után                                                   |
| ------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Munkamenet                      | Egyetlen kérés a háttérrendszerhez, összefűzés a megjelenítés előtt  | Külön kérések a szerves termékekre és a hirdetésekre                  | A szerves tartalom jelenik meg először, a hirdetések utána kerülnek összefűzésre                    |
| Módosítások a háttérrendszerben | A meglévő háttérszolgáltatás kezeli a Epsilon Retail Media kéréseket | Új háttérszolgáltatás a következöhöz: Epsilon Retail Media kéréseket  | Minimális változtatások a meglévő háttérszolgáltatásokban                                           |
| Fejlesztési ráfordítás          | Mérsékelt                                                            | Alacsonyabb                                                           | Legalacsonyabb                                                                                      |
| Hirdetések összefűzése          | A háttérrendszer összefűzi a hirdetéseket a szerves tartalommal      | A böngésző összefűzi a hirdetéseket a szerves tartalommal             | A böngésző összefűzi a hirdetéseket a szerves tartalommal                                           |
| Hirdetések megjelenítése        | A hirdetések a szerves tartalommal együtt jelennek meg               | A hirdetések a szerves tartalommal együtt jelennek meg                | A hirdetések a szerves tartalommal együtt jelennek meg                                              |
| Előnyök                         | - Zökkenőmentes integráció - Egységes háttérrendszeri feldolgozás    | - Kevesebb módosítás a háttérrendszerben - Különálló hirdetési logika | - Gyors integráció - Minimális háttérrendszeri változtatások                                        |
| Hátrányok                       | - Mérsékelt fejlesztési ráfordítás - Egységes hirdetési logika       | - További háttérszolgáltatás - Különálló hirdetési logika             | - Esetleges késés a hirdetés megjelenítésében - A hirdetések a szerves tartalom után fűződnek össze |


---

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