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

# Přehled rozhraní Epsilon Retail Media Partner API

Vítá vás Epsilon Retail Media Partner API. Tato příručka vám pomůže s integrací do naší reklamní platformy pro programatickou správu vašich kampaní, peněženek, týmů a uživatelů. Můžete také sledovat výkon a efektivně rozvíjet svoje podnikání.

## Co je API?

API znamená Application Programming Interface (rozhraní pro programování aplikací). API funguje jako zprostředkovatel, který umožňuje dvěma softwarovým komponentám komunikovat pomocí sady funkcí a postupů. API se běžně používají k získávání nebo odesílání dat, přičemž přistupují k funkcím a službám z jiných aplikací.

## Co je Partner API?

Naše Partner API vám poskytuje programatický přístup téměř ke všemu, co můžete dělat v Epsilon uživatelském rozhraní platforem Na webu Campaign Management. To znamená, že namísto ručního klikání v aplikaci se vaše systémy nebo vývojáři mohou připojit přímo k naší platformě a automatizovat, přizpůsobovat nebo integrovat její funkce do vašich vlastních nástrojů nebo pracovních postupů.

Partner API využívá mnoho maloobchodníků a partnerů včetně agregátorů jako Pacvue, Skai a Commerce IQ.

## Přehled API

Tento Epsilon Retail Media Partner API umožňuje programatickou správu retail médií [Kampaně](/retail-media-interface/partner/cs/campaign-management-api/productcampaign-1/createproductcampaign.md), [Tým](/retail-media-interface/partner/cs/team-user-api/team.md) & [Uživatel](/retail-media-interface/partner/cs/team-user-api/user-1/createuserteaminvite.md)a [Peněženky](/retail-media-interface/partner/cs/billing-api/wallet.md). Použijte jej k vytváření a aktualizaci kampaní napříč několika reklamními formáty včetně Sponsored Product Ads (SPA), statických bannerů a responsivních Banner X reklam.

Naše Partner API je rozhraní typu REST, které využívá běžné protokoly GET, POST, PATCH a DELETE prostřednictvím datových částí JSON.

## Hlavní výhody

* Automatizujte operace s kampaněmi, týmy a uživateli a peněženkami prostřednictvím koncových bodů REST API.
* Spravujte efektivně více kampaní a zdrojů díky podpoře hromadných operací.
* Umožní vám koordinovat volání API tak, aby odpovídala vašemu stávajícímu pracovnímu postupu a architektuře systému.
* Vytvářejte a spravujte kampaně v rámci Sponsored Product Ads, Banneru a Banner X formátů.
* Autentizace založená na uživatelském klíči s časově omezenými tokeny pro bezpečnou interakci s API.

## Předpoklady

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

Před použitím Partner API se ujistěte, že jsou splněny následující požadavky:

### Přístup k oboru názvů

Musíte mít přístup k určenému oboru názvů (namespace), který slouží jako kontejner pro vaše data a konfigurace. Obraťte se na Epsilon tým podpory a vyžádejte si podrobnosti o konfiguraci oboru názvů specifické pro vaše maloobchodníky.

### Členství v týmu

Musíte být součástí týmu dodavatele nebo primárního maloobchodníka s příslušnými oprávněními v rámci vašeho oboru názvů.

### Žádost o připojení k API

Agregátoři reklam, agentury a značkoví partneři musejí před použitím Partner APIs podat žádost o připojení k API. Použijte oficiální formulář uvedený v [KB0040933 ](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)pro zahájení nového připojení k API.

### Přístup k Reporting API

Musíte mít přístup k Reporting API (datovému skladu BigQuery) pro dotazování na příslušné tabulky, jako jsou dim\_product, dim\_catalog a dim\_placement. To pomáhá ověřit připravenost integrace a prozkoumat metadata.

### Požadovaná metadata

