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

# Prehľad Epsilon Retail Media Partner API

Vítajte v dokumentácii k Epsilon Retail Media Partner API. Táto príručka vám pomôže s integráciou do našej reklamnej platformy na programovú správu vašich kampaní, peňaženiek, tímov a používateľov. Môžete tiež sledovať výkonnosť a efektívne rozvíjať svoje podnikanie.

## Čo je to API?

Skratka API znamená Application Programming Interface (rozhranie pre programovanie aplikácií). API funguje ako sprostredkovateľ, ktorý umožňuje dvom softvérovým komponentom komunikovať pomocou súboru funkcií a postupov. Rozhrania API sa bežne používajú na získavanie alebo odosielanie údajov a prístup k funkciám a službám z iných aplikácií.

## Čo je Partner API?

Naše Partner API vám poskytuje programový prístup k témam takmer všetkému, čo môžete robiť v Epsilon používateľskom rozhraní platforiem Na webe Campaign Management. To znamená, že namiesto manuálneho klikania v aplikácii sa vaše systémy alebo vývojári môžu pripojiť priamo k našej platforme a automatizovať, prispôsobovať alebo integrovať jej funkcie do vašich vlastných nástrojov alebo pracovných postupov.

Partner API využívajú mnohí maloobchodníci a partneri vrátane agregátorov ako Pacvue, Skai a Commerce IQ.

## Prehľad API

Rozhranie Epsilon Retail Media Partner API umožňuje programovú správu retailových médií [Campaigns](/retail-media-interface/partner/sk/campaign-management-api/productcampaign-1/createproductcampaign.md), [Team](/retail-media-interface/partner/sk/team-user-api/team.md) & [User](/retail-media-interface/partner/sk/team-user-api/user-1/createuserteaminvite.md)a [Wallets](/retail-media-interface/partner/sk/billing-api/wallet.md). Použite ho na vytváranie a aktualizáciu kampaní naprieč viacerými formátmi reklamy vrátane Sponsored Product Ads (SPA), statických bannerov a responzívnych Banner X ads.

Naše Partner API je rozhranie API typu REST, ktoré používa bežné protokoly GET, POST, PATCH a DELETE prostredníctvom dátových prenosov JSON.

## Kľúčové výhody

* Automatizujte operácie kampaní, tímov, používateľov a peňaženiek prostredníctvom koncových bodov REST API.
* Spravujte viacero kampaní a zdrojov efektívne vďaka podpore hromadných operácií.
* Umožňujú vám orchestrať volania API tak, aby vyhovovali vášmu existujúcemu pracovnému postupu a architektúre systému.
* Vytvárajte a spravujte kampane naprieč sponzorovanými produktovými reklamami, bannerovými reklamami a Banner X formátmi.
* Autentifikácia na základe používateľského kľúča s časovo obmedzenými tokenmi pre bezpečnú interakciu s API.

## Predpoklady

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

Pred použitím API pre partnerov uistite sa, že sú splnené nasledujúce požiadavky:

### Prístup k priestoru názvov

Musíte mať prístup ku svojmu určenému priestoru názvov, ktorý slúži ako kontajner pre vaše údaje a konfigurácie. Obráťte sa na Epsilon tím podpory, aby ste získali podrobnosti o konfigurácii priestoru názvov špecifické pre vašich maloobchodníkov.

### Členstvo v tíme

Musíte byť súčasťou tímu dodávateľa alebo primárneho maloobchodníka s príslušnými oprávneniami v rámci vášho priestoru názvov.

### Žiadosť o prístup k API

Agregátori reklám, agentúry a značkoví partneri musia pred použitím API pre partnerov podať žiadosť o prístup k API. Použite oficiálny formulár žiadosti uvedený v [KB0040933 ](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)na iniciovanie nového pripojenia API.

### Prístup k API pre prehľady

Musíte mať prístup k API pre prehľady (dátový sklad BigQuery) na dopytovanie príslušných tabuliek, ako sú dim\_product, dim\_catalog a dim\_placement. Pomôže to overiť pripravenosť integrácie a preskúmať metaúdaje.

