> 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/partner/hu/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md).

# Epsilon Retail Media Partner API-k áttekintése

Üdvözöljük a Epsilon Retail Media Partner API-ban. Ez az útmutató segít az hirdetési platformunkkal való integrációban, hogy programozottan kezelhesse kampányait, tárcáit, csapatait és felhasználóit. Nyomon követheti a teljesítményt is, és hatékonyan növelheti vállalkozását.

## Mi az az API?

Az API az Application Programming Interface (alkalmazásprogramozási felület) rövidítése. Az API egy közvetítőként működik, amely lehetővé teszi két szoftverkomponens számára a kommunikációt funkciók és eljárások készletén keresztül. Az API-kat általában adatok lekérésére vagy küldésére használják, más alkalmazások funkcióihoz és szolgáltatásaihoz hozzáférve.

## Mi az a Partner API?

A Partner API-nk programozott hozzáférést biztosít szinte mindenhez, amit a Epsilon Webhelyen kampánykezelő platformok felhasználói felületén megtehet. Ez azt jelenti, hogy az alkalmazásban történő manuális kattintgatás helyett a rendszerei vagy fejlesztői közvetlenül csatlakozhatnak a platformunkhoz, és automatizálhatják, testreszabhatják vagy integrálhatják annak funkcióit a saját eszközeikbe vagy munkafolyamataikba.

A Partner API-t számos kiskereskedő és partner használja, beleértve az olyan aggregátorokat is, mint a Pacvue, a Skai és a Commerce IQ.

## API áttekintése

A Epsilon Retail Media Partner API lehetővé teszi a retail media programozott kezelését: [Campaigns](/retail-media-interface/partner/hu/campaign-management-api/productcampaign-1/createproductcampaign.md), [Team](/retail-media-interface/partner/hu/team-user-api/team.md) & [User](/retail-media-interface/partner/hu/team-user-api/user-1/createuserteaminvite.md), és [Wallets](/retail-media-interface/partner/hu/billing-api/wallet.md). Használja kampányok létrehozására és frissítésére több hirdetési formátumban, beleértve a Sponsored Product Ads (SPA-k), a statikus bannerek és a reszponzív Banner X ads lehetőséget.

A Partner API egy REST-alapú API, amely a megszokott GET, POST, PATCH és DELETE protokollokat használja JSON-adatterheléseken keresztül.

## Főbb előnyök

* Automatizálja a kampány-, csapat- és felhasználó-, valamint tárcaműveleteket REST API-végpontokon keresztül.
* Kezeljen hatékonyan több kampányt és erőforrást a tömeges műveletek támogatásával.
* Lassza el az API-hívások koordinálását, hogy azok illeszkedjenek a meglévő munkafolyamatához és rendszerarchitektúrájához.
* Hozzon létre és kezeljen kampányokat Sponsored Product Ads, Banner és Banner X formátumokban.
* Felhasználóikulcs-alapú hitelesítés korlátozott érvényességi idejű tokenekkel a biztonságos API-interakciók érdekében.

## Előfeltételek

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

A Partner API használata előtt győződjön meg arról, hogy az alábbi követelmények teljesülnek:

### Névtér-hozzáférés

Hozzáféréssel kell rendelkeznie a kijelölt névtérhez, amely az adatai és konfigurációi tárolójaként szolgál. Vegye fel a kapcsolatot a Epsilon Support csapattal a kiskereskedőire jellemző névtér-konfigurációs részletek beszerzéséhez.

### Csapattagság

Tagjának kell lennie egy beszállítói vagy elsődleges kiskereskedői csapatnak a megfelelő jogosultságokkal a névterén belül.

### API-felvételi kérelem

A hirdetési aggregátoroknak, ügynökségeknek és márkapartnerekenek API-felvételi kérelmet kell benyújtaniuk a Partner API-k használata előtt. Használja a hivatalos felvételi űrlapot, amelyre a következő cikk hivatkozik: [KB0040933 ](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)az új API-kapcsolat kezdeményezéséhez.

### Reporting API-hozzáférés

Hozzáféréssel kell rendelkeznie a Reporting API-hoz (BigQuery adattárház) a releváns táblák, például a dim\_product, dim\_catalog és dim\_placement lekérdezéséhez. Ez segít az integrációs felkészültség ellenőrzésében és a metaadatok felfedezésében.