Ujistěte se, že váš produktový katalog, umístění a informace o týmu jsou vytvořeny a dostupné ve vašem oboru názvů. Můžete to ověřit dotazováním na příslušné tabulky BigQuery.

Pokud nemáte přístup k BigQuery, vyžádejte si jej prostřednictvím oficiálního formuláře žádosti o přístup k API. V závislosti na vašich potřebách si přečtěte příslušný článek znalostní báze:

* **Změt/Odebrat koncový bod Reporting BigQuery API**: Je potřeba upravit stávající 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 přístupu: Některé odkazy v tomto dokumentu ukazují na interní nebo omezené zdroje. Pro přístup k obsahu se ujistěte, že jste přihlášeni s příslušnými přihlašovacími údaji.
{% endhint %}

## Začínáme s Partner APIs

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

### Požadavky na autentizaci

Partner API využívá autorizační proces vyžadující uživatelský klíč (User Key). Přístupové tokeny se získávají voláním User Key Authentication API:

* Váš získaný uživatelský klíč se předává v hlavičce této žádosti.
* Získaný přístupový token se následně používá při jakémkoli volání metod v Partner API.
* Platnost tokenů vyprší za necelých 24 hodin od vygenerování.

{% hint style="info" %}
Při vypršení platnosti předchozího tokenu by měl být vyžádán nový token. Klient by neměl generovat nový token s každým požadavkem na naše API.
{% endhint %}

### Získejte své přihlašovací údaje k API

Chcete-li začít používat Epsilon Retail Media Partner APIs, potřebujete následující informace. Pokud si nejste jisti kterýmikoli podrobnostmi, kontaktujte podporu nebo otevřete tiket s žadostí o pomoc.

* Váš uživatelský klíč pro autentizaci.
* Základní URL pro provádění volání API.

### Získání uživatelského klíče

1. Přihlaste se do svého Epsilon Retail Media týmového účtu.
2. Vyberte tým.
3. Z rozbalovací nabídky profilu vyberte **Uživatelská nastavení**.
4. Přejděte na kartu **Uživatelský klíč**.
5. Kliknutím na **Zobrazit** odkryjete svůj klíč API.

Tento klíč použijte k autentizaci svých požadavků API. Epsilon Retail Media používá autentizaci založenou na uživatelském klíči. Vyměňte svůj uživatelský klíč za časově omezený přístupový token k autorizaci požadavků API. Další informace naleznete v části [Požadavky na autentizaci](/retail-media-interface/partner/cs/partner-api-authentication/authenticating-requests.md).

### Získání základní URL

Kontaktujte podporu pro získání správné základní URL pro vaše prostředí. Příklad koncového bodu:

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

Jakmile máte svůj uživatelský klíč, můžete se autentizovat a začít provádět volání API na:

* Zobrazujte a spravujte své reklamní kampaně.
* Spravujte svoje reklamní rozpočty a výdaje.
* Spravujte podrobnosti o svém týmu a uživatelích.

## Nastavení prostředí

Epsilon Retail Media poskytuje dvě odlišná prostředí pro každého prodejce: Produkční a Sandbox. Obě prostředí jsou ve výchozím nastavení vytvořena při registraci prodejce.

### Prostředí Sandbox

{% hint style="info" %}
Přístup do prostředí Sandbox je obvykle poskytován pouze prodejcům a agregátorům. Pokud si nejste jisti svým nárokem, kontaktujte podporu.
{% endhint %}

Toto bezpečné prostředí použijte k testování integrace před spuštěním do ostrého provozu. Prodejci musí toto prostředí používat k ověřování volání API, testování nahrávání katalogů, simulaci vytváření kampaní a zajištění kompletní funkčnosti před spuštěním. Sandbox používejte pro veškerý vývoj, testování a QA činnosti. Každý prodejce má unikátní adresu URL sandboxu, obvykle ve formátu:

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

Prostředí Sandbox obsahuje:

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

### Produkční prostředí