### Vyžadované metadáta

Uistite sa, že váš produktový katalóg, umiestnenie a informácie o tíme sú vytvorené a dostupné vo vašom priestore názvov (namespace). Môžete to overiť dotazovaním príslušných tabuliek v BigQuery.

Ak nemáte prístup k BigQuery, požiadajte oň prostredníctvom oficiálneho formulára žiadosti o prístup k API. V závislosti od vašich potrieb si pozrite príslušný článok v znalostnej databáze:

* **Zmena/Odstránenie koncového bodu BigQuery API pre prehľady**: Potrebujete upraviť existujúci koncový bod API - [KB0040934](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040934).
* NOVÉ 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" %}
Poznámka k prístupu: Niektoré odkazy v tomto dokumente ukazujú na interné alebo vyhradené zdroje. Uistite sa, že ste prihlásení s príslušnými prístupovými údajmi na získanie prístupu k obsahu.
{% endhint %}

## Začíname s Partner APIs

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

### Požiadavky na autentifikáciu

Partner API využíva autorizačný proces vyžadujúci User Key. Prístupové tokeny sa získavajú volaním User Key Authentication API:

* Váš získaný User Key sa odosiela v hlavičke tejto žiadosti.
* Získaný Access Token sa následne používa pri akýchkoľvek volaniach metód do Partner API.
* Platnosť tokenov vyprší niečo menej ako 24 hodín od ich vygenerovania.

{% hint style="info" %}
Po vypršaní platnosti predchádzajúceho tokenu by ste mali požiadať o nový. Klient by nemal generovať nový token pri každej žiadosti na naše API.
{% endhint %}

### Získajte svoje prístupové údaje k API

Ak chcete začať používať Epsilon Retail Media Partner APIs, potrebujete nasledujúce informácie. Ak si nie ste istí niektorými detailmi, kontaktujte svoju podporu alebo vytvorte tiket a požiadajte o pomoc.

* Váš user key pre autentifikáciu.
* Základná URL adresa na vykonávanie volaní API.

### Získajte svoj User key

1. Prihláste sa do svojho Epsilon Retail Media tímového účtu.
2. Vyberte tím.
3. Z rozbaľovacej ponuky profilu vyberte **User settings**.
4. Prejdite na kartu **User key**.
5. Kliknutím na **Show** zobrazíte svoj API kľúč.

Tento kľúč použite na autentifikáciu svojich požiadaviek API. Epsilon Retail Media používa autentifikáciu založenú na user key. Vymeňte svoj user key za časovo obmedzený prístupový token na autorizáciu požiadaviek API. Ďalšie informácie nájdete v časti [Požiadavky na autentifikáciu](/retail-media-interface/partner/sk/partner-api-authentication/authenticating-requests.md).

### Získajte svoju základnú URL adresu

Kontaktujte svoju podporu a získajte správnu základnú URL adresu pre vaše prostredie. Príklad koncového bodu:

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

Keď máte svoj user key, môžete sa autentifikovať a začať vykonávať volania API na:

* Zobrazujte a spravujte svoje reklamné kampane.
* Spravujte svoje reklamné rozpočty a výdavky.
* Spravujte podrobnosti o svojom tíme a používateľoch.

## Nastavenie prostredia

Epsilon Retail Media poskytuje dve odlišné prostredia pre každého predajcu: Produkcia a Sandbox. Obe prostredia sú predvolene vytvorené pri onboardingu predajcu.

### Prostredie Sandbox

{% hint style="info" %}
Prístup do Sandboxu sa zvyčajne poskytuje len predajcom a agregátorom. Ak si nie ste istí svojím nárokom, kontaktujte podporu.
{% endhint %}

Použite toto bezpečné prostredie na testovanie vašej integrácie pred spustením do ostrej prevádzky. Predajcovia musia toto prostredie používať na overenie volaní API, testovanie nahrávania katalógov, simuláciu vytvárania kampaní a zabezpečenie funkčnosti end-to-end pred spustením do ostrej prevádzky. Sandbox používajte na všetky vývojové, testovacie a QA aktivity. Každý predajca má unikátnu URL adresu Sandboxu, zvyčajne vo formáte:

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