### Szükséges metaadatok

Győződjön meg arról, hogy a termékkatalógus-, elhelyezés- és csapatinformációk létrejöttek és elérhetők a névtér alatt. Ezt a megfelelő BigQuery táblák lekérdezésével ellenőrizheti.

Ha nem rendelkezik hozzáféréssel a BigQuery-hez, igényelje azt a hivatalos API-hozzáférés-igénylő űrlapon keresztül. Szükségleteitől függően kérjük, olvassa el a megfelelő tudásbáziscikket:

* **Change/Remove Reporting BigQuery API Endpoint**: Meglévő API-végpont módosítása szükséges - [KB0040934](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040934).
* NEW Partner API (reporting API)\*\* - [KB0040947](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040947).

{% hint style="info" %}
Hozzáférési megjegyzés: A dokumentumban található egyes hivatkozások belső vagy korlátozott erőforrásokra mutatnak. A tartalom eléréséhez győződjön meg arról, hogy a megfelelő jogosultságokkal van bejelentkezve.
{% endhint %}

## Első lépések a Partner API-kkal

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

### Hitelesítési követelmények

A Partner API olyan engedélyezési folyamatot használ, amelyhez User Key szükséges. A hozzáférési tokenek a User Key Authentication API hívásával kérhetők le:

* A lekért User Key a kérés fejléces részében (header) kerül átadásra.
* A lekért Access Token ezt követően a Partner API-hoz intézett bármely metódushívásban felhasználásra kerül.
* A tokenek a generálástól számított csaknem 24 óra elteltével lejárnak.

{% hint style="info" %}
Új tokent kell kérni, amikor az előző lejár. Az ügyfélnek nem szabad új tokent generálnia az API-nk felé indított minden egyes kéréssel.
{% endhint %}

### API-hitelesítő adatok beszerzése

A Epsilon Retail Media Partner API-k használatának megkezdéséhez a következő információkra van szüksége. Ha nem biztos a részletekben, lépjen kapcsolatba a Support csapattal, vagy nyisson egy hibajegyet a segítségért.

* A hitelesítéshez használt user key.
* Az API-hívások indításához használt alapértelmezett URL (base URL).

### User key lekérése

1. Jelentkezzen be a Epsilon Retail Media csapata fiókjába.
2. Válasszon egy csapatot.
3. A profil menüpontból válassza a **User settings** lehetőséget.
4. Navigáljon a **User key** lapra.
5. Kattintson a **Show** gombra az API-kulcs megjelenítéséhez.

Használja ezt a kulcsot az API-kérések hitelesítéséhez. Epsilon Retail Media felhasználói kulcs alapú hitelesítést használ. Cserélje el a user key kulcsát egy időben korlátozott hozzáférési tokenre az API-kérések engedélyezéséhez. További információkért lásd: [Hitelesítési kérések](/retail-media-interface/partner/hu/partner-api-authentication/authenticating-requests.md).

### Szerezze meg a base URL-t

Lépjen kapcsolatba a Support csapattal a környezetéhez tartozó helyes base URL beszerzéséhez. Példa végpont:

```
https://campaign.<env>.citrusad.com/v3/campaigns
```

A user key birtokában hitelesítheti magát, és megkezdheti az API-hívások indítását a következőkhöz:

* Hirdetési kampányainak megtekintése és kezelése.
* Hirdetési költségkereteinek és költéseinek kezelése.
* Csapat- és felhasználói adatinak kezelése.

## A környezet beállítása

Epsilon Retail Media két különálló környezetet biztosít minden kereskedő számára: Production és Sandbox. Alapértelmezés szerint mindkét környezet létrejön a kereskedő regisztrációjakor.

### Sandbox környezet

{% hint style="info" %}
A Sandbox hozzáférést általában csak a kereskedők és az aggregátorok számára biztosítjuk. Ha nem biztos a jogosultságában, lépjen kapcsolatba az Ügyfélszolgálattal.
{% endhint %}

