> 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/frequently-asked-questions.md). # Často kladené otázky ## Hromadné operácie s rozhraniami Partner API ### Čo sú hromadné operácie? Hromadné operácie vám umožňujú vytvoriť, upraviť alebo schváliť viacero kampaní, peňaženiek alebo tímov v jednej požiadavke API namiesto vykonávania jednotlivých volaní. ### Sú hromadné operácie synchronné alebo asynchronné? Asynchronné. Odošlete úlohu a pomocou ID hromadnej operácie dopytujete výsledky. ### Čo sa stane, ak niektoré položky v mojej hromadnej požiadavke zlyhajú? Každá položka sa overuje samostatne. Dostanete podrobné výsledky zobrazujúce, ktoré položky boli úspešné a ktoré zlyhali s konkrétnymi chybovými správami. ## Tím a používateľ ### Čo je pozvánka? Pozvánka umožňuje používateľovi pripojiť sa k tímu v Epsilon Retail Media platforme. Pozvánky zvyčajne odosielajú správcovia tímu a pred prístupom používateľa k zdrojom tímu sa musia prijať buď e-mailom, alebo v rámci platformy. ### Ako vytvorím nový tím? Použite koncový bod [Create team](/retail-media-interface/partner/sk/team-user-api/team/createteam-1.md) s požadovanými poľami, ako sú názov tímu, informácie o spoločnosti a ID priestoru názvov. Na vytváranie tímov v rámci vašej organizácie budete potrebovať príslušné oprávnenia. ### Môžem patriť do viacerých tímov? Áno, používatelia môžu patriť do viacerých tímov súčasne. Každé členstvo v tíme môže mať rôzne úrovne oprávnení a roly. ### Aký je rozdiel medzi tímami maloobchodníka a dodávateľa? Tímy maloobchodníka spravujú a kontrolovali kampane, zatiaľ čo tímy dodávateľa (inzerenti) kampane vytvárajú a spravujú. Typ tímu určuje dostupné funkcie a oprávnenia. ### Ako si zmením používateľské oprávnenia? Správcovia tímu môžu upravovať používateľské oprávnenia pomocou koncového bodu Modify user permission. Typy oprávnení zahŕňajú Plný prístup a Zobrazenie prehľadov pre roly maloobchodníka aj dodávateľa. ### Čo sa stane, keď odstránim používateľa z tímu? Odstránením používateľa sa zruší jeho prístup k zdrojom, kampaniam a údajom daného tímu. Používateľ už nebude dostávať oznámenia tímu ani nebude môcť vykonávať akcie špecifické pre tím. ### Ako dlho platia tokeny pozvánky? Tokeny pozvánky majú dobu platnosti. Ak vaša pozvánka vypršala a potrebujete novú, kontaktujte správcu tímu. ### Môžem po vytvorení aktualizovať informácie o tíme? Áno, na úpravu podrobností o tíme vrátane názvu, informácií o spoločnosti, telefónneho čísla, URL adresy webových stránok a adresy použite koncový bod Update a team. ### Aké typy súborov môžem nahrávať pre logá? Koncový bod [Upload a file](/retail-media-interface/partner/sk/team-user-api/user-1/uploadfile-1.md) podporuje bežné obrazové formáty pre logá profilov tímov a používateľov. Konkrétne požiadavky na veľkosť a formát súboru nájdete v dokumentácii API. ### Ako nájdem tímy, k ktorým sa môžem pripojiť? Na vyhľadanie dostupných tímov v rámci vašej organizácie použite koncový bod Lists all teams s príslušnými filtrami, ako je názov, `namespace_id`, or `seller_id` na objavenie dostupných tímov v rámci vašej organizácie. ## List campaigns ### Kedy mám použiť `managedOnly`? V systéme Epsilon Retail Media niektoré kampane spravujú maloobchodníci a nie dodávatelia. Pre produktové reklamy je jediným dostupným typom výdavkov Fixné umiestnenie. Na načítanie iba kampaní s fixným umiestnením použite parameter `managedOnly` na načítanie iba kampaní s fixným umiestnením. ## Create or update campaigns ### Kedy mám použiť `managerTeamId`? Použite `managerTeamId` parameter pri vytváraní alebo aktualizácii kampaní s fixným umiestnením. Pri špecifikovaní `managerTeamId`budete musieť špecifikovať aj príslušné nastavenia stratégie fixného umiestnenia. ### Čo je `namespaceId`? The `namespaceId` je jedinečný identifikátor pre menný priestor, v ktorom sa vytvárajú alebo aktualizujú kampane. Ďalšie informácie nájdete v časti Menné priestory. Túto hodnotu môžete získať aj od svojho inžiniera pre zákaznícku integráciu (CIE). ### Čo je `placementId`? Umiestnenia určujú miesta, kde sa zobrazujú reklamy. Každé umiestnenie v systéme Epsilon Retail Media má jedinečný identifikátor s názvom `placementId`. Použite [Vráti zoznam umiestnení](/retail-media-interface/partner/sk/global-api/placements/listplacements.md) API na získanie `placementId`. Prípadne kontaktujte svojho CIE, aby ste túto hodnotu získali. ### Čo je `walletId`? walletId je identifikátor peňaženky inzerenta. Každý inzerent môže mať jednu alebo viacero peňaženiek. Každá peňaženka má hodnotu kreditov, ktoré môže minúť. Nastavením walletId určujete, z ktorej peňaženky inzerenta sa budú účtovať poplatky za kampaň. ### Čo je `templateId`? The `templateId` sa používa pri implementáciách Ad Genius. Väčšina zákazníkov ho bežne nepoužíva a vo všeobecnosti ho možno ignorovať. ### Čo sú vlastné polia? V platforme Epsilon Retail Media niektorí maloobchodníci vyžadujú pre kampane vlastné atribúty, ako sú nákupné objednávky a údaje o kupujúcom. Príklad je uvedený nižšie:
Custom fields.png
Ak vaša integrácia tieto polia nevyžaduje, môžete toto pole ignorovať. Ak ich vyžaduje, váš CIE vám poskytne potrebné ID. ### Čo sú vlastné otázky? V menných priestoroch s integrovanými údajmi na cieľenie na zákazníkov môžu inzerenti cieľovať na segmenty zákazníkov pomocou dvojíc `key:value` . Ďalšie informácie nájdete v časti Údaje o zákazníkoch. V menných priestoroch s vlastnými otázkami môžete inzerentom naznačiť, či sú tieto otázky voliteľné alebo povinné, a poskytnúť príslušnú konfiguráciu. Váš CIE vám môže poskytnúť `customQuestionIds` , ak sú nakonfigurované vo vašom mennom priestore. ### Musím špecifikovať `startTime` a `endTime`? Tento údaj môžete vynechať, ak má kampaň bežať nepretržite. Ak chce váš inzerent nastaviť obdobie aktivity, mali by ste poskytnúť obe hodnoty vo formáte ISO-8601. ### Ako môžem pri aktualizácii (PATCH) aktualizovať konkrétnu vlastnosť bez odoslania celého objektu kampane? Naše API používajú vlastnosť `mask` , ktorá vám umožňuje aktualizovať konkrétnu vlastnosť bez odoslania celého objektu kampane. #### Kľúčové body * Umiestnenie\*\*: Uistite sa, že vlastnosť `mask` je vo vašej požiadavke správne umiestnená. * **Riešenie chýb:** Ak narazíte na chybu oprávnení, skontrolujte formát masky vo vašej požiadavke. #### Príklady **Zmena jednoduchej vlastnosti**, ako je názov kampane, použite nasledujúce: ```json { "productCampaign": { "name": "new campaign name" }, "mask": "name" } ``` Zmena vloženej vlastnosti\*\*, ako je `maxBid`: ```json { "productCampaign": { "strategy": { "auction": { "maxBid": "5" } } }, "mask": "strategy.auction.maxBid" } ``` Zmena viacerých vlastností\*\* ako `searchTerms` a `maxBid`, použite čiarkou oddelený zoznam vlastností, ktoré aktualizujete v `mask` vlastnosti: ```json { "productCampaign": { "targeting": { "searchTerms": [ { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "yoghurt_new", "suggested": false }, { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "dairy", "suggested": false }, { "matchType": "MATCH_TYPE_EXACT_MATCH", "phrase": "cheezy_new", "suggested": false } ] }, "strategy": { "auction": { "maxBid": "6.5" } } }, "mask": "targeting.searchTerms,strategy.auction" } ``` ## Peňaženka ### Načo potrebujem peňaženku? Peňaženky sa používajú na správu finančných prostriedkov kampane a na zabezpečenie spracovania transakcií v správnej mene. Ďalšie informácie nájdete v časti Účel. ### Môžem mať viacero peňaženiek? Áno, môžete vytvoriť viacero peňaženiek na samostatnú správu rôznych mien alebo rozpočtov kampaní. Ďalšie informácie nájdete v časti Viacero peňaženiek. ### Kde nájdem ID peňaženky? ID peňaženky môžete nájsť pomocou nasledujúcich krokov: **Pôvodná platforma:** Prejdite na stránku **Fakturácia tímu** a zobrazte svoje Wallet ID. **Nové používateľské rozhranie:** Otvorte **Správcu peňaženky** a nájdite svoje Wallet ID. {% hint style="info" %} Niektoré tímy môžu mať viacero peňaženiek v rôznych menách, preto sa uistite, že ste vybrali tú správnu. {% endhint %} ### Aký je aktuálny zostatok? Aktuálny zostatok je zostatok peňaženky bez aplikovania akýchkoľvek navýšení kreditu alebo limitov. ### Aký je dostupný zostatok? Dostupný zostatok je celková suma v peňaženke, ktorú je možné minúť v danom čase. Zahŕňa aktuálny zostatok plus akýkoľvek úverový limit. ### Čo je denný limit alebo denné čerpanie? Denný limit je maximálna suma, ktorú je možné z vašej peňaženky minúť za jediný deň. ### Čo je rovnomerné čerpanie rozpočtu? Rovnomerné čerpanie rozpočtu znamená, že všetky neminuté prostriedky z denného limitu sa presunú do denného limitu na nasledujúci deň. ### Aký je zostávajúci denný limit? Zostávajúci denný limit sú neminuté prostriedky denného limitu z predchádzajúceho dňa. ### Aký je stropovaný dostupný zostatok? Stropovaný dostupný zostatok je suma, ktorú vám peňaženka umožňuje minúť na daný deň s ohľadom na akékoľvek limity čerpania a/ali kredity z navýšenia. Táto hodnota je kľúčová, pretože určuje, či sú k dispozícii peniaze na míňanie. **Výpočet stropovaného dostupného zostatku**: * **Iba úverový limit**: Stropovaný dostupný zostatok = Dostupný zostatok. * **Iba denný limit**: Stropovaný dostupný zostatok = Denný limit + neminutý presun * **Aplikuje sa úverový aj denný limit**: Minimum z (Dostupný zostatok, Denný limit + presun) Tu je niekoľko príkladov: * **Príklad 1**: Úverový limit je 10, zostatok v peňaženke je 20. * **Príklad 2**: Denný rozpočet je 1000, zostatok v peňaženke je 10 000. * **Príklad 3**: Denný rozpočet je 250, úverový limit je 20, zostatok v peňaženke je 200. V tomto prípade je stropovaný dostupný zostatok 220, pretože dostupný zostatok (aktuálny zostatok + úverový limit) je nižší ako denný limit plus neminutý presun (250). {% hint style="info" %} Úverové limity sú pôvodnou funkciou a väčšina predajcov ich nepodporuje. {% endhint %} ### Môže byť zostatok v peňaženke záporný? Nie. Zostatky v peňaženke nie je možné zámerne nastaviť na záporné hodnoty prostredníctvom Partner API. Hoci aktivita kampane môže dočasne ovplyvniť zostatky, toto správanie je riadené systémom a nie používateľom. ### Prečo nemôžem vybrať peňaženku pri vytváraní kampane? Mena peňaženky sa musí zhodovať s menou katalógu. Napríklad, ak je váš katalóg v AUD, nemôžete vybrať peňaženku v GBP. Ďalšie informácie nájdete v časti [Kompatibilita mien s katalógmi](/retail-media-interface/partner/sk/billing-api/wallet.md#currency-compatibility-with-catalogs). --- # 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/frequently-asked-questions.md?ask=&goal= ``` `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.