Prostredie sandbox obsahuje:

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

### Produkčné prostredie

Na produkciu prejdite až po úspešnom overení v sandboxe. Produkčné prostredie sa používa pre živé kampane a doručovanie reklám v reálnom čase. Podporuje plnohodnotné operácie vrátane aktualizácií katalógu, synchronizácie objednávok a sledovania výkonnosti reklám. Produkčná URL adresa má nasledujúci formát:

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

Pred použitím tohto prostredia sa uistite, že všetky údaje (katalógy, produkty, objednávky) sú presné a úplné.

{% hint style="info" %}
Pred vykonaním volaní API vždy potvrďte správne prostredie, najmä pri použití prihlasovacích údajov a základných URL adries. Základná URL adresa nemusí vždy zodpovedať mennému priestoru v závislosti od nastavenia integrácie predajcu.
{% endhint %}

## Koncové body Partner API

Epsilon Retail Media API ponúka množstvo základných funkcií zoskupených do funkčných kategórií, z ktorých každá je podporovaná vyhradenými koncovými bodmi. Tabuľka nižšie zhrňuje kľúčové API určené pre partnerov, ich účel a použité metódy HTTP.

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

### Správa kampaní

**Čo je reklama na sponzorovaný produkt (Sponsored Product Ad)?** Sponzorované produkty (SPA) sú reklamy umiestnené v produktových mriežkach na stránke predajcu, ktoré sa zvyčajne nachádzajú na vyhľadávacích a kategóriových stránkach, ako aj na PDP a domovskej stránke, vložene medzi organickými produktmi.

**Čo je Banner X Ad?** Banner X reklamy sú plne responzívne reklamné jednotky, ktoré sa zväčšujú a meňu s výhľadom používateľa. Skladajú sa z mnohých prvkov reklamného materiálu od hlavných obrázkov a obrázkov na pozadí až po text nadpisu a tlačidlá s výzvou na akciu.

**Čo je bannerová reklama?** Štandardný banner je statický obrázok s preklikom na URL adresu za ním.

#### Produktová kampaň