Használja ezt a biztonságos környezetet az integráció tesztelésére az élesítés előtt. A kereskedőknek ezt a környezetet kell használniuk az API-hívások ellenőrzésére, a katalógusfeltöltések tesztelésére, a kampánykészítés szimulálására és a teljes körű funkcionalitás biztosítására az élesítés előtt. Használja a sandboxot minden fejlesztési, tesztelési és minőségbiztosítási tevékenységhez. Minden kereskedő egyedi sandbox URL-lel rendelkezik, amely általában a következő formátumú:

```
https://<retailer>-sandbox.citrusad.com
```

A sandbox környezet a következőket tartalmazza:

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

### Production környezet

Csak a sandboxban végzett sikeres ellenőrzés után váltson production környezetre. A production környezetet az éles kampányokhoz és a valós idejű hirdetésmegjelenítéshez használjuk. Támogatja a teljes körű műveleteket, beleértve a katalógusfrissítéseket, a rendelések szinkronizálását és a hirdetési teljesítmény nyomon követését. A production URL a következő formátumot követi:

```
https://<namespace>.citrusad.com
```

A környezet használata előtt győződjön meg arról, hogy minden adat (katalógusok, termékek, rendelések) pontos és teljes.

{% hint style="info" %}
Az API-hívások indítása előtt mindig ellenőrizze a megfelelő környezetet, különösen a hitelesítő adatok és a base URL-ek használatakor. A base URL nem mindig egyezik meg a névtérrel, a kereskedő integrációs beállításaitól függően.
{% endhint %}

## Partner API végpontok

Epsilon Retail Media Az API alapvető funkciók készletét kínálja funkcionális kategóriákba csoportosítva, amelyeket dedikált végpontok támogatnak. Az alábbi táblázat összefoglalja a legfontosabb partnerközpontú API-kat, azok célját és a használt HTTP-metódusokat.

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

### Kampánykezelés

**Mi az a Szponzorált termék hirdetés?** A Szponzorált termék hirdetések (SPA) a kereskedő webhelyén található termékrácsokban elhelyezett hirdetések, amelyek jellemzően a keresési és kategóriaoldalakon, valamint a PDP-n és a kezdőlapon találhatók, az organikus találatok közé beágyazva.

**Mi az a Banner X Ad?** Banner X hirdetések teljesen reszponzív hirdetési egységek, amelyek a felhasználó nézetablakával együtt növekednek és változnak. Számos Kreatív anyag elemből állnak, a fő- és háttérképektől kezdve a címsor szövegén át a call-to-action gombokig.

**Mi az a Banner hirdetés?** A standard Banner egy statikus kép, amely mögött egy átkattintási URL található.

#### Termékkampány