Na produkci přejděte až po úspěšném ověření v sandboxu. Produkční prostředí se používá pro živé kampaně a doručování reklam v reálném čase. Podporuje plnohodnotný provoz včetně aktualizací katalogu, synchronizace objednávek a sledování výkonu reklam. Produkční URL má následující formát:

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

Před použitím tohoto prostředí se ujistěte, že jsou všechny údaje (katalogy, produkty, objednávky) přesné a úplné.

{% hint style="info" %}
Před voláním API si vždy ověřte správné prostředí, zejména při použití přihlašovacích údajů a základních URL adres. Základní URL nemusí vždy odpovídat jmennému prostoru, v závislosti na nastavení integrace prodejce.
{% endhint %}

## Koncové body Partner API

Epsilon Retail Media API nabízí sadu klíčových funkcí rozdělených do funkčních kategorií, z nichž každá je podporována vyhrazenými koncovými body. Níže uvedená tabulka shrnuje hlavní API určená pro partnery, jejich účel a použité metody HTTP.

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

### Správa kampaní

**Co je reklama na sponzorovaný produkt (Sponsored Product Ad)?** Sponzorované produkty (SPA) jsou reklamy umístěné v mřížkách produktů na webu prodejce, které se obvykle nacházejí na stránkách vyhledávání a kategorií, stejně jako na PDP a hlavní stránce, vložení mezi organické výsledky.

**Co je Banner X Ad?** Banner X reklamy jsou plně responzivní reklamní jednotky, které se zvětšují a mění podle zobrazení uživatele. Skládají se z řady prvků reklamního materiálu od hlavních obrázků a obrázků na pozadí až po texty nadpisů a tlačítka s výzvou k akci.

**Co je bannerová reklama?** Standardní banner je statický obrázek s cílovou URL adresou pro proklik.

#### Produktová kampaň