| Koncový bod                                                                                                                                                           | Popis                                                                          | Metóda |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ------ |
| [Create a product campaign](/retail-media-interface/partner/sk/campaign-management-api/productcampaign-1/createproductcampaign.md)                                    | Vytvorí novú produktovú kampaň pomocou údajov poskytnutých v tele požiadavky.  | POST   |
| [Retrieve list of all product campaigns](/retail-media-interface/partner/sk/campaign-management-api/productcampaign-1/listproductcampaigns.md)                        | Získa zoznam všetkých produktových kampaní na základe poskytnutých parametrov. | GET    |
| [Update a product campaign](/retail-media-interface/partner/sk/campaign-management-api/productcampaign-1/updateproductcampaign.md)                                    | Aktualizuje existujúcu produktovú kampaň pomocou ID kampane                    | PATCH  |
| [Get product campaign by ID](/retail-media-interface/partner/sk/campaign-management-api/productcampaign-1/getproductcampaign-1.md)                                    | Získa podrobnosti o produktovej kampani pre špecifikované ID kampane.          | GET    |
| [Change approval state of a product campaign](/retail-media-interface/partner/sk/campaign-management-api/productcampaign-1/approveproductcampaign-1.md)               | Aktualizuje stav schválenia špecifikovanej produktovej kampane.                | POST   |
| [Check booking feasibility for fixed tenancy campaigns](/retail-media-interface/partner/sk/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | Kontroluje, či je možná rezervácia pre kampane typu Fixné umiestnenie.         | POST   |

#### Banner X Kampaň

| Koncový bod                                                                                                                                         | Popis                                                                                                                                                           | Metóda |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Create a Banner X campaign](/retail-media-interface/partner/sk/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md)               | Vytvorí novú kampaň typu banner X pomocou údajov poskytnutých v tele požiadavky.                                                                                | POST   |
| [Get Banner X campaign details](/retail-media-interface/partner/sk/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md)               | Získa podrobnosti o kampani typu banner X pre špecifikované ID kampane.                                                                                         | GET    |
| [Update Banner X campaign](/retail-media-interface/partner/sk/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md)                   | Aktualizuje existujúcu Banner X kampaň poskytnutím ID kampane a aktualizovaných údajov o kampani v tele požiadavky.                                             | PATCH  |
| [Update Banner X campaign approval state](/retail-media-interface/partner/sk/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | Aktualizuje stav schválenia špecifikovanej kampane typu banner X.                                                                                               | POST   |
| [Retrieve list of all Banner X campaigns](/retail-media-interface/partner/sk/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md)     | Získa zoznam kampaní typu banner X na základe špecifikovaných filtrov a parametrov, vrátane názvu kampane, ID umiestnenia, ID tímu, stavu schválenia a ďalších. | GET    |

#### Bannerová kampaň

| Koncový bod                                                                                                                                 | Popis                                                                        | Metóda |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------ |
| [Create a banner campaign](/retail-media-interface/partner/sk/campaign-management-api/bannercampaign/createbannercampaign-1.md)             | Vytvorí novú bannerovú kampaň pomocou údajov poskytnutých v tele požiadavky. | POST   |
| [Get banner campaign details](/retail-media-interface/partner/sk/campaign-management-api/bannercampaign/getbannercampaign-1.md)             | Získa podrobnosti o bannerovej kampani pre špecifikované ID kampane.         | GET    |
| [Update banner campaign](/retail-media-interface/partner/sk/campaign-management-api/bannercampaign/updatebannercampaign.md)                 | Aktualizuje existujúcu bannerovú kampaň pomocou ID kampane.                  | PATCH  |
| [Update banner campaign approval state](/retail-media-interface/partner/sk/campaign-management-api/bannercampaign/approvebannercampaign.md) | Aktualizuje stav schválenia špecifikovanej bannerovej kampane                | POST   |

#### Súbory kampane

| Koncový bod                                                                                                                   | Popis                                                                            | Metóda |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------ |
| [Upload a campaign file](/retail-media-interface/partner/sk/campaign-management-api/creativeassets/uploadfile.md)             | Nahráva rôzne typy súborov kampane                                               | POST   |
| [Retrieve campaign file URL](/retail-media-interface/partner/sk/campaign-management-api/creativeassets/getcampaignfileurl.md) | Získa URL adresu súboru kampane pomocou špecifikovaného ID súboru a typu súboru. | POST   |

#### Štandard obsahu

| Koncový bod                                                                                                                                                               | Popis                                                                                                                                           | Metóda |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Get Banner X content standard details](/retail-media-interface/partner/sk/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md)                 | Získa Banner X podrobnosti o štandarde obsahu pre špecifikované ID štandardu obsahu.                                                            | GET    |
| [Retrieve list content standards for Banner X campaigns](/retail-media-interface/partner/sk/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md) | Získa zoznam štandardov obsahu pre Banner X kampane na základe špecifikovaných parametrov, ako sú menný priestor, názov a ID štandardu obsahu.  | GET    |
| [Get banner content standard details](/retail-media-interface/partner/sk/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md)                      | Získa podrobnosti o štandarde obsahu bannera pre špecifikované ID štandardu obsahu.                                                             | GET    |
| [Retrieve list content standards for banner campaigns](/retail-media-interface/partner/sk/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md)    | Získa zoznam štandardov obsahu pre bannerové kampane na základe špecifikovaných parametrov, ako sú menný priestor, názov a ID štandardu obsahu. | GET    |

#### Kampaň