| Végpont                                                                                                                                                               | Leírás                                                                           | Metódus |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------- |
| [Create a product campaign](/retail-media-interface/partner/hu/campaign-management-api/productcampaign-1/createproductcampaign.md)                                    | Új termékkampányt hoz létre a kérés törzsében megadott részletek használatával.  | POST    |
| [Retrieve list of all product campaigns](/retail-media-interface/partner/hu/campaign-management-api/productcampaign-1/listproductcampaigns.md)                        | Lekéri az összes termékkampány listáját a megadott paraméterek alapján.          | GET     |
| [Update a product campaign](/retail-media-interface/partner/hu/campaign-management-api/productcampaign-1/updateproductcampaign.md)                                    | Frissít egy meglévő termékkampányt a kampányazonosító használatával              | PATCH   |
| [Get product campaign by ID](/retail-media-interface/partner/hu/campaign-management-api/productcampaign-1/getproductcampaign-1.md)                                    | Lekéri a termékkampány részleteit a megadott kampányazonosítóhoz.                | GET     |
| [Change approval state of a product campaign](/retail-media-interface/partner/hu/campaign-management-api/productcampaign-1/approveproductcampaign-1.md)               | Frissíti egy megadott termékkampány jóváhagyási állapotát.                       | POST    |
| [Check booking feasibility for fixed tenancy campaigns](/retail-media-interface/partner/hu/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | Ellenőrzi, hogy a foglalás megvalósítható-e a Fix elhelyezés kampányok esetében. | POST    |

#### Banner X Kampány

| Végpont                                                                                                                                             | Leírás                                                                                                                                                                                      | Metódus |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Create a Banner X campaign](/retail-media-interface/partner/hu/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md)               | Új banner X kampányt hoz létre a kérés törzsében megadott részletek használatával.                                                                                                          | POST    |
| [Get Banner X campaign details](/retail-media-interface/partner/hu/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md)               | Lekéri a banner X kampány részleteit a megadott kampányazonosítóhoz.                                                                                                                        | GET     |
| [Update Banner X campaign](/retail-media-interface/partner/hu/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md)                   | Frissít egy meglévő Banner X kampányt a kampányazonosító és a frissített kampányadatok kérés törzsében történő megadásával.                                                                 | PATCH   |
| [Update Banner X campaign approval state](/retail-media-interface/partner/hu/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | Frissíti egy megadott banner X kampány jóváhagyási állapotát.                                                                                                                               | POST    |
| [Retrieve list of all Banner X campaigns](/retail-media-interface/partner/hu/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md)     | Lekéri a banner X kampányok listáját a megadott szűrők és paraméterek alapján, beleértve a kampány nevét, a elhelyezésazonosítót, a csapatazonosítót, a jóváhagyási állapotot és egyebeket. | GET     |

#### Bannerkampány

| Végpont                                                                                                                                     | Leírás                                                                          | Metódus |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------- |
| [Create a banner campaign](/retail-media-interface/partner/hu/campaign-management-api/bannercampaign/createbannercampaign-1.md)             | Új bannerkampányt hoz létre a kérés törzsében megadott részletek használatával. | POST    |
| [Get banner campaign details](/retail-media-interface/partner/hu/campaign-management-api/bannercampaign/getbannercampaign-1.md)             | Lekéri a bannerkampány részleteit a megadott kampányazonosítóhoz.               | GET     |
| [Update banner campaign](/retail-media-interface/partner/hu/campaign-management-api/bannercampaign/updatebannercampaign.md)                 | Frissít egy meglévő bannerkampányt a kampányazonosító használatával.            | PATCH   |
| [Update banner campaign approval state](/retail-media-interface/partner/hu/campaign-management-api/bannercampaign/approvebannercampaign.md) | Frissíti egy megadott bannerkampány jóváhagyási állapotát                       | POST    |

#### Kampányfájlok

| Végpont                                                                                                                       | Leírás                                                                              | Metódus |
| ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------- |
| [Upload a campaign file](/retail-media-interface/partner/hu/campaign-management-api/creativeassets/uploadfile.md)             | Különböző típusú kampányfájlokat tölt fel                                           | POST    |
| [Retrieve campaign file URL](/retail-media-interface/partner/hu/campaign-management-api/creativeassets/getcampaignfileurl.md) | Lekéri egy kampányfájl URL-jét a megadott fájlazonosító és fájltípus használatával. | POST    |

#### Tartalmi szabvány

| Végpont                                                                                                                                                                   | Leírás                                                                                                                                                              | Metódus |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Get Banner X content standard details](/retail-media-interface/partner/hu/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md)                 | Lekéri a Banner X tartalmi szabvány részleteit a megadott tartalmi szabvány azonosítójához.                                                                         | GET     |
| [Retrieve list content standards for Banner X campaigns](/retail-media-interface/partner/hu/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md) | Lekéri a tartalmi szabványok listáját a következöhöz: Banner X kampányok a megadott paraméterek alapján, mint például névtér, név és tartalmi szabvány azonosítója. | GET     |
| [Get banner content standard details](/retail-media-interface/partner/hu/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md)                      | Lekéri a Banner tartalmi szabvány részleteit a megadott tartalmi szabvány azonosítójához.                                                                           | GET     |
| [Retrieve list content standards for banner campaigns](/retail-media-interface/partner/hu/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md)    | Lekéri a tartalmi szabványok listáját a bannerkampányokhoz a megadott paraméterek alapján, mint például névtér, név és tartalmi szabvány azonosítója.               | GET     |

#### Kampány