| Koncový bod                                                                                                                                                           | Popis                                                                        | Metoda |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------ |
| [Create a product campaign](/retail-media-interface/partner/cs/campaign-management-api/productcampaign-1/createproductcampaign.md)                                    | Vytvoří novou produktovou kampaň pomocí údajů poskytnutých v těle požadavku. | POST   |
| [Retrieve list of all product campaigns](/retail-media-interface/partner/cs/campaign-management-api/productcampaign-1/listproductcampaigns.md)                        | Na základě zadaných parametrů načte seznam všech produktových kampaní.       | GET    |
| [Update a product campaign](/retail-media-interface/partner/cs/campaign-management-api/productcampaign-1/updateproductcampaign.md)                                    | Aktualizuje stávající produktovou kampaň pomocí ID kampaně                   | PATCH  |
| [Get product campaign by ID](/retail-media-interface/partner/cs/campaign-management-api/productcampaign-1/getproductcampaign-1.md)                                    | Načte podrobnosti o produktové kampani pro zadané ID kampaně.                | GET    |
| [Change approval state of a product campaign](/retail-media-interface/partner/cs/campaign-management-api/productcampaign-1/approveproductcampaign-1.md)               | Aktualizuje stav schválení zadané produktové kampaně.                        | POST   |
| [Check booking feasibility for fixed tenancy campaigns](/retail-media-interface/partner/cs/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | Ověří, zda je možné provést rezervaci pro kampaně s fixním umístěním.        | POST   |

#### Banner X Kampaň

| Koncový bod                                                                                                                                         | Popis                                                                                                                                         | Metoda |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Create a Banner X campaign](/retail-media-interface/partner/cs/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md)               | Vytvoří novou kampaň banneru X pomocí údajů poskytnutých v těle požadavku.                                                                    | POST   |
| [Get Banner X campaign details](/retail-media-interface/partner/cs/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md)               | Načte podrobnosti o kampani banneru X pro zadané ID kampaně.                                                                                  | GET    |
| [Update Banner X campaign](/retail-media-interface/partner/cs/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md)                   | Aktualizuje stávající Banner X kampaň poskytnutím ID kampaně a aktualizovaných dat kampaně v těle požadavku.                                  | PATCH  |
| [Update Banner X campaign approval state](/retail-media-interface/partner/cs/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | Aktualizuje stav schválení zadané kampaně banneru X.                                                                                          | POST   |
| [Retrieve list of all Banner X campaigns](/retail-media-interface/partner/cs/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md)     | Načte seznam kampaní banneru X na základě zadaných filtrů a parametrů, včetně názvu kampaně, ID umístění, ID týmu, stavu schválení a dalších. | GET    |

#### Bannerová kampaň

| Koncový bod                                                                                                                                 | Popis                                                                       | Metoda |
| ------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------ |
| [Create a banner campaign](/retail-media-interface/partner/cs/campaign-management-api/bannercampaign/createbannercampaign-1.md)             | Vytvoří novou bannerovou kampaň pomocí údajů poskytnutých v těle požadavku. | POST   |
| [Get banner campaign details](/retail-media-interface/partner/cs/campaign-management-api/bannercampaign/getbannercampaign-1.md)             | Načte podrobnosti o bannerové kampani pro zadané ID kampaně.                | GET    |
| [Update banner campaign](/retail-media-interface/partner/cs/campaign-management-api/bannercampaign/updatebannercampaign.md)                 | Aktualizuje stávající bannerovou kampaň pomocí ID kampaně.                  | PATCH  |
| [Update banner campaign approval state](/retail-media-interface/partner/cs/campaign-management-api/bannercampaign/approvebannercampaign.md) | Aktualizuje stav schválení zadané bannerové kampaně                         | POST   |

#### Soubory kampaně

| Koncový bod                                                                                                                   | Popis                                                                | Metoda |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ------ |
| [Upload a campaign file](/retail-media-interface/partner/cs/campaign-management-api/creativeassets/uploadfile.md)             | Nahrává různé typy souborů kampaně                                   | POST   |
| [Retrieve campaign file URL](/retail-media-interface/partner/cs/campaign-management-api/creativeassets/getcampaignfileurl.md) | Načte URL souboru kampaně pomocí zadaného ID souboru a typu souboru. | POST   |

#### Standard obsahu

| Koncový bod                                                                                                                                                               | Popis                                                                                                                                   | Metoda |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Get Banner X content standard details](/retail-media-interface/partner/cs/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md)                 | Načte Banner X podrobnosti o standardu obsahu pro zadané ID standardu obsahu.                                                           | GET    |
| [Retrieve list content standards for Banner X campaigns](/retail-media-interface/partner/cs/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md) | Načte seznam standardů obsahu pro Banner X kampaně na základě zadaných parametrů, jako je jmenný prostor, název a ID standardu obsahu.  | GET    |
| [Get banner content standard details](/retail-media-interface/partner/cs/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md)                      | Načte podrobnosti o standardu obsahu banneru pro zadané ID standardu obsahu.                                                            | GET    |
| [Retrieve list content standards for banner campaigns](/retail-media-interface/partner/cs/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md)    | Načte seznam standardů obsahu pro bannerové kampaně na základě zadaných parametrů, jako je jmenný prostor, název a ID standardu obsahu. | GET    |

#### Kampaň

| Koncový bod                                                                                                                                | Popis                                                                                                                                                                                            | Metoda |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
| [Retrieve list of all campaigns](/retail-media-interface/partner/cs/campaign-management-api/campaign/listcampaigns-1.md)                   | Načte seznam kampaní na základě zadaných filtrů a parametrů, včetně názvu kampaně, typu kampaně, ID umístění, ID týmu, stavu schválení a dalších.                                                | POST   |
| [Retrieve campaign history](/retail-media-interface/partner/cs/campaign-management-api/campaign/getcampaignhistory.md)                     | Načte historii kampaně pomocí jejího ID kampaně.                                                                                                                                                 | GET    |
| [Retrieve minimum bid details for keywords](/retail-media-interface/partner/cs/campaign-management-api/campaign/retrievekeywordsminbid.md) | Načte podrobnosti o jednotlivých minimálních nabídkách a celkovou minimální nabídku kampaně pro pole zadaných klíčových slov v kampaních s typem umístění Vyhledávání a Kategorie a vyhledávání. | POST   |
| [Retrieve minimum bid details for category](/retail-media-interface/partner/cs/campaign-management-api/campaign/retrievecategoryminbid.md) | Načte podrobnosti o jednotlivých minimálních nabídce a celkovou minimální nabídku kampaně pro kampaně s typem umístění v kategorii.                                                              | POST   |