| Koncový bod                                                                                                                                | Popis                                                                                                                                                                                                      | Metóda |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Retrieve list of all campaigns](/retail-media-interface/partner/sk/campaign-management-api/campaign/listcampaigns-1.md)                   | Získa zoznam kampaní na základe špecifikovaných filtrov a parametrov, vrátane názvu kampane, typu kampane, ID umiestnenia, ID tímu, stavu schválenia a ďalších.                                            | POST   |
| [Retrieve campaign history](/retail-media-interface/partner/sk/campaign-management-api/campaign/getcampaignhistory.md)                     | Získa históriu kampane pomocou jej ID kampane.                                                                                                                                                             | GET    |
| [Retrieve minimum bid details for keywords](/retail-media-interface/partner/sk/campaign-management-api/campaign/retrievekeywordsminbid.md) | Získa podrobnosti o jednotlivých minimálnych ponukách a celkovú minimálnu ponuku kampane pre pole špecifikovaných kľúčových slov v kampaniach s typom umiestnenia Vyhľadávanie a Kategória a vyhľadávanie. | POST   |
| [Retrieve minimum bid details for category](/retail-media-interface/partner/sk/campaign-management-api/campaign/retrievecategoryminbid.md) | Získa podrobnosti o jednotlivých minimálnych ponukách a celkovú minimálnu ponuku kampane pre kampane s typom umiestnenia Kategória.                                                                        | POST   |

## Správa prvkov reklamných materiálov

### Čo je prvok reklamného materiálu?

Prvky reklamných materiálov sú obrázky použité v bannerových a Banner X kampaniach. Tieto prvky musia spĺňať špecifické technické požiadavky, aby sa zabezpečilo ich správne zobrazenie a výkon.

### Pravidlá nahrávania:

* Veľkosť súboru < 4 MB
* Typy súborov: PNG, JPEG, JPG, GIF, SVG a PDF
* Vždy len jeden súbor
* ID tímu, ID pozície a ID štandardu obsahu sú povinné
* Poskytnite úplnú absolútnu cestu k súboru

{% hint style="info" %}
Nahrávanie podkladov reklamných materiálov sa spracováva prostredníctvom koncových bodov Campaign File uvedených v sekcii Správa kampaní vyššie.
{% endhint %}

## Správa obsahových štandardov

### Čo je obsahový štandard?

Obsahové štandardy sú pravidlá a technické parametre, ktoré určujú, ako sa má banner alebo Banner X reklama zobrazovať na vyhradenom mieste na webovej lokalite alebo digitálnej platforme. Štandardy zahŕňajú parametre, ako sú rozmery a veľkosť, formát a veľkosti súborov, rozlíšenie a kvalita, umiestnenie a zarovnanie, obmedzenia obsahu a interaktivita.

### Správa tímov a používateľov

#### Čo je tím?

Tím je skupina používateľov a klasifikuje sa buď ako tím dodávateľa (inzerenta), alebo tím predajcu. Tímy dodávateľov zvyčajne vytvárajú kampane, zatiaľ čo predajcovia kontrolovali kampane a vykonávajú administratívne úlohy. Používateľ v systéme môže patriť do viacerých tímov alebo len do jedného. Tím má zvyčajne s ním spojených používateľov, kampane a peňaženky.

#### Team

| Koncový bod                                                                                     | Popis                                                                                           | Metóda |
| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------ |
| [Create team](/retail-media-interface/partner/sk/team-user-api/team/createteam-1.md)            | Vytvorí nový tím.                                                                               | POST   |
| Aktualizovať tím                                                                                | Aktualizuje podrobnosti tímu určeného pomocou team\_id.                                         | PATCH  |
| Zoznam všetkých tímov                                                                           | Získa zoznam tímov na základe poskytnutých parametrov, ako sú name, namespace\_id a seller\_id. | GET    |
| [Get team for specified ID](/retail-media-interface/partner/sk/team-user-api/team/getteam-1.md) | Získa podrobné informácie o konkrétnom tíme vrátane jeho členov.                                | GET    |
| Pripojiť sa k tímu pomocou pozývacieho tokenu                                                   | Umožňuje používateľom pripojiť sa k tímu pomocou platného a neexpirovaného pozývacieho tokenu.  | POST   |

#### User