| Végpont                                                                                                                                    | Leírás                                                                                                                                                                                        | Metódus |
| ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Retrieve list of all campaigns](/retail-media-interface/partner/hu/campaign-management-api/campaign/listcampaigns-1.md)                   | Lekéri a kampányok listáját a megadott szűrők és paraméterek alapján, beleértve a kampány nevét, kampány típusát, elhelyezésazonosítót, csapatazonosítót, jóváhagyási állapotot és egyebeket. | POST    |
| [Retrieve campaign history](/retail-media-interface/partner/hu/campaign-management-api/campaign/getcampaignhistory.md)                     | Lekéri egy kampány előzményeit a kampányazonosítója segítségével.                                                                                                                             | GET     |
| [Retrieve minimum bid details for keywords](/retail-media-interface/partner/hu/campaign-management-api/campaign/retrievekeywordsminbid.md) | Lekéri az egyedi minimális ajánlati részleteket és a teljes kampány minimális ajánlatát egy megadott kulcsszótömbhöz Keresési és Kategória és Keresési elhelyezéstípusú kampányokban.         | POST    |
| [Retrieve minimum bid details for category](/retail-media-interface/partner/hu/campaign-management-api/campaign/retrievecategoryminbid.md) | Lekéri az egyedi minimális ajánlati részleteket és a teljes kampány minimális ajánlatát kategória elhelyezéstípusú kampányokhoz.                                                              | POST    |

## Kreatív anyag eszközkezelése

### Mi az a Kreatív anyag eszköz?

A Kreatív anyag eszközök a Banner- és Banner X kampányokban használt képek. Ezeknek az eszközöknek meg kell felelniük a konkrét technikai követelményeknek a megfelelő megjelenítés és teljesítmény biztosítása érdekében.

### Feltöltési irányelvek:

* Fájlméret < 4 MB
* Fájltípusok: PNG, JPEG, JPG, GIF, SVG és PDF
* Egyszerre egy fájl
* A csapatazonosító, a helyazonosító és a tartalmi szabvány azonosítója kötelező
* Adja meg a fájl teljes abszolút elérési útját

{% hint style="info" %}
A kreatív elemek feltöltése a fentebbi Kampánykezelés szakaszban felsorolt Kampányfájl végpontokon keresztül történik.
{% endhint %}

## Tartalmi szabványok kezelése

### Mi az a tartalmi szabvány?

A tartalmi szabványok olyan irányelvek és műszaki paraméterek, amelyek meghatározzák, hogyan jelenjen meg egy banner vagy Banner X hirdetés egy weboldal vagy digitális platform kijelölt helyén. A szabványok olyan paramétereket tartalmaznak, mint a dimenziók és a méret, a fájlformátum és a fájlméretek, a felbontás és a minőség, a pozicionálás és az igazítás, a tartalmi korlátozások, valamint az interaktivitás.

### Csapat- és felhasználókezelés

#### Mi az a csapat?

A csapat felhasználók összessége, amely besorolása szerint lehet beszállítói (hirdetői) vagy kereskedői csapat. A beszállítói csapatok általában kampányokat hoznak létre, míg a kereskedők áttekintik a kampányokat és adminisztratív feladatokat látnak el. A rendszer egy felhasználója több csapathoz vagy csak egyhez is tartozhat. Jellemzően egy csapathoz felhasználók, kampányok és tárcák kapcsolódnak.

#### Team

| Végpont                                                                                         | Leírás                                                                                                                            | Metódus |
| ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Create team](/retail-media-interface/partner/hu/team-user-api/team/createteam-1.md)            | Új csapatot hoz létre.                                                                                                            | POST    |
| Csapat frissítése                                                                               | Frissíti a team\_id által meghatározott csapat adatait.                                                                           | PATCH   |
| Összes csapat listázása                                                                         | Lekéri a csapatok listáját olyan paraméterek megadásával, mint a name, a namespace\_id és a seller\_id.                           | GET     |
| [Get team for specified ID](/retail-media-interface/partner/hu/team-user-api/team/getteam-1.md) | Részletes információkat kér le egy adott csapatról, beleértve annak tagjait is.                                                   | GET     |
| Csatlakozás egy csapathoz meghívó token használatával                                           | Lehetővé teszi a felhasználók számára, hogy egy érvényes és le nem járt meghívó token használatával csatlakozzanak egy csapathoz. | POST    |

#### User