## Správa podkladů reklamních materiálů

### Co je podklad reklamního materiálu?

Podklady reklamních materiálů jsou obrázky používané v bannerových a Banner X kampaních. Tyto podklady musí splňovat specifické technické požadavky, aby bylo zajištěno jejich správné zobrazení a výkon.

### Pokyny pro nahrávání:

* Velikost souboru < 4 MB
* Typy souborů: PNG, JPEG, JPG, GIF, SVG a PDF
* Vždy pouze jeden soubor
* ID týmu, ID pozice a ID standardu obsahu jsou povinné
* Poskytněte úplnou absolutní cestu k souboru

{% hint style="info" %}
Odesílání podkladů reklamních materiálů je zpracováváno prostřednictvím koncových bodů Campaign File uvedených výše v sekci Správa kampaní.
{% endhint %}

## Správa standardů obsahu

### Co je to standard obsahu?

Standardy obsahu jsou pokyny a technické parametry, které určují, jak má být banner nebo Banner X reklama zobrazena v vyhrazeném prostoru na webové stránce nebo digitální platformě. Standardy zahrnují parametry, jako jsou rozměry a velikost, formát a velikosti souborů, rozlišení a kvalita, umísťování a zarovnání, omezení obsahu a interaktivita.

### Správa týmů a uživatelů

#### Co je to tým?

Tým je skupina uživatelů a je klasifikován buď jako tým dodavatele (inzerenta), nebo tým prodejce. Týmy dodavatelů obvykle vytvářejí kampaně, zatímco prodejci kampaně kontrolují a provádějí administrativní úkoly. Uživatel v systému může patřit do více týmů nebo jen do jednoho. Obvykle s týmem souvisejí uživatelé, kampaně a peněženky.

#### Tým

| Koncový bod                                                                                     | Popis                                                                                        | Metoda |
| ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------ |
| [Create team](/retail-media-interface/partner/cs/team-user-api/team/createteam-1.md)            | Vytvoří nový tým.                                                                            | POST   |
| Aktualizovat tým                                                                                | Aktualizuje podrobnosti týmu určeného pomocí team\_id.                                       | PATCH  |
| Seznam všech týmů                                                                               | Získá seznam týmů na základě zadaných parametrů, jako jsou name, namespace\_id a seller\_id. | GET    |
| [Get team for specified ID](/retail-media-interface/partner/cs/team-user-api/team/getteam-1.md) | Získá podrobné informace o konkrétním týmu, včetně jeho členů.                               | GET    |
| Připojit se k týmu pomocí pozvánkového tokenu                                                   | Umožňuje uživatelům připojit se k týmu pomocí platného a neexpirovaného pozvánkového tokenu. | POST   |

#### Uživatel

