> 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/frequently-asked-questions.md). # Často kladené otázky ## Hromadné operace pomocí rozhraní Partner API ### Co jsou to hromadné operace? Hromadné operace vám umožňují vytvářet, upravovat nebo schvalovat více kampaní, peněženek nebo týmů v jediném požadavku API místo provádění jednotlivých volání. ### Jsou hromadné operace synchronní, nebo asynchronní? Asynchronní. Odesláte úlohu a dotazujete se na výsledky pomocí ID hromadné operace (bulk ID). ### Co se stane, když některé položky v mém hromadném požadavku selžou? Každá položka se ověřuje samostatně. Obdržíte podrobné výsledky s uvedením toho, které položky byly úspěšné a které selhaly, včetně konkrétních chybových zpráv. ## Tým a uživatel ### Co je to pozvánka? Pozvánka umožňuje uživateli připojit se k týmu v Epsilon Retail Media platformě. Pozvánky obvykle posílají správci týmů a uživatel je musí přijmout buď e-mailem, nebo v rámci platformy, než získá přístup k prostředkům týmu. ### Jak vytvořím nový tým? Použijte koncový bod [Create team](/retail-media-interface/partner/cs/team-user-api/team/createteam-1.md) s povinnými poli, jako je název týmu, informace o společnosti a ID jmenného prostoru (namespace ID). Ke vytváření týmů v rámci vaší organizace budete potřebovat příslušná oprávnění. ### Mohu patřit do více týmů? Ano, uživatelé mohou patřit do více týmů současně. Každé členství v týmu může mít různé úrovně oprávnění a role. ### Jaký je rozdíl mezi týmy prodejců (Retailer) a dodavatelů (Supplier)? Týmy prodejců spravují a kontrolují kampaně, zatímco týmy dodavatelů (inzerenti) kampaně vytvářejí a spravují. Typ týmu určuje dostupné funkce a oprávnění. ### Jak změním svá uživatelská oprávnění? Správci týmů mohou upravovat uživatelská oprávnění pomocí koncového bodu Modify user permission. Typy oprávnění zahrnují Plný přístup (Full access) a Zobrazení přehledů (Report View) pro role prodejce i dodavatele. ### Co se stane, když odeberu uživatele z týmu? Odebráním uživatele se zruší jeho přístup k prostředkům, kampaním a datům daného týmu. Uživatel již nebude dostávat oznámení týmu ani nebude moci provádět akce specifické pro daný tým. ### Jak dlouho platí tokeny pozvánek? Tokeny pozvánek mají omezenou dobu platnosti. Pokud platnost vaší pozvánky vypršela a potřebujete novou, kontaktujte správce týmu. ### Mohu po vytvoření aktualizovat informace o týmu? Ano, pomocí koncového bodu Update a team můžete upravit podrobnosti o týmu včetně názvu, informací o společnosti, telefonního čísla, adresy URL webu a adresy. ### Jaké typy souborů mohu nahrát pro loga? Koncový bod [Upload a file](/retail-media-interface/partner/cs/team-user-api/user-1/uploadfile-1.md) podporuje běžné obrazové formáty pro loga týmů a uživatelských profilů. Konkrétní požadavky na velikost a formát souboru naleznete v dokumentaci k API. ### Jak najdu týmy, ke kterým se mohu připojit? Použijte koncový bod Lists all teams s příslušnými filtry, jako je název, `namespace_id`, or `seller_id` abyste objevili dostupné týmy v rámci vaší organizace. ## List campaigns ### Kdy mám použít `managedOnly`? V systému Epsilon Retail Media jsou některé kampaně spravovány prodejci a ne dodavateli. Pro produktové reklamy je jediným dostupným typem útraty Fixní umístění. Použijte parametr `managedOnly` k načtení pouze kampaní s fixním umístěním. ## Create or update campaigns ### Kdy se používá `managerTeamId`? Použijte parametr `managerTeamId` při vytváření nebo aktualizaci kampaní s fixním umístěním. Při zadávání `managerTeamId`budete muset také zadat příslušná nastavení strategie pro fixní umístění. ### Co je to `namespaceId`? The `namespaceId` je jedinečný identifikátor pro jmenný prostor (namespace), kde se kampaně vytvářejí nebo aktualizují. Další informace naleznete v části Jmenné prostory. Tuto hodnotu můžete získat také od svého Customer Integration Engineera (CIE). ### Co je to `placementId`? Umístění určují pozice, kde se reklamy zobrazují. Každé umístění v systému Epsilon Retail Media má jedinečný identifikátor nazvaný `placementId`. Použijte [Returns a list of placements](/retail-media-interface/partner/cs/global-api/placements/listplacements.md) API k načtení `placementId`. Případně kontaktujte svého CIE, abyste tuto hodnotu získali. ### Co je to `walletId`? walletId je identifikátor peněženky inzerenta. Každý inzerent může mít jednu nebo více peněženek. Každá peněženka má hodnotu kreditů, které může utratit. Nastavením walletId určujete, ze které peněženky inzerenta se bude kampaň účtovat. ### Co je to `templateId`? The `templateId` se používá v implementacích Ad Genius. Většina zákazníků jej běžně nepoužívá a lze jej obecně ignorovat. ### Co jsou vlastní pole? V platformě Epsilon Retail Media někteří prodejci vyžadují pro kampaně vlastní atributy, jako jsou nákupní objednávky a podrobnosti o kupujícím. Příklad naleznete níže:
Custom fields.png
Pokud vaše integrace tato pole nevyžaduje, můžete je ignorovat. Pokud ano, potřebná ID vám poskytne váš CIE. ### Co jsou vlastní otázky? Ve jmenných prostorech s integrovanými daty cílení na zákazníky mohou inzerenti cílit na segmenty zákazníků pomocí dvojic `key:value` . Další informace naleznete v části Data zákazníků. Ve jmenných prostorech s vlastními otázkami můžete inzerentům naznačit, zda jsou tyto otázky volitelné nebo povinné, a poskytnout příslušnou konfiguraci. Váš CIE vám může poskytnout `customQuestionIds` pokud jsou ve vašem jmenném prostoru nakonfigurovány. ### Musím zadat `startTime` a `endTime`? To můžete vynechat, pokud má být kampaň trvale aktivní (always on). Pokud chce váš inzerent nastavit období aktivity, měli byste uvést obě hodnoty Ve formátu ISO-8601. ### Jak mohu při provádění aktualizace (PATCH) upravit konkrétní vlastnost, aniž bych musel posílat celý objekt kampaně? Naše API používají vlastnost `mask` která vám umožňuje aktualizovat konkrétní vlastnost bez odeslání celého objektu kampaně. #### Klíčové body * Placement\*\*: Ujistěte se, že vlastnost `mask` je ve vašem požadavku správně umístěna. * **Zpracování chyb:** Pokud narazíte na chybu oprávnění, zkontrolujte formát masky ve svém požadavku. #### Příklady **Změna jednoduché vlastnosti**, jako je název kampaně, použijte následující: ```json { "productCampaign": { "name": "new campaign name" }, "mask": "name" } ``` Změna vnořené vlastnosti\*\*, jako je `maxBid`: ```json { "productCampaign": { "strategy": { "auction": { "maxBid": "5" } } }, "mask": "strategy.auction.maxBid" } ``` Změna více vlastností\*\* jako `searchTerms` a `maxBid`, použijte čárkou oddělený seznam vlastností, které 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" } ``` ## Peněženka ### Proč potřebuji peněženku? Peněženky se používají ke správě prostředků na kampaně a k zajištění toho, že transakce budou zpracovány ve správné měně. Další informace naleznete v části Účel. ### Mohu mít více peněženek? Ano, můžete vytvořit více peněženek pro oddělenou správu různých měn nebo rozpočtů kampaní. Další informace naleznete v části Více peněženek. ### Kde najdu ID peněženky? ID peněženky najdete podle následujících kroků: **Původní platforma:** Přejděte na stránku **Fakturace týmu** a zobrazte své ID peněženky. **Nové uživatelské rozhraní:** Otevřete **Správce peněženky** a vyhledejte své ID peněženky. {% hint style="info" %} Některé týmy mohou mít více peněženek v různých měnách, takže se ujistěte, že jste vybrali tu správnou. {% endhint %} ### Co je aktuální zůstatek? Aktuální zůstatek je zůstatek peněženky bez jakýchkoli dobití kreditu nebo uplatněných limitů. ### Co je k dispozici za zůstatek? Dostupný zůstatek je celková částka v peněžence, která je v daném okamžiku k dispozici k utracení. Zahrnuje aktuální zůstatek plus jakýkoli úvěrový limit. ### Co je denní limit nebo denní útrata? Denní limit je maximální částka, kterou může vaše peněženka utratit za jediný den. ### Co je čerpání rozpočtu? Čerpání rozpočtu znamená, že jakékoli nevyčerpané prostředky z denního limitu se převedou do denního limitu na následující den. ### Co je zbývající denní limit? Zbývající denní limit jsou nevyčerpané prostředky denního limitu z předchozího dne. ### Co je omezený dostupný zůstatek? Omezený dostupný zůstatek je částka, kterou vám peněženka umožňuje utratit na daný den s ohledem na jakékoli limity útraty a/nebo dobité kredity. Tato hodnota je zásadní, protože určuje, zda jsou k dispozici peníze na utrácení. **Výpočet omezeného dostupného zůstatku**: * **Pouze úvěrový limit**: Omezený dostupný zůstatek = Dostupný zůstatek. * **Pouze denní limit**: Omezený dostupný zůstatek = Denní limit + nevyčerpaný převod * **Uplatňuje se jak úvěrový limit, tak denní limit**: Minimum z (Dostupný zůstatek, Denní limit + převod) Zde je několik příkladů: * **Příklad 1**: Úvěrový limit je 10, zůstatek peněženky je 20. * **Příklad 2**: Denní rozpočet je 1000, zůstatek peněženky je 10 000. * **Příklad 3**: Denní rozpočet je 250, úvěrový limit je 20, zůstatek peněženky je 200. V tomto případě je omezený dostupný zůstatek 220, protože dostupný zůstatek (aktuální zůstatek + úvěrový limit) je nižší než denní limit plus nevyčerpaný převod (250). {% hint style="info" %} Úvěrové limity jsou původní funkcí a většina maloobchodníků je nepodporuje. {% endhint %} ### Může být zůstatek peněženky záporný? Ne. Zůstatky peněženky nelze prostřednictvím Partner API úmyslně nastavit na záporné hodnoty. I když aktivita kampaně může dočasně ovlivnit zůstatky, toto chování je řízeno systémem a není řízeno uživatelem. ### Proč nemohu při vytváření kampaně vybrat peněženku? Měna peněženky se musí shodovat s měnou katalogu. Pokud je váš katalog například v AUD, nemůžete vybrat peněženku v GBP. Další informace naleznete v části [Kompatibilita měny s katalogy](/retail-media-interface/partner/cs/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/cs/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.