| Végpont                                                                                                      | Leírás                                                                                           | Metódus |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------- |
| [Invite a user to the team](/retail-media-interface/partner/hu/team-user-api/user-1/createuserteaminvite.md) | Meghívót küld egy felhasználónak, hogy csatlakozzon egy megadott csapathoz.                      | POST    |
| Felhasználói adatok lekérése felhasználói azonosító alapján                                                  | Lekéri a platformra jelenleg bejelentkezett felhasználó Epsilon Retail Media adatait.            | GET     |
| [Retrieve user details](/retail-media-interface/partner/hu/team-user-api/user-1/getusersforteam.md)          | Lekéri a felhasználói adatokat a megadott csapatazonosító alapján.                               | GET     |
| [Update current user detail](/retail-media-interface/partner/hu/team-user-api/user-1/updateuserprofile.md)   | Módosítja a jelenleg bejelentkezett felhasználó adatait a Epsilon Retail Media adatait.          | PATCH   |
| [Modify user permission](/retail-media-interface/partner/hu/team-user-api/user-1/modifyuserpermission.md)    | Frissíti a felhasználó jogosultságait a felhasználói azonosító és a csapatazonosító megadásával. | PATCH   |
| [Upload a file](/retail-media-interface/partner/hu/team-user-api/user-1/uploadfile-1.md)                     | Logókat tölt fel felhasználói profilokhoz és csapatokhoz.                                        | POST    |
| [Retrieve file URL](/retail-media-interface/partner/hu/team-user-api/user-1/getfileurl.md)                   | Lekéri egy csapat vagy felhasználó logójának URL-jét a megadott fájlazonosító használatával.     | POST    |
| Felhasználó eltávolítása                                                                                     | Eltávolít egy felhasználót a csapatból.                                                          | DELETE  |

### Számlázási és tárcakezelés

#### Mi az a tárca?

A tárca a hirdető pénzeszközeit tárolja fizetési célokból (pl. a megvalósult hirdetések kifizetésére).

#### Tárca

| Végpont                                                                                                           | Leírás                                                                                                                                                             | Metódus |
| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
| [Create a wallet](/retail-media-interface/partner/hu/billing-api/wallet/createwallet.md)                          | Létrehoz egy tárcát a megadott névtéren belül, és hozzárendeli egy csapathoz a csapatazonosító használatával.                                                      | POST    |
| [Update a wallet](/retail-media-interface/partner/hu/billing-api/wallet/updatewallet-1.md)                        | Frissít egy tárcát a megadott névtéren és teamId-n belül.                                                                                                          | PATCH   |
| [Retrieve wallet by ID](/retail-media-interface/partner/hu/billing-api/wallet/getwallet-1.md)                     | Lekéri egy adott tárca adatait annak egyedi azonosítója, a {id} használatával.                                                                                     | GET     |
| [List all wallets](/retail-media-interface/partner/hu/billing-api/wallet/listwallets.md)                          | Lekéri a tárcák listáját a megadott szűrők és paraméterek alapján, beleértve a csapatazonosítót, a tárcanevet, a tárcaazonosítót, a külső azonosítót és egyebeket. | GET     |
| [Get the balance of a specific wallet](/retail-media-interface/partner/hu/billing-api/wallet/getwalletbalance.md) | Lekéri egy megadott tárca aktuális egyenlegét.                                                                                                                     | GET     |
| [Manage funds to a specific wallet](/retail-media-interface/partner/hu/billing-api/wallet/managefunds.md)         | Pénzeszköz-műveleteket kezel egy adott tárca esetében.                                                                                                             | POST    |

#### Költés

| Végpont                                                                                                     | Leírás                                                                                                         | Metódus |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ------- |
| [Retrieve campaign spend details](/retail-media-interface/partner/hu/billing-api/spend/getcampaignspend.md) | Kiszámítja a megadott kampányok fennmaradó költségkeretét az elérhető egyenlegük és költési korlátaik alapján. | POST    |

### Tömeges művelet

#### Kampány

