> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/hu/partner-api-overview/frequently-asked-questions.md). # Gyakran ismételt kérdések ## Tömeges műveletek a Partner API-kkal ### Melyek a tömeges műveletek? A tömeges műveletek lehetővé teszik több kampány, pénztárca vagy csapat létrehozását, szerkesztését vagy jóváhagyását egyetlen API-kérésben ahelyett, hogy egyedi hívásokat hajtana végre. ### A tömeges műveletek szinkronok vagy aszinkronok? Aszinkronok. Ön elküld egy feladatot, és a tömeges azonosító (bulk ID) használatával lekérdezi az eredményeket. ### Mi történik, ha a tömeges kérésben szereplő egyes elemek meghiúsulnak? Minden elem ellenőrzése tőlük függetlenül történik. Részletes eredményeket fog kapni, amelyek megmutatják, hogy melyek voltak sikeresek, és melyek hiúsultak meg konkrét hibaüzenetekkel. ## Csapat és felhasználó ### Mi az a meghívó? A meghívó lehetővé teszi a felhasználó számára, hogy csatlakozzon egy csapathoz a Epsilon Retail Media platformon. A meghívókat általában a csapat adminisztrátorai küldik el, és azokat e-mailben vagy a platformon belül el kell fogadni, mielőtt a felhasználó hozzáférhetne a csapat erőforrásaihoz. ### Hogyan hozhatok létre új csapatot? Használja a [Csapat létrehozása](/retail-media-interface/partner/hu/team-user-api/team/createteam-1.md) végpontot a kötelező mezőkkel, mint például a csapat neve, a vállalati információk és a névtér azonosítója (namespace ID). Megfelelő jogosultságokra lesz szüksége ahhoz, hogy csapatokat hozzon létre a szervezetén belül. ### Tartozhatok több csapathoz is? Igen, a felhasználók egyidejűleg több csapathoz is tartozhatnak. Minden egyes csapattagság eltérő jogosultsági szintekkel és szerepkörökkel rendelkezhet. ### Mi a különbség a kiskereskedői (Retailer) és a beszállítói (Supplier) csapatok között? A kiskereskedői csapatok kezelik és felülvizsgálják a kampányokat, míg a beszállítói csapatok (hirdetők) hozzák létre és kezelik a kampányokat. A csapat típusa határozza meg az elérhető funkciókat és jogosultságokat. ### Hogyan módosíthatom a felhasználói jogosultságaimat? A csapat adminisztrátorai a Módosítsa a felhasználói jogosultságot végpont segítségével módosíthatják a felhasználói jogosultságokat. A jogosultság típusai közé tartozik a Teljes hozzáférés és a Jelentések megtekintése mind a kiskereskedői, mind a beszállítói szerepkörök esetében. ### Mi történik, ha eltávolítok egy felhasználót egy csapatból? A felhasználó eltávolítása visszavonja a hozzáférését az adott csapat erőforrásaihoz, kampányaihoz és adataihoz. A felhasználó a továbbiakban nem kap csapattal kapcsolatos értesítéseket, és nem tud csapatspecifikus műveleteket végrehajtani. ### Meddig érvényesek a meghívó tokenek? A meghívó tokenek lejárati idővel rendelkeznek. Lépjen kapcsolatba a csapat adminisztrátorával, ha a meghívója lejárt, és úgra van szüksége. ### Módosíthatom a csapat adatait a létrehozás után? Igen, használja a Csapat frissítése végpontot a csapat adatainak módosításához, beleértve a nevet, a vállalati információkat, a telefonszámot, a webhely URL-címét és a címet. ### Milyen fájltípusokat tölthetek fel logókhoz? A [Fájl feltöltése](/retail-media-interface/partner/hu/team-user-api/user-1/uploadfile-1.md) végpont támogatja a gyakori képformátumokat a csapat- és felhasználóiprofil-logókhoz. A konkrét fájlméret- és formátumkövetelményeket lásd az API-dokumentációban. ### Hogyan találhatok olyan csapatokat, amelyekhez csatlakozhatok? Használja az Összes csapat listázása végpontot a megfelelő szűrőkkel, mint például a név, `namespace_id`, or `seller_id` hogy felfedezze a szervezetén belül elérhető csapatokat. ## Kampányok listázása ### Mikor kell használnom a `managedOnly`rendszert? A Epsilon Retail Media rendszerben egyes kampányokat a kiskereskedők kezelnek a beszállítók helyett. Termékhirdetések esetén az egyetlen elérhető költési típus a fix elhelyezés. Használja a `managedOnly` paramétert, hogy csak a Fix elhelyezés kampányokat kérje le. ## Kampányok létrehozása vagy frissítése ### Mikor használjam a `managerTeamId`paramétert? Használja a `managerTeamId` paramétert Fix elhelyezés kampányok létrehozásakor vagy frissítésekor. A `managerTeamId`megadásakor meg kell adnia a vonatkozó Fix elhelyezés stratégiabeállításokat is. ### Mi az a `namespaceId`? A `namespaceId` a névtér egyedi azonosítója, ahol a kampányok létrejönnek vagy frissülnek. További információért lásd a Névterek című részt. Azt is megteheti, hogy kapcsolatba lép az ügyfél-integrációs mérnökével (CIE) ennek az értéknek a megszerzéséhez. ### Mi az a `placementId`? A hirdetéselhelyezések (placements) határozzák meg azokat a helyeket, ahol a hirdetések megjelennek. A Epsilon Retail Media rendszerben minden egyes hirdetéselhelyezés egy egyedi azonosítóval rendelkezik, amelynek neve `placementId`. Használja a [Hirdetéselhelyezések listájának visszatérítése](/retail-media-interface/partner/hu/global-api/placements/listplacements.md) API-t a `placementId`lekéréséhez. Ehelyett kapcsolatba léphet a CIE-vel is az érték megszerzéséhez. ### Mi az a `walletId`? A walletId egy hirdető pénztárcájának az azonosítója. Minden hirdetőnek egy vagy több pénztárcája lehet. Minden pénztárca rendelkezik egy el költhető kreditértékkel. A walletId beállításával meghatározza, hogy melyik hirdető pénztárcáját terhelje a rendszer a kampányért. ### Mi az a `templateId`? A `templateId` az Ad Genius implementációkban használatos. A legtöbb ügyfél általában nem használja, és általában figyelmen kívül hagyható. ### Melyek a custom fields (egyedi mezők)? A Epsilon Retail Media platformon egyes kiskereskedőknek egyedi attribútumokra van szükségük a kampányokhoz, mint például a megrendelések (purchase orders) és a vevői adatok. Alább látható egy példa:
Custom fields.png
Ha az integrációja nem igényli ezeket, figyelmen kívül hagyhatja ezt a mezőt. Ha igényli, a CIE megadja a szükséges azonosítókat. ### Melyek a custom questions (egyedi kérdések)? Az integrált ügyfélcélzási adatokkal rendelkező névterekben a hirdetők ügyfélszegmenseket célozhatnak meg a `key:value` párosítások használatával. További információért lásd az Ügyféladatok című részt. Az egyedi kérdésekkel rendelkező névterekben jelezheti a hirdetőknek, hogy ezek a kérdések opcionálisak vagy kötelezőek-e, és megadhatja a vonatkozó konfigurációt. A CIE megadhatja a `customQuestionIds` értéket, ha azok be vannak konfigurálva a névtérben. ### Meg kell adnom a `startTime` és a `endTime`értéket? Ezt kihagyhatja, ha a kampányt úgy tervezték, hogy mindig aktív legyen (always on). Ha a hirdetője aktív időszakot szeretne beállítani, mindkét értéket meg kell adnia ISO-8601 formátumban. ### Hogyan frissíthetek egy adott tulajdonságot anélkül, hogy a teljes kampányobjektumot elküldeném a frissítés során (PATCH)? API-jaink a `mask` tulajdonságot használják, amely lehetővé teszi egy adott tulajdonság frissítését anélkül, hogy a teljes kampányobjektumot elküldené. #### Főbb pontok * Hirdetéselhelyezés\*\*: Győződjön meg arról, hogy a `mask` tulajdonság helyesen van elhelyezve a kérésben. * **Hibakezelés:** Ha jogosultsági hibába ütközik, ellenőrizze a maszk formátumát a kérésben. #### Példák **Egy egyszerű tulajdonság módosítása**, például a kampány neve esetén használja a következőket: ```json { "productCampaign": { "name": "new campaign name" }, "mask": "name" } ``` Egy beágyazott tulajdonság módosítása\*\*, mint például a `maxBid`: ```json { "productCampaign": { "strategy": { "auction": { "maxBid": "5" } } }, "mask": "strategy.auction.maxBid" } ``` Több tulajdonság módosítása\*\*, mint például a(z) `searchTerms` és a(z) `maxBid`, használja a frissíteni kívánt tulajdonságok vesszővel elválasztott listáját a következőkben: `mask` tulajdonság: ```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" } ``` ## Tárca ### Miért van szükségem tárcára? A tárcák a kampánykeretek kezelésére és annak biztosítására szolgálnak, hogy a tranzakciók a megfelelő pénznemben dolgozódjanak fel. További információért lásd: Cél. ### Lehet több tárcám is? Igen, létrehozhat több tárcát a különböző pénznemek vagy kampányköltségvetések különálló kezeléséhez. További információért lásd: Több tárca. ### Hol találom a tárca azonosítóját (wallet ID)? A tárca azonosítójának megtalálásához kövesse az alábbi lépéseket: **Korábbi platform:** Lépjen a **Csapat számlázása** oldalra a Wallet ID megtekintéséhez. **Új felület:** Nyissa meg a **Tárcakezelőt** a Wallet ID megtalálásához. {% hint style="info" %} Előfordulhat, hogy egyes csapatok több tárcával rendelkeznek különböző pénznemekben, ezért ügyeljen a megfelelő kiválasztására. {% endhint %} ### Mi a aktuális egyenleg? Az aktuális egyenleg a tárca egyenlege jóváírások (top-up) vagy korlátok alkalmazása nélkül. ### Mi a rendelkezésre álló egyenleg? A rendelkezésre álló egyenleg a tárcában lévő teljes összeg, amely bármely adott időpontban elkölthető. Magában foglalja az aktuális egyenleget és az esetleges hitelkeretet. ### Mi az napi limit vagy napi költés? A napi limit az a maximális összeg, amelyet a tárcája egyetlen nap alatt elkölthet. ### Mi az költésütemezés (budget pacing)? A költésütemezés azt jelenti, hogy a napi limit fel nem használt összege átkerül a következő napi limitbe. ### Mi a fennmaradó napi limit? A fennmaradó napi limit az előző napról fennmaradt, fel nem használt napi limitösszeg. ### Mi a korlátozott rendelkezésre álló egyenleg? A korlátozott rendelkezesre álló egyenleg az az összeg, amelyet a tárca engedélyez az adott napon elkölteni, figyelembe véve a költési limiteket és/vagy a feltöltési jóváírásokat. Ez az érték rendkívül fontos, mert ez határozza meg, hogy áll-e rendelkezésre elkölthető pénz. **A korlátozott rendelkezésre álló egyenleg kiszámítása**: * **Csak hitelkeret**: Korlátozott rendelkezesre álló egyenleg = Rendelkezésre álló egyenleg. * **Csak napi limit**: Korlátozott rendelkezesre álló egyenleg = Napi limit + fel nem használt áthozott összeg * **A hitelkeret és a napi limit is alkalmazva van**: A következők közül a kisebb: (Rendelkezésre álló egyenleg, Napi limit + áthozott összeg) Íme néhány példa: * **1. példa**: A hitelkeret 10, a tárca egyenlege 20. * **2. példa**: A napi költségvetés 1000, a tárca egyenlege 10 000. * **3. példa**: A napi költségvetés 250, a hitelkeret 20, a tárca egyenlege 200. Ebben az esetben a korlátozott rendelkezésre álló egyenleg 220, mivel a rendelkezésre álló egyenleg (aktuális egyenleg + hitelkeret) kevesebb, mint a napi limit plusz a fel nem használt áthozott összeg (250). {% hint style="info" %} A hitelkeretek korábbi funkciónak számítanak, és a legtöbb kiskereskedő nem támogatja őket. {% endhint %} ### A tárca egyenlege negatívba fordulhat? Nem. A tárcaegyenlegek a Partner API-n keresztül szándékosan nem állíthatók negatívra. Bár a kampánytevékenység átmenetileg befolyásolhatja az egyenlegeket, ez a viselkedés rendszervezérelt, és nem a felhasználó által szabályozott. ### Miért nem tudok tárcát választani a kampány létrehozása során? A tárca pénznemének meg kell egyeznie a katalógus pénznemével. Például, ha a katalógusa AUD-ban van, nem választhat GBP pénznemű tárcát. További információért lásd: [Pénznemek kompatibilitása a katalógusokkal](/retail-media-interface/partner/hu/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/hu/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.