| Koncový bod                                                                                                  | Popis                                                                                         | Metoda |
| ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- | ------ |
| [Invite a user to the team](/retail-media-interface/partner/cs/team-user-api/user-1/createuserteaminvite.md) | Odeslat pozvánku uživateli k připojení k určenému týmu.                                       | POST   |
| Získat podrobnosti o uživateli pomocí ID uživatele                                                           | Získá podrobnosti o uživateli, který je aktuálně přihlášen do Epsilon Retail Media platformy. | GET    |
| [Retrieve user details](/retail-media-interface/partner/cs/team-user-api/user-1/getusersforteam.md)          | Získá podrobnosti o uživateli na základě zadaného ID týmu.                                    | GET    |
| [Update current user detail](/retail-media-interface/partner/cs/team-user-api/user-1/updateuserprofile.md)   | Upraví podrobnosti o aktuálně přihlášeném uživateli na Epsilon Retail Media platformy.        | PATCH  |
| [Modify user permission](/retail-media-interface/partner/cs/team-user-api/user-1/modifyuserpermission.md)    | Aktualizuje oprávnění uživatele zadáním ID uživatele i ID týmu.                               | PATCH  |
| [Upload a file](/retail-media-interface/partner/cs/team-user-api/user-1/uploadfile-1.md)                     | Nahrává loga pro uživatelské profily a týmy.                                                  | POST   |
| [Retrieve file URL](/retail-media-interface/partner/cs/team-user-api/user-1/getfileurl.md)                   | Získá URL loga týmu nebo uživatele pomocí zadaného ID souboru.                                | POST   |
| Odebrat uživatele                                                                                            | Odebere uživatele z týmu.                                                                     | DELETE |

### Správa fakturace a peněženek

#### Co je to peněženka?

V peněžence jsou uloženy finanční prostředky inzerenta za účelem provádění plateb (např. placení za realizované reklamy).

#### Peněženka

| Koncový bod                                                                                                       | Popis                                                                                                                                 | Metoda |
| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Create a wallet](/retail-media-interface/partner/cs/billing-api/wallet/createwallet.md)                          | Vytvoří peněženku v rámci zadaného jmenného prostoru a propojí ji s týmem pomocí ID týmu.                                             | POST   |
| [Update a wallet](/retail-media-interface/partner/cs/billing-api/wallet/updatewallet-1.md)                        | Aktualizuje peněženku v rámci zadaného jmenného prostoru a teamId.                                                                    | PATCH  |
| [Retrieve wallet by ID](/retail-media-interface/partner/cs/billing-api/wallet/getwallet-1.md)                     | Získá podrobnosti o konkrétní peněžence pomocí jejího jedinečného identifikátoru {id}.                                                | GET    |
| [List all wallets](/retail-media-interface/partner/cs/billing-api/wallet/listwallets.md)                          | Získá seznam peněženek na základě zadaných filtrů a parametrů, včetně ID týmu, názvu peněženky, ID peněženky, externího ID a dalších. | GET    |
| [Get the balance of a specific wallet](/retail-media-interface/partner/cs/billing-api/wallet/getwalletbalance.md) | Získá aktuální zůstatek určené peněženky.                                                                                             | GET    |
| [Manage funds to a specific wallet](/retail-media-interface/partner/cs/billing-api/wallet/managefunds.md)         | Spravuje operace s finančními prostředky pro konkrétní peněženku.                                                                     | POST   |

#### Útrata

| Koncový bod                                                                                                 | Popis                                                                                                    | Metoda |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------ |
| [Retrieve campaign spend details](/retail-media-interface/partner/cs/billing-api/spend/getcampaignspend.md) | Vypočítá zbývající rozpočet pro konkrétní kampaně na základě jejich dostupného zůstatku a limitů útraty. | POST   |

### Hromadná operace

#### Kampaň