| Koncový bod                                                                                                  | Popis                                                                                                | Metóda |
| ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- | ------ |
| [Invite a user to the team](/retail-media-interface/partner/sk/team-user-api/user-1/createuserteaminvite.md) | Odošle pozvánku používateľovi, aby sa pripojil ku konkrétnemu tímu.                                  | POST   |
| Získať podrobnosti o používateľovi pomocou ID používateľa                                                    | Získa podrobnosti o používateľovi, ktorý je momentálne prihlásený do Epsilon Retail Media platformy. | GET    |
| [Retrieve user details](/retail-media-interface/partner/sk/team-user-api/user-1/getusersforteam.md)          | Získa podrobnosti o používateľovi na základe poskytnutého ID tímu.                                   | GET    |
| [Update current user detail](/retail-media-interface/partner/sk/team-user-api/user-1/updateuserprofile.md)   | Upravuje podrobnosti momentálne prihláseného používateľa v Epsilon Retail Media platformy.           | PATCH  |
| [Modify user permission](/retail-media-interface/partner/sk/team-user-api/user-1/modifyuserpermission.md)    | Aktualizuje oprávnenia používateľa poskytnutím ID používateľa aj ID tímu.                            | PATCH  |
| [Upload a file](/retail-media-interface/partner/sk/team-user-api/user-1/uploadfile-1.md)                     | Nahráva logá pre profily používateľov a tímy.                                                        | POST   |
| [Retrieve file URL](/retail-media-interface/partner/sk/team-user-api/user-1/getfileurl.md)                   | Získa URL pre logo tímu alebo používateľa pomocou zadaného ID súboru.                                | POST   |
| Odstrániť používateľa                                                                                        | Odstráni používateľa z tímu.                                                                         | DELETE |

### Správa fakturácie a peňaženiek

#### Čo je peňaženka?

Peňaženka uchováva finančné prostriedky inzerenta na účely vykonávania platieb (napr. platba za realizované reklamy).

#### Peňaženka

| Koncový bod                                                                                                       | Popis                                                                                                                                     | Metóda |
| ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Create a wallet](/retail-media-interface/partner/sk/billing-api/wallet/createwallet.md)                          | Vytvorí peňaženku v rámci zadaného namespace a prepojí ju s tímom pomocou ID tímu.                                                        | POST   |
| [Update a wallet](/retail-media-interface/partner/sk/billing-api/wallet/updatewallet-1.md)                        | Aktualizuje peňaženku v rámci zadaného namespace a teamId.                                                                                | PATCH  |
| [Retrieve wallet by ID](/retail-media-interface/partner/sk/billing-api/wallet/getwallet-1.md)                     | Získa podrobnosti o konkrétnej peňaženke pomocou jej jedinečného identifikátora, {id}.                                                    | GET    |
| [List all wallets](/retail-media-interface/partner/sk/billing-api/wallet/listwallets.md)                          | Získa zoznam peňaženiek na základe zadaných filtrov a parametrov, vrátane ID tímu, názvu peňaženky, ID peňaženky, externého ID a ďalších. | GET    |
| [Get the balance of a specific wallet](/retail-media-interface/partner/sk/billing-api/wallet/getwalletbalance.md) | Získa aktuálny zostatok špecifikovanej peňaženky.                                                                                         | GET    |
| [Manage funds to a specific wallet](/retail-media-interface/partner/sk/billing-api/wallet/managefunds.md)         | Spravuje operácie s finančnými prostriedkami pre konkrétnu peňaženku.                                                                     | POST   |

#### Výdavky

| Koncový bod                                                                                                 | Popis                                                                                                      | Metóda |
| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ------ |
| [Retrieve campaign spend details](/retail-media-interface/partner/sk/billing-api/spend/getcampaignspend.md) | Vypočíta zostávajúci rozpočet pre konkrétne kampane na základe ich dostupného zostatku a limitov výdavkov. | POST   |

### Hromadná operácia

#### Kampaň