| Végpont                                                                                                                                | Leírás                                                                                                 | Metódus |
| -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------- |
| [Create campaigns in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md)         | Több kampányt hoz létre szimultán (akár 1 000-et) a kampány típusa alapján.                            | POST    |
| [Update campaigns in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md)       | Frissíti a kampányokat egy megadott névtéren belül.                                                    | PATCH   |
| [Update campaign approval state](/retail-media-interface/partner/hu/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | Jóváhagyja vagy elutasítja a kampányokat egy megadott névtéren belül.                                  | POST    |
| Tömeges művelet állapotának lekérése                                                                                                   | Lekéri egy tömeges kampányművelet állapotát és adatait a tömeges művelet azonosítójának használatával. | GET     |

#### Tárca

| Végpont                                                                                                                                 | Leírás                                                                             | Metódus |
| --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------- |
| [Create wallets in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md)                | Hozzon létre egyszerre több tárcát a szervezetén belül (akár 1 000-et).            | POST    |
| [Retrieve bulk wallet operation status](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | Lekéri egy tömeges tárcaművelet állapotát annak tömeges azonosítója használatával. | GET     |
| [Update wallets in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md)                | Több tárcát frissít szimultán.                                                     | PATCH   |

#### Team

| Végpont                                                                                                                               | Leírás                                                                              | Metódus |
| ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------- |
| [Create teams in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md)                | Tömeges csapatot hoz létre egy szervezet számára.                                   | POST    |
| [Update teams in bulk](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md)                | Több csapatot frissít szimultán.                                                    | PATCH   |
| [Retrieve bulk team operation status](/retail-media-interface/partner/hu/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | Lekéri egy tömeges csapatművelet állapotát annak tömeges azonosítója használatával. | GET     |

### Javasolt keresési kifejezés

#### Mmik azok a javasolt keresési kifejezések?

A javasolt keresési kifejezések olyan kifejezések gyűjteményei, amelyeket a kereskedő egy fájlon keresztül bocsát rendelkezésre, termékeket rendelve konkrét kifejezésekhez, amelyeket megjelenítenek a felhasználónak, amikor kampányt hoz létre a keresési kifejezések lépésnél. További információért lásd: Javasolt keresési kifejezések.

| Végpont                                                                                                                                          | Leírás                                                                                                                                                 | Metódus |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
| [Lists all suggested search terms](/retail-media-interface/partner/hu/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | Lekéri a katalóguscélzáshoz javasolt keresési kifejezéseket a megadott paraméterek alapján, mint például a katalógusazonosító, a termékkód és egyebek. | GET     |

## Bevált gyakorlatok

Kövesse ezeket a bevált gyakorlatokat a zökkenőmentes, hatékony és megbízható integráció biztosításához a Epsilon Retail Media Partner API-kkal:

* A éles bevezetés előtt mindig teszteljen a sandbox környezetben.
* Használjon tömeges végpontokat a többszörös műveletekhez.
* Hibaingerek esetén ellenőrizze a konkrét adatproblémákat.
* A gyorsabb adatfeltöltés érdekében használjon tömörített fájlokat.
* A hozzáférési tokeneket csak akkor frissítse, ha lejártak.
* A kötelező mezők ellenőrzése a kérések elküldése előtt.

## Hibakezelés

Partner API-jaink strukturált JSON hiba-válaszokat adnak vissza a robusztus kivételkezelés támogatása érdekében.

* **HTTP-státuszkód**: Standard hibakódok (400, 401, 403, 500 stb.)
* **Hibakód**: Meghatározott hibaazonosító.
* **Üzenet**: Ember által olvasható hibaleírás.
* **Mezőmegsértések**: Meghatározott mező-ellenőrzési hibák az adatbeviteli problémák esetén.

A részletes hibakezelési információkért lásd: [Hibakezelés](/retail-media-interface/partner/hu/partner-api-overview/error-handling.md).

## Támogatás és erőforrások

| Erőforrás                                                                                                           | Leírás                                                                             |
| ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [Frequently asked questions](/retail-media-interface/partner/hu/partner-api-overview/frequently-asked-questions.md) | Gyakori kérdések és válaszok az API használatával és integrációjával kapcsolatban. |
| Kiadási megjegyzések                                                                                                | Az API legutóbbi frissítéseinek vagy módosításainak összefoglalása.                |
| [Glossary](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1)                             | Az API-dokumentációban használt főbb kifejezések meghatározásai.                   |


---

# 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/partner/hu/partner-api-overview/epsilon-retail-media-partner-apis-overview-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.