| Koncový bod                                                                                                                            | Popis                                                                               | Metoda |
| -------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------ |
| [Create campaigns in bulk](/retail-media-interface/partner/cs/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md)         | Vytvoří více kampaní současně (až 1 000) na základě typu kampaně.                   | POST   |
| [Update campaigns in bulk](/retail-media-interface/partner/cs/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md)       | Aktualizuje kampaně v rámci zadaného jmenného prostoru.                             | PATCH  |
| [Update campaign approval state](/retail-media-interface/partner/cs/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | Schválí nebo odmítne kampaně v rámci zadaného jmenného prostoru.                    | POST   |
| Získat stav hromadné operace                                                                                                           | Získá stav a podrobnosti o hromadné operaci s kampaněmi pomocí ID hromadné operace. | GET    |

#### Peněženka

| Koncový bod                                                                                                                             | Popis                                                                  | Metoda |
| --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- | ------ |
| [Create wallets in bulk](/retail-media-interface/partner/cs/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md)                | Vytvořit více peněženek najednou v rámci vaší organizace (až 1 000).   | POST   |
| [Retrieve bulk wallet operation status](/retail-media-interface/partner/cs/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | Získá stav hromadné operace s peněženkami pomocí jejího hromadného ID. | GET    |
| [Update wallets in bulk](/retail-media-interface/partner/cs/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md)                | Aktualizuje více peněženek současně.                                   | PATCH  |

#### Tým

| Koncový bod                                                                                                                           | Popis                                                           | Metoda |
| ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | ------ |
| [Create teams in bulk](/retail-media-interface/partner/cs/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md)                | Vytvoří hromadně týmy pro organizaci.                           | POST   |
| [Update teams in bulk](/retail-media-interface/partner/cs/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md)                | Aktualizuje více týmů současně.                                 | PATCH  |
| [Retrieve bulk team operation status](/retail-media-interface/partner/cs/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | Získá stav hromadné operace s týmy pomocí jejího hromadného ID. | GET    |

### Navrhovaný vyhledávací výraz

#### Co jsou to navrhované vyhledávací výrazy?

Navrhované vyhledávací výrazy jsou soubor výrazů poskytnutých prostřednictvím souboru od prodejce, které propojují produkty s konkrétními výrazy, jež jsou uživateli prezentovány při vytváření kampaně v kroku vyhledávacích výrazů. Další informace naleznete v části Navrhované vyhledávací výrazy.

| Koncový bod                                                                                                                                      | Popis                                                                                                                                                                 | Metoda |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Lists all suggested search terms](/retail-media-interface/partner/cs/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | Získá navrhované vyhledávací výrazy pro cílení na katalog navrhovaných vyhledávacích výrazů na základě zadaných parametrů, jako je ID katalogu, kód produktu a další. | GET    |

## Osvedčené postupy

Dodržujte tyto osvědčené postupy, abyste zajistili hladkou, efektivní a spolehlivou integraci s Epsilon Retail Media Partner APIs:

* Před nasazením do produkce vždy testujte v sandboxu.
* Pro více operací používejte koncové body pro hromadné operace.
* V chybových odpovědíchň kontrolujte konkrétní problémy s daty.
* Pro rychlejší nahrávání dat používejte komprimované soubory.
* Přístupové tokeny obnovujte pouze po jejich expiraci.
* Předodesláním požadavků ověřte povinná pole.

## Zpracování chyb

Naše rozhraní Partner API vracejí strukturované chybové odpovědi v JSON, aby podporovala robustní zpracování výjimek.

* **Stavový kód HTTP**: Standardní chybové kódy (400, 401, 403, 500 atd.)
* **Kód chyby**: Specifický identifikátor chyby.
* **Zpráva**: Srozumitelný popis chyby.
* **Porušení polí**: Konkrétní chyby validace polí v případě problémů se vstupními daty.

Podrobné informace o zpracování chyb naleznete v části [Řešení chyb](/retail-media-interface/partner/cs/partner-api-overview/error-handling.md).

## Podpora a zdroje

| Zdroj                                                                                                               | Popis                                                                     |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [Frequently asked questions](/retail-media-interface/partner/cs/partner-api-overview/frequently-asked-questions.md) | Často kladené otázky a odpovědi související s používáním a integrací API. |
| Poznámky k vydání                                                                                                   | Aktivní přehled nedávných aktualizací nebo změn v API.                    |
| [Glossary](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1)                             | Definice klíčových pojmů používaných napříč dokumentací 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/cs/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.