| Koncový bod                                                                                                                            | Popis                                                                                   | Metóda |
| -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------ |
| [Create campaigns in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md)         | Vytvorí viacero kampaní súčasne (až 1 000) na základe typu kampane.                     | POST   |
| [Update campaigns in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md)       | Aktualizuje kampane v rámci zadaného namespace.                                         | PATCH  |
| [Update campaign approval state](/retail-media-interface/partner/sk/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | Schvaľuje alebo odmieta kampane v rámci zadaného namespace.                             | POST   |
| Získať stav hromadnej operácie                                                                                                         | Získa stav a podrobnosti hromadnej operácie s kampaniami pomocou ID hromadnej operácie. | GET    |

#### Peňaženka

| Koncový bod                                                                                                                             | Popis                                                                   | Metóda |
| --------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | ------ |
| [Create wallets in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md)                | Vytvorte viacero peňaženiek naraz v rámci vašej organizácie (až 1 000). | POST   |
| [Retrieve bulk wallet operation status](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | Získa stav hromadnej operácie s peňaženkami pomocou jej bulk ID.        | GET    |
| [Update wallets in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md)                | Aktualizuje viacero peňaženiek súčasne.                                 | PATCH  |

#### Team

| Koncový bod                                                                                                                           | Popis                                                       | Metóda |
| ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------ |
| [Create teams in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md)                | Vytvorí hromadný tím pre organizáciu.                       | POST   |
| [Update teams in bulk](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md)                | Aktualizuje viacero tímov súčasne.                          | PATCH  |
| [Retrieve bulk team operation status](/retail-media-interface/partner/sk/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | Získa stav hromadnej operácie s tímami pomocou jej bulk ID. | GET    |

### Navrhovaný hľadaný výraz

#### Čo sú navrhované hľadané výrazy?

Navrhované hľadané výrazy sú súbor výrazov poskytnutých prostredníctvom súboru od predajcu, ktoré spájajú produkty so špecifickými výrazmi, ktoré sa zobrazujú používateľovi pri vytváraní kampane v kroku hľadaných výrazov. Ďalšie informácie nájdete v časti Navrhované hľadané výrazy.

| Koncový bod                                                                                                                                      | Popis                                                                                                                            | Metóda |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Lists all suggested search terms](/retail-media-interface/partner/sk/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | Získa navrhované hľadané výrazy pre cielenie katalógu na základe zadaných parametrov, ako je ID katalógu, kód produktu a ďalšie. | GET    |

## Osvedčené postupy

Dodržiavajte tieto osvedčené postupy, aby ste zaistili plynulú, efektívnu a spoľahlivú integráciu s Epsilon Retail Media Partner APIs:

* Pred nasadením do produkcie vždy testujte v sandboxe.
* Pre viacero operácií používajte hromadné koncové body (bulk endpoints).
* V chybových odpovediach skontrolujte špecifické problémy s dátami.
* Pre rýchlejšie nahrávanie dát používajte komprimované súbory.
* Prístupové tokeny obnovujte až po ich expirácii.
* Před odesláním žádostí ověřte povinná pole.

## Riešenie chýb

Naše rozhrania Partner API vracajú štruktúrované chybové odpovede JSON na podporu robustného spracovania výnimiek.

* **Stavový kód HTTP**: Štandardné chybové kódy (400, 401, 403, 500 atď.)
* **Kód chyby**: Špecifický identifikátor chyby.
* **Správa**: Pre človeka čitateľný popis chyby.
* **Porušenia polí**: Špecifické chyby validácie polí pri problémoch so vstupom údajov.

Podrobné informácie o riešení chýb nájdete v časti [Riešenie chýb](/retail-media-interface/partner/sk/partner-api-overview/error-handling.md).

## Podpora a zdroje

| Zdroj                                                                                                               | Popis                                                                    |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [Frequently asked questions](/retail-media-interface/partner/sk/partner-api-overview/frequently-asked-questions.md) | Často kladené otázky a odpovede týkajúce sa používania a integrácie API. |
| Poznámky k vydaniu                                                                                                  | Súhrn nedávnych aktualizácií alebo zmien v API.                          |
| [Glossary](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1)                             | Definície kľúčových pojmov používaných v dokumentácii k API.             